# List the accounts you can connect an agent as

> Page: https://docs.plotwork.dev/api/get-user-mcp-accounts. Index of every page: https://docs.plotwork.dev/llms.txt

Your own account, unless an organisation you belong to asks that agents connect to it, and each organisation where you may publish (every role but reader).

`GET /user/mcp/accounts`

## TL;DR

| Question | Answer |
|---|---|
| What does it do? | List the accounts you can connect an agent as. |
| What does it take? | Nothing. |
| What does it return? | Status 200 with a body of type [`ConnectableAccounts`](https://docs.plotwork.dev/api/schemas.md#connectableaccounts). |
| What can go wrong? | `401` not signed in; `429` too many requests. Every failure uses the one error envelope. |

## What it does

Your own account, unless an organisation you belong to asks that agents connect to it, and each organisation where you may publish (every role but reader). The approval checks the same rules again.

## Responses

| Status | Meaning | Body |
|---|---|---|
| 200 | The accounts. | [`ConnectableAccounts`](https://docs.plotwork.dev/api/schemas.md#connectableaccounts) |
| 401 | Not signed in. | [`ErrorResponse`](https://docs.plotwork.dev/api/schemas.md#errorresponse) |
| 429 | Too many requests. | [`ErrorResponse`](https://docs.plotwork.dev/api/schemas.md#errorresponse) |

## Response body

A 200 answer has the type [`ConnectableAccounts`](https://docs.plotwork.dev/api/schemas.md#connectableaccounts).

| Field | Type | Required | Description |
|---|---|---|---|
| `personal` | `object` | yes |  |
| `personal.allowed` | `boolean` | yes | False when an organisation you belong to asks that agents connect to it, and your address is on one of its verified domains. |
| `personal.requiredBy` | `object[]` | yes | The organisations that ask it. Empty when `allowed` is true. |
| `personal.requiredBy[].id` | `string` | yes |  |
| `personal.requiredBy[].slug` | `string` | yes |  |
| `personal.requiredBy[].name` | `string` | yes |  |
| `organisations` | `object[]` | yes | The organisations where your role may publish (every role but reader), so an agent can be connected to them. Ordered by name. |
| `organisations[].id` | `string` | yes |  |
| `organisations[].slug` | `string` | yes |  |
| `organisations[].name` | `string` | yes |  |
| `organisations[].role` | `"owner" \| "admin" \| "member" \| "reader"` | yes |  |

## See also

| Doc | Why |
|---|---|
| [API reference](https://docs.plotwork.dev/api/reference.md) | Every endpoint, and the error envelope |
| [Schemas](https://docs.plotwork.dev/api/schemas.md) | Every request and response type |
| [Tool reference](https://docs.plotwork.dev/mcp/tools.md) | The operations as callable tools |