Sociahive Mcp

Run your social media from your AI tool: schedule posts, build DM and comment automations, and read analytics.

Website · Connect your AI · Developers · Docs · Sign up

Hosted remote MCP server, skill and plugins for SociaHive. Schedule and publish posts on 22 networks, build DM and comment automations, and read analytics from Claude Code, Codex, Gemini CLI, Cursor, Grok, Claude, ChatGPT or any MCP client.

Endpoint: https://www.sociahive.com/api/mcp (streamable HTTP). Sign in with OAuth 2.1 on first use, or send an API key (X-API-Key: sk_... or Authorization: Bearer sk_...).

MCP, API key and CLI access are part of the 7-day trial and every paid plan.

Works with your AI tool

Platforms

Publish to

Also Discord, Slack, Mastodon, Lemmy, Tumblr, Dev.to, Hashnode, WordPress, Listmonk, Dribbble, Twitch and Kick.

Automate DMs and comments on

What's in this repository

• server.json: the MCP registry manifest.
• skills/sociahive/SKILL.md: when to use SociaHive, which tool fits which request, step-by-step workflows, error handling and the safety rules (copied to the root SKILL.md). skills/sociahive/references/ holds the full tool catalog and the CLI guide (linked from the root as references/).
• Plugin manifests for Claude Code (.claude-plugin/), Cursor (.cursor-plugin/), Codex (.codex-plugin/, .agents/plugins/), Grok Build (.grok-plugin/) and a Gemini CLI extension (gemini-extension.json, GEMINI.md).

What it can do

• Scheduling: create_scheduled_post, schedule_post, publish_post_now, get_scheduler_calendar, bulk_reschedule_posts, duplicate_scheduled_post, upload_media_from_url, list_media
• Scheduler extras: posting slots (find_next_slot, manage_posting_slots), signatures, RSS feeds written by AI, short-link clicks, plugs (arm_plug), and on Studio, Pro and Agency AI images (generate_post_image), client review links and client invite links
• DM and comment automation: generate_flow (describe an automation in plain words, get a reviewable draft), generate_multiple_flows, create_automation, activate_flow, list_flows_with_stats, step-level editing
• Analytics: get_post_analytics, get_analytics_overview, get_flow_stats, get_content_insights
• Leads and growth: capture_lead, get_collected_data, create_broadcast, create_sequence, create_growth_widget, get_pixel_embed

Install

Claude Code

/plugin marketplace add sociahive/sociahive-mcp
/plugin install sociahive@sociahive-mcp

Or only the MCP server:

claude mcp add --transport http sociahive https://www.sociahive.com/api/mcp

Codex

codex mcp add sociahive --url https://www.sociahive.com/api/mcp
codex mcp login sociahive

Gemini CLI

gemini extensions install https://github.com/sociahive/sociahive-mcp

Or only the MCP server:

gemini mcp add --transport http sociahive https://www.sociahive.com/api/mcp

Cursor

Add to Cursor, or add this to .cursor/mcp.json:

{
  "mcpServers": {
    "sociahive": { "url": "https://www.sociahive.com/api/mcp" }
  }
}

Claude and ChatGPT

Add a custom connector with the URL https://www.sociahive.com/api/mcp and sign in when asked. ChatGPT custom connectors need a paid ChatGPT plan.

Grok

No OAuth sign-in yet. Make an API key (Settings > API keys) and add a remote MCP server where Grok asks for one:

Name:    sociahive
URL:     https://www.sociahive.com/api/mcp
Header:  Authorization: Bearer sk-your-api-key

See sociahive.com/connect-ai/grok.

Any agent that reads skills

npx skills add sociahive/sociahive-mcp

Any MCP client, one command

npx @sociahive/mcp add

The wizard detects your agents (Claude Code, Codex, Gemini CLI, Cursor, VS Code, Windsurf, Claude Desktop) and writes their MCP config.

Agent frameworks

Works with any client that speaks streamable HTTP: OpenAI Agents SDK (MCPServerStreamableHttp), LangChain (langchain-mcp-adapters), CrewAI. Examples: sociahive.com/developers.

Quick reference

Things to ask your AI tool once SociaHive is connected:

The same jobs from the CLI:

The CLI

For local images and videos, CSV imports and scripts:

npm install -g sociahive
export SOCIAHIVE_API_KEY=sk_...   # https://www.sociahive.com/settings?tab=api-keys
sociahive upload slide_01.jpg slide_02.jpg
sociahive flows generate --description "DM my price list when someone comments PRICE"
sociahive insights --weeks 8

Run sociahive --help or sociahive <command> --help for every option. The full command list is in references/cli.md.

SDKs and workflow tools

• Node.js: npm install @sociahive/sdk (sociahive/sociahive-node)
• Python: pip install sociahive (sociahive/sociahive-python)
• n8n: install the community node n8n-nodes-sociahive (sociahive/n8n-nodes-sociahive)

Safety

• API keys are scoped (posts:read, posts:write, flows:write, analytics:read, ...); a read-only key can never publish. OAuth sign-in offers read-only access.
• Publishing now and other irreversible or bulk actions ask for confirmation: nothing goes live until a second, confirming call.
• Automations are created as drafts. The skill tells your AI tool to check with you before turning one on; that is an instruction to the agent, not a server-side lock, so review what it built.
• X posting is available on paid plans only.

Data and permissions

• Accounts connect through each platform's official login and APIs. SociaHive does not scrape and never asks for your account password (Bluesky uses an app password, Telegram a bot token).
• Platform tokens are stored encrypted on SociaHive's servers. They are never sent to your AI tool and never returned by the API.
• Access is limited to the scopes you grant: API key scopes (for example posts:read, posts:write, flows:write) or the permissions you approve at OAuth sign-in, where you can choose read-only access.
• You can revoke access at any time: revoke a key in Settings > API keys, or disconnect an AI tool in Settings > Connected apps.

Links

• Connect guides: sociahive.com/connect-ai
• Developer docs: sociahive.com/developers · docs.sociahive.com
• Changelog
• Privacy · Terms

The server is part of the SociaHive platform (closed source). This repository holds the public manifests, the skill and setup docs. MIT licensed.