MCP introduction
Connect Claude, ChatGPT, and Cursor to Socioi with Model Context Protocol.
MCP (Model Context Protocol) lets AI agents call Socioi tools — list channels, upload media, draft and schedule posts — through a standardized interface.
Endpoint:
| Env | URL |
|---|---|
| Production | https://socioi.com/mcp/mcp |
| Local | http://localhost:4000/mcp |
MCP runs on the same API backend as https://socioi.com/api, exposed on the mcp hostname.
Manage connection details in the app: Settings → Developers → MCP.
How it works
- You connect social channels in the Socioi app (once).
- You connect an AI client to
https://socioi.com/mcp/mcp(API key or OAuth). - The agent discovers tools and calls them on your behalf.
- Socioi schedules / publishes through the same pipeline as the dashboard.
Choose a client
| Client | Auth | Guide |
|---|---|---|
| Cursor | API key header | Cursor |
| Claude | OAuth 2.1 (PKCE + DCR) | Claude & ChatGPT |
| ChatGPT | OAuth 2.1 (PKCE + DCR) | Claude & ChatGPT |
| Claude Code / OpenClaw | Shell + API key | Use the AI Agents CLI instead of MCP |
What MCP can do
See the full tools reference. In short:
- Validate the connection
- List channels and quota
- List / get / create / schedule / delete posts
- List media and upload from URL
MCP does not start Facebook/Instagram/etc. OAuth — connect providers in the app first.
Security highlights
- Separate tokens from Public API OAuth (
pos_) — MCP usesmcp_at_/mcp_rt_ - PKCE + Dynamic Client Registration for Claude / ChatGPT
- Audience bound to
https://socioi.com/mcp - Session JWTs are not accepted on
/mcp - Trial / plan limits match the Public API
Next: Authentication → Tools. Prefer a terminal skill? See AI Agents CLI.