MCP server

Your agent posts. You approve.

One endpoint gives your AI agent 9 tools: post to your social accounts, check each platform’s rules, and run reports on your marketing accounts. It asks you before it posts.

Get a free API key Setup guides

claude mcp add --transport http socialhelper https://socialhelper.app/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

{
  "mcpServers": {
    "socialhelper": {
      "url": "https://socialhelper.app/mcp",
      "headers": { "Authorization": "Bearer ${env:SOCIALHELPER_API_KEY}" }
    }
  }
}

[mcp_servers.socialhelper]
url = "https://socialhelper.app/mcp"
bearer_token_env_var = "SOCIALHELPER_API_KEY"

Connection

One URL, one key.

Point any MCP client at the endpoint and send your API key. Nothing to install.

Endpoint: https://socialhelper.app/mcp
Transport: Streamable HTTP (POST). A GET on the endpoint returns 405.
Authentication: Your SocialHelper API key: Authorization: Bearer sh_…
Rate limit: 120 requests a minute per key, shared with the REST API
Scope: Only the accounts and posts in the workspace the key belongs to
Sign-in (OAuth): Not yet. One-click connectors for Claude.ai and ChatGPT are coming soon.

How agents use it

Two flows, clear rules.

The server explains these flows to every agent that connects.

Posting flow

Find the accounts, check each platform’s rules, attach media if needed, confirm with you, publish, then check the live links.

1 list_accounts
2 get_platform_rules
3 upload_media
4 create_post confirms with you first
5 get_post

Data flow

Find a data account, see what its tools take, then run them. Start with a listing tool, such as sites or properties, to get the IDs other tools need.

1 list_accounts
2 list_account_tools
3 run_account_tool

Tools

9 tools.

Exactly what your agent sees in tools/list.

list_accounts

List the accounts connected to this workspace. Accounts with can_publish receive posts: use their IDs as `accounts` in create_post. Accounts with tools (Search Console, Analytics, Ads…) offer reports and lookups: see list_account_tools. Only accounts with status "active" can be used.

get_platform_rules

Get the rules posts must fit on each platform: text limit and how it is counted, how many images/videos, accepted file types and sizes, and platform-specific options you can pass in create_post overrides.

upload_media

Import an image or video from a public URL so it can be attached to a post. Returns a media ID for create_post. Accepts JPEG, PNG, WebP, GIF, MP4 and MOV up to 60 MB.

create_post

Publish a post to one or more connected accounts, now or at scheduled_at. The content is checked against every target platform first: if anything does not fit, nothing is posted and all problems are returned. Posting is public — confirm the text and accounts with the user first.

get_post

Get a post and the status of each target account: scheduled, queued, publishing, confirming, published (with its live URL), failed (with the reason) or cancelled.

list_posts

List recent posts, newest first, optionally filtered by status. Useful for finding scheduled posts or recent failures.

cancel_post

Cancel a scheduled post on every account where it has not started publishing. Already-published targets are not removed from the platform.

list_account_tools

List the tools a connected account offers, such as Search Console queries, Analytics reports or Google Ads searches, with each tool's input schema. Run them with run_account_tool. Accounts that only receive posts have no tools.

run_account_tool

Run one of a connected account's tools (see list_account_tools) and get its result. Pass the tool's input as `input`, matching its input schema.

Setup guides

Pick your client.

Step-by-step setup for the clients developers use most.

Claude Code Anthropic’s coding agent, in your terminal and editor. Cursor The AI code editor. VS Code Visual Studio Code with GitHub Copilot. Claude Desktop The Claude app for macOS and Windows. Windsurf (Devin Desktop) The agentic editor, renamed Devin Desktop in June 2026. Codex CLI OpenAI’s coding agent for the terminal. Gemini CLI Google’s open-source agent for the terminal. Zed The fast, collaborative code editor. Cline The open-source coding agent for VS Code.

FAQ

MCP questions.

What is an MCP server?

MCP (Model Context Protocol) is a standard way for AI assistants to use outside tools. SocialHelper’s MCP server gives your assistant tools to list your accounts, check platform rules, publish and check posts, and run data tools.

Will my agent post without asking?

The server tells the agent that posting is public and immediate unless scheduled_at is set, and to confirm the final text and the target accounts with you before calling create_post.

Which clients work?

Any MCP client that can send an API key in a request header, including Claude Code, Cursor, VS Code, Claude Desktop, Windsurf (Devin Desktop), Codex CLI, Gemini CLI, Zed, Cline.

Does it work with ChatGPT or claude.ai?

Not yet: those connectors sign in with OAuth, which SocialHelper doesn’t offer yet. One-click connectors are coming soon.

Can an agent upload images?

Yes, from a public URL: upload_media imports the file (up to 60 MB) and returns an ID to attach to create_post.

Give your agent a voice.

Create a free account, connect an account and send your first post in a few minutes.

Get a free API key Read the docs