Connect Shoutora to your AI assistant
Shoutora works with AI assistants through MCP (the open standard that Claude, Cursor and others use to talk to apps). Once connected, you can say things like "Write three posts about our weekend sale and add them to the queue for Instagram and Facebook", "What's scheduled for next week?", or "Did yesterday's LinkedIn post go out?". The assistant works as you: the same brands, roles and plan limits you have on the website. Nothing is ever posted twice, and every post it creates shows up in your calendar like any other.
1. Create an API key
- In Shoutora open Settings → API keys.
- Click Create key, give it a name (for example "Claude Desktop") and choose Read + write (the assistant can create and change posts) or Read-only (it can only look).
- Copy the key right away. It is shown only once. Treat it like a password: anyone who has it can use Shoutora as you. You can revoke it at any time on the same page.
The server address is always https://shoutora.com/api/mcp, and the key is sent as a header:
Authorization: Bearer YOUR_KEY.
2. Add Shoutora to your assistant
Claude Code
Run once in a terminal (replace YOUR_KEY):
claude mcp add --transport http shoutora https://shoutora.com/api/mcp --header "Authorization: Bearer YOUR_KEY"
Then start claude and ask, for example, "List my Shoutora brands."
Cursor
Open Settings → MCP → Add new server and paste:
{
"mcpServers": {
"shoutora": {
"url": "https://shoutora.com/api/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}
Claude Desktop
Claude Desktop reaches remote servers through the small mcp-remote helper (needs Node.js). Open
Settings → Developer → Edit Config and add:
{
"mcpServers": {
"shoutora": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://shoutora.com/api/mcp", "--header", "Authorization:Bearer YOUR_KEY"]
}
}
}
Restart Claude Desktop. The Shoutora tools appear under the tools icon.
claude.ai and ChatGPT: "Sign in with Shoutora" (no key needed)
These connect with your Shoutora login instead of a key:
- Add a custom connector in your assistant and enter the server address
https://shoutora.com/api/mcp.- claude.ai: Settings → Connectors → Add custom connector. Name it "Shoutora", paste the address, click Add, then Connect.
- ChatGPT: add a custom connector / app with the MCP server address above and choose OAuth as the authentication (the option names change from time to time; look under Settings → Connectors or Apps).
- A Shoutora window opens. Log in if asked, then choose Read and write or Read only and click Allow.
- Done. To disconnect later: Settings → API keys → Connected apps → Disconnect in Shoutora (or remove the connector in the assistant).
Claude Code can use the same sign-in: run claude mcp add --transport http shoutora https://shoutora.com/api/mcp
without the header, then type /mcp in Claude Code and choose Authenticate.
3. What the assistant can do
| Tool | What it does |
|---|---|
list_brands | Your brands and your role in each |
list_accounts | Connected social accounts of a brand |
list_posts, get_post | Scheduled, published and failed posts; status per platform; links to live posts |
create_post | Post now, schedule at a time, or add to the brand's queue; per-platform text; media |
update_post, delete_post | Only while a post hasn't started publishing (same rules as the website) |
upload_media_from_url | Fetch an image or video from a public link into the brand's media (JPG, PNG, GIF, WebP, MP4, MOV, up to 50 MB) |
get_schedule | The brand's time zone, weekly slots and next free slot |
get_usage | Plan, limits and what's left |
Read-only keys can use only the listing and reading tools. Writes need an Editor role or higher in the brand, reads a Viewer role, exactly like the website.
4. Safety
- A key, or a "Sign in with Shoutora" connection, is personal and acts as you. Revoke the key or disconnect the app in Settings → API keys and the assistant stops immediately.
- Each key or connected app may make 60 tool calls per minute.
- Every call is logged (who, which tool, which brand, success or error) so you can ask support what a key did. We don't store the assistant's conversation; only the posts you asked for are kept, like any other post.
- Deleting your Shoutora account deletes its keys and connections.
Questions: support@shoutora.com