Guide
MCP server
Connect Claude, Cursor, ChatGPT and other AI agents to Socialit through the remote MCP server at /mcp, with OAuth or an API key, and pick the toolsets they need.
Updated Oct 14, 2026
Socialit runs a remote Model Context Protocol server. Every operation of the REST API is also an MCP tool, so an agent can draft and schedule posts, answer the inbox, read analytics, run broadcasts and manage accounts with the same validation, rate limits and permissions as the API. Tool calls run through the real /v1 endpoints, so responses and errors are identical.
| URL | https://api.socialit.com/mcp |
| Transport | Streamable HTTP (stateless) |
| Auth | OAuth 2.1 with PKCE and dynamic client registration, or Authorization: Bearer sk_live_… |
| Plans | Every plan, using the plan’s API request budget |
Connect a client
Any other client that supports remote MCP servers over Streamable HTTP works the same way: give it the URL and sign in, or send an API key header.
OAuth or API key
- OAuth is best for people: the client opens a Socialit consent screen, you pick the workspaces and scopes (
read,write,admin), and you can revoke the connection in Account → Connected apps. The agent acts with your role and profile access. OAuth connections can reach several workspaces: they getlist-workspacesandswitch-workspacetools and aworkspaceargument on every tool. - API keys are best for servers and scripts. Use a
readkey for reporting agents, and restrict a key to some profiles to fence an agent in.
Everyone gets get-current-workspace. Tools the credential can’t call are hidden from tools/list.
Tool names
A tool is named after its operation ID in kebab-case: createPost is create-post, listConversations is list-conversations. Every endpoint in the API reference shows its tool name and toolset, and an MCP tab with a ready-made tools/call request. The input schema merges the path, query and body parameters; list tools also take filters: [{ field, condition, value }]. Tools are annotated as read-only, destructive, idempotent or open-world.
Toolsets
Large tool lists cost tokens and attention. Narrow them with query parameters on the server URL (or the X-MCP-Toolsets and X-MCP-Readonly headers):
?toolsets=posts,inboxexposes only those toolsets.?read_only=trueexposes only tools that don’t change anything.
https://api.socialit.com/mcp?toolsets=posts,media,accounts,analytics&read_only=true| Toolset | Resources | Tools |
|---|---|---|
accounts | Accounts | 44 |
api_keys | API Keys | 7 |
webhooks | Webhooks, Events | 15 |
logs | Logs | 3 |
team | Invitations, Users | 3 |
posts | Posts | 24 |
queues | Queues | 7 |
media | Media | 10 |
templates | Templates | 5 |
tools | Tools | 7 |
inbox | Inbox | 72 |
analytics | Analytics | 40 |
contacts | Contacts | 16 |
custom_fields | Custom Fields | 5 |
broadcasts | Broadcasts | 11 |
sequences | Sequences | 10 |
workflows | Workflows | 18 |
comment_automations | Comment Automations | 6 |
ads | Ads | 123 |
ads_measurement | Ads: accounts & measurement | 135 |
platform_tools | Platform tools | 91 |
focus | Focus | 10 |
billing | Billing | 9 |
account | Connected Apps | 2 |
support | Support Assistant | 3 |
Focus mode toolsets (opt in)
Focus mode adds a typed toolset per network, nearly 2,000 tools in total. Select only the networks your agent works on, next to the generic focus toolset:
https://api.socialit.com/mcp?toolsets=focus,focus_youtube,focus_reddit| Toolset | Resources | Tools |
|---|---|---|
focus_bluesky | Focus · Bluesky | 168 |
focus_discord | Focus · Discord | 145 |
focus_facebook | Focus · Facebook Page | 158 |
focus_google_business | Focus · Google Business Profile | 89 |
focus_instagram | Focus · Instagram | 103 |
focus_linkedin | Focus · LinkedIn | 64 |
focus_mastodon | Focus · Mastodon | 337 |
focus_pinterest | Focus · Pinterest | 64 |
focus_reddit | Focus · Reddit | 292 |
focus_snapchat | Focus · Snapchat | 56 |
focus_threads | Focus · Threads | 57 |
focus_tiktok | Focus · TikTok | 65 |
focus_x | Focus · X | 177 |
focus_youtube | Focus · YouTube | 170 |
Good practice
- Ask the agent to create drafts for anything public and review them in the app before they go out.
- Use profile-restricted keys or a read-only connection for agents that only report.
- Give agents the toolsets they need instead of everything.
- Every tool call appears in the workspace request logs and activity with the client’s name.