MCP server, CLI and API

Manage social media from your AI

Schedule posts, build comment-to-DM automations and read your analytics from Claude, ChatGPT or Cursor. Or script the same tools from your terminal.

https://www.sociahive.com/api/mcp

Install in one click

Cursor installs from a link. Claude and ChatGPT find our sign-in on their own; you approve what SociaHive can do.

Add SociaHive to your assistant

Cursor

Opens Cursor and fills in the MCP config. Replace the placeholder with your API key.

Open Cursor

Requires Cursor v0.45 or newer

Claude Desktop

Copy the server config, paste it into Claude Desktop's MCP settings, then restart Claude.

Then restart Claude Desktop

Claude.ai

Add a custom connector and sign in with SociaHive. No key to paste; you approve what it can do.

Open Claude.ai

Server URL: https://www.sociahive.com/api/mcp

ChatGPT

On a paid plan, on the website: Settings, Plugins, Add, then add a custom MCP server. Paste the URL, choose OAuth and sign in.

See the steps

Server URL: https://www.sociahive.com/api/mcp

Set it up in three steps

  1. 1Create an API keyIn Settings, API keys, create a key with the scopes you need and copy it. It starts with sk_ and is shown once.
  2. 2Connect your toolSet SOCIAHIVE_API_KEY for the CLI, add the server to your MCP client, or send the key as a header. Claude and ChatGPT can sign in with SociaHive instead of a key.
  3. 3Ask, or script itYour AI calls the same tools you see below. Scripts call them through the CLI or over HTTP.

What your AI can do

Each tool runs as you, so your plan's limits apply. Anything that goes live asks you first.

ToolWhat it does
list_accountsLists the social accounts you connected to SociaHive.
create_scheduled_postWrites a post, with text, images or video, for one or more accounts.
schedule_postQueues a post at a time you pick or at your best time.
find_next_slotFinds the next free slot in your posting schedule.
publish_post_nowPublishes straight away, after you confirm.
upload_media_from_urlCopies an image or video from a public link into your media.
get_scheduler_calendarShows what is scheduled, across all accounts.
get_post_analyticsReads reach, likes, comments and saves per post.
get_content_insightsFinds which formats and topics beat your usual numbers.
generate_flowBuilds a DM automation from one sentence, as a draft.
list_flowsLists your automations, which are live and how often they run.
bulk_reschedule_postsMoves many scheduled posts in one go.

From your terminal

The sociahive CLI prints JSON, so it fits shell scripts, CI jobs and quick one-off changes.

Terminal

# Set your API key (it needs the agent:execute scope)
export SOCIAHIVE_API_KEY="sk_your_key_here"
export SOCIAHIVE_API_URL="https://www.sociahive.com"

# Who am I, and which accounts are connected?
sociahive whoami
sociahive accounts list

# Schedule a post
sociahive posts create \
  --text "Hello from the CLI" \
  --platforms '[{"platform":"instagram","accountId":"<account id>"}]' \
  --scheduled-at "2026-11-02T09:00:00Z"

# Publish a draft now (it can't be undone, --yes confirms)
sociahive posts publish <post id> --yes

# Build an automation from one sentence (saved as a draft)
sociahive flows generate \
  --description "DM my link to everyone who comments price" \
  --platform instagram

From any client

Any MCP client works with this config. Anything else can call the same endpoint over HTTP, with the same limits and audit trail.

claude_desktop_config.json

{
  "mcpServers": {
    "sociahive": {
      "url": "https://www.sociahive.com/api/mcp",
      "headers": {
        "X-API-Key": "sk_your_key_here"
      }
    }
  }
}

Terminal

# Every tool is a JSON-RPC tools/call on the MCP endpoint
curl -X POST \
  -H "X-API-Key: sk_your_key_here" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"list_flows","arguments":{"mode":"rank"}}}' \
  https://www.sociahive.com/api/mcp

# For one-off scripts, the sociahive CLI handles the session for you

By platform

What the server does on each platform, and how it compares with the official server.

Comparing AI agents and MCP servers for marketing? Read MCP for social media automation.

Connect your AI to SociaHive

The MCP server, the CLI and API keys are in the trial and on every paid plan.