Connections
List the accounts you can connect an agent as
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/accountsTL;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. |
| 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 |
| 401 | Not signed in. | ErrorResponse |
| 429 | Too many requests. | ErrorResponse |
Response body
A 200 answer has the type 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 | Every endpoint, and the error envelope |
| Schemas | Every request and response type |
| Tool reference | The operations as callable tools |