SupaBird MCP Server

The official remote MCP server for SupaBird, your social media growth agent. Bring your SupaBird account into Claude, Cursor, VS Code, Gemini CLI or any MCP client: find viral content, write in your voice, and schedule posts across all major social media platforms.

• Endpoint: https://api.supabird.io/mcp
• Transport: Streamable HTTP
• Auth: OAuth 2.1 — your client opens a SupaBird sign-in page the first time it connects. No API key to copy.
• Requires: a SupaBird account (start a free trial). MCP usage is paid from your SupaBird credit wallet.

What it can do

19 tools, grouped:

Reports and coaching

• Get your daily report — how your account did on any tracked date, with key results and insights
• Get overview analytics — what content tends to work or flop, with examples and next actions
• Get your daily tasks — today's personalized growth tasks, and mark them complete

Writing

• Write posts in your style
• Write in SupaBird (viral) style — your voice blended with proven engagement patterns
• Write like a specific creator on X
• Write like your saved creators
• Learn a creator's style — analyze an X account and save a writing style rulebook

Ideas and research

• Generate 5–20 post ideas from your own posts or a creator you choose
• Generate ideas from specific posts you feed in
• Search tweets with advanced filters (engagement minimums, date ranges, media type)

Scheduling and cross-posting

• Schedule posts (with optional images) and unschedule them back to Drafts
• View scheduled posts and retweets
• See available posting slots; add, move or remove slots
• See connected socials and each platform's character limit
• Cross-post to your other connected social accounts
• Get published post URLs on every platform

Example prompts:

• "Show my performance for yesterday."
• "Generate 10 ideas from my posts in my style."
• "Find tweets about AI agents with at least 500 likes from this week."
• "Schedule this post for tomorrow at 9am on X and LinkedIn."

Chain it with Notion, Gmail, Drive, Slack and other MCP servers, e.g. "turn this week's changelog in Notion into three X posts and schedule them in my free slots".

Install

Claude (claude.ai / Claude Desktop)

Settings → Connectors → Add custom connector → URL https://api.supabird.io/mcp → Connect, then sign in to SupaBird.

Claude Code

claude mcp add --transport http supabird https://api.supabird.io/mcp

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "supabird": { "url": "https://api.supabird.io/mcp" }
  }
}

VS Code

code --add-mcp '{"name":"supabird","type":"http","url":"https://api.supabird.io/mcp"}'

Gemini CLI

gemini extensions install https://github.com/Farid18baku/supabird-mcp

Clients without remote/OAuth support

Use mcp-remote as a local bridge:

{
  "mcpServers": {
    "supabird": { "command": "npx", "args": ["-y", "mcp-remote", "https://api.supabird.io/mcp"] }
  }
}

Links

• Website: https://supabird.io
• App: https://x.supabird.io
• MCP feature page: https://supabird.io/features/x-twitter-mcp
• Privacy: https://supabird.io/privacy · Terms: https://supabird.io/terms
• Made by @hustle_fred and @kjuriousBeing

License

The contents of this repository (docs and manifests) are MIT licensed. The SupaBird service is subject to the SupaBird Terms.