Authentication
An MCP client authenticates with a bearer token on theAuthorization header. SocialAPI accepts the same two token types as the REST API:
A full-access API key and an OAuth access token can run every tool. To give an agent less, connect it with a scoped API key: a tool outside the key’s scopes returns a result with
isError: true and code auth.insufficient_scope. required_scope is absent for tools that need a full-access key. See Scoped API keys and Authentication.
Connect a client
What the agent can do
The agent gets one tool per operation: accounts and brands, comments, DMs, reviews, mentions, Automations, posts, media, analytics, exports, webhooks, events, usage, and API keys. MCP tools reference lists every tool by area with the REST endpoint it runs.Not the documentation MCP server
This documentation site also exposes its own MCP server, which only searches these docs. It cannot read or change your accounts. To manage your SocialAPI accounts from an AI client, add the server athttps://api.social-api.ai/mcp.
Troubleshooting
The sign-in window does not open or loops
The sign-in window does not open or loops
Allow pop-ups for the client’s site. Ad blockers and privacy extensions can block the redirect back to the client: pause them and retry.
Tool calls fail with HTTP 401
Tool calls fail with HTTP 401
The client’s OAuth session expired or its API key is wrong. Remove the SocialAPI server from the client and add it again to sign in again. For an API key, check that it is active in the dashboard. The
401 body is {"error": "<message>"}.The client reports that the server is not responding
The client reports that the server is not responding
Use the URL exactly as shown:
https://api.social-api.ai/mcp. Check status.social-api.ai for an incident.A tool returns an error result
A tool returns an error result
A failed tool returns
isError: true with the same code the REST API returns. Look the code up in Errors.Related
- MCP tools reference: every tool and the endpoint it runs.
- OAuth for MCP clients: how the sign-in works, and how to build it for your own client.
- Custom MCP clients: connect with an API key.
- Scoped API keys: limit which tools an agent can run.
- Errors: every error code a tool can return.