For AI agents
Connect your social calendar to your AI assistant
SocialRoute speaks the Model Context Protocol. Point Claude, ChatGPT or any MCP client at our endpoint and it can read your projects, see what is already scheduled, find free slots and draft posts — in your brand voice, on your calendar.
- Endpoint
- https://socialroute.net/api/mcp
- Transport
- Streamable HTTP
- Authentication
- OAuth 2.1 with PKCE
- Tools
- 14 across planning, publishing and AI
What an assistant can do
Every tool declares whether it reads or writes, so your client can ask before anything changes.
| Tool | What it does | Access |
|---|---|---|
get_account | Your plan, AI credit balance, publishing usage and timezone. | Reads |
list_projects | Every project you own or collaborate on, with your role in each. | Reads |
get_project | One project in full: brand voice, products, social links and monthly goals. | Reads |
list_posts | Posts across your projects, ordered by when they are scheduled. | Reads |
get_post | One post in detail, including its per-platform publishing history. | Reads |
find_free_slots | Open posting slots that respect your project's minimum gap between posts. | Reads |
get_goals | A month's posting targets per platform, against what is actually planned. | Reads |
get_posting_playbook | How to write and when to post for a project: per-platform length, style, character limits and the best local hours. | Reads |
create_post | Add a post to one of your projects. | Writes |
update_post | Change an existing post — only the fields the assistant passes. | Writes |
delete_post | Permanently delete a post. This cannot be undone. | Needs approval |
publish_post | Send an existing post to its connected accounts now. Off unless you enable it, and always dry-run first. | Needs approval |
generate_caption | Write one caption with hashtags in your brand voice. Spends one AI credit. | Needs approval |
plan_campaign | Generate a batch of distinct posts, optionally in several languages. Spends one credit per post. | Needs approval |
“Needs approval” marks the tools that delete a post or spend AI credits — irreversible actions your client should confirm with you first.
Connecting
You need a SocialRoute account. The connection is per-user — an assistant only ever sees your own projects.
Claude
Add a custom connector in Settings → Connectors and paste the endpoint URL. Claude opens a SocialRoute page where you approve the connection.
Claude Code
Add the server from your terminal, then follow the browser prompt to authorize:
claude mcp add --transport http socialroute https://socialroute.net/api/mcpChatGPT
In developer mode, add an MCP server with the endpoint URL and complete the OAuth prompt.
Any other MCP client
Point it at the endpoint. Discovery metadata is served at /.well-known/oauth-protected-resource, so a compliant client finds the authorization server on its own.
You stay in control
- Nothing connects until you approve it on a SocialRoute page — and nothing is connected if you close that page.
- An assistant sees only your own projects. It cannot reach other customers' data, your stored social passwords, or the admin area.
- Letting an assistant schedule — or publish — is off by default. You turn each on in Settings, an assistant cannot grant itself either, and scheduling is enforced in the database rather than in the app.
- Disconnect any assistant from Settings → AI agents. Access stops immediately, not when a token happens to expire.
- AI tools spend the same credits as the app, and appear in the same usage history.
Questions
What is MCP?
The Model Context Protocol is an open standard that lets an AI assistant use an external tool. Instead of copying your calendar into a chat, the assistant reads it directly — and writes back only what you allow.
Does this cost extra?
No. The MCP server is included on every plan, including Free. Reading your calendar is free; the two AI tools spend the same credits your plan already includes.
Can an assistant publish to my social accounts?
Only if you turn it on. Publishing is off by default, an assistant cannot grant itself the permission, and the publish tool always does a dry run first — showing you the exact text and the accounts it would post to — before a second, confirmed call sends it. Left off, an assistant can still draft and schedule, and SocialRoute publishes on its own schedule.
Which assistants work?
Any MCP client that supports remote servers over streamable HTTP with OAuth — Claude, Claude Code and ChatGPT's developer mode among them.
Plan your month with an assistant that can see your calendar
Create a free account, connect your client, and ask it what to post next week.