Skip to content

list_social_accounts

mcp:readread-only

List the workspace's connected social accounts (platform, handle, connection status). Use an account's id as socialAccountId when drafting a post for a specific account.

Input

This tool takes no input.

Permission

Needs the mcp:read scope: view your workspace. It only reads, so assistants can call it without asking.

Example call

Your assistant sends this for you. It is shown so you can see the shape of a call, with placeholder values for the required fields.

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

Same action over the REST API

The tool runs GET /v1/orgs/{orgId}/marketing/accounts as the signed-in user, with the same validation, approval rules and limits. See it in the Social accounts API reference.