# list_accounts

> List accounts and groups with Wavegrain's MCP server: the list_accounts tool needs the read permission. Inputs, outputs and an example call.

> Index of these docs: https://wavegrain.com/developers/llms.txt

**List accounts and groups.** Permission: `read`. Read-only: changes nothing.

The user's brands, account groups and connected social accounts: network, status, groups and posts left today. networks says what each can do and whether it posts by itself; tell the user before planning. If a group name is in two brands, ask which.

## Inputs

No inputs.

The fields inside an object or a list are in the JSON Schema at [/developers/mcp-tools.json](/developers/mcp-tools.json).

## Returns

| Field | Type | Notes |
| --- | --- | --- |
| `brands` | object[] | Every brand with its account groups. |
| `accounts` | object[] | Every connected account. |
| `networks` | object[] | What each network can do on Wavegrain today, for example TikTok posts going private before its audit. |

## Example call

Send it to `POST https://wavegrain.com/api/mcp` with an access key that has the `read` permission; [Authentication](/developers/authentication) shows how to make one.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_accounts",
    "arguments": {}
  }
}
```

## Related tools

- [`list_tailored_versions`](/developers/mcp-tools/list_tailored_versions): List tailored versions
- [`plan_week`](/developers/mcp-tools/plan_week): Plan a week of posts
- [`get_brand_usage`](/developers/mcp-tools/get_brand_usage): Get a brand's usage
- [`get_connect_link`](/developers/mcp-tools/get_connect_link): Get a link to connect an account
- [`get_post_status`](/developers/mcp-tools/get_post_status): Get a post's status
- [`get_post_events`](/developers/mcp-tools/get_post_events): Get a post's history
- [All 79 tools](/developers/mcp-tools)
