SociaHive Documentation
Quickstarts, MCP setup, flow patterns, cookbook recipes, and SDK references for the SociaHive automation platform.
Control SociaHive — social media scheduling, automation flows, contacts, and analytics — programmatically. Pick the door that matches you.
The three doors
For AI assistants
Let Claude, ChatGPT, Cursor, or any MCP-compatible assistant drive SociaHive on your behalf. Two-minute setup via MCP.
For developers
Call the REST API directly, or use the official Node and Python SDKs in your application. cURL, OpenAPI, and codegen included.
For no-code operators
Zapier, Make, and n8n. Native connectors are in progress — for now, point a generic HTTP node at the REST API.
What else is here
- Flow patterns — seven named patterns (keyword router, AI fallback, drip with branches, etc.) that cover most of what people build with SociaHive flows.
- Cookbook — three end-to-end recipes you can copy and run today: auto-reply to Instagram comments, schedule a week of posts from a CSV, triage your AI inbox with Claude.
Surfaces at a glance
| Surface | URL / package | Auth | Best for |
|---|---|---|---|
| MCP server (HTTP) | https://www.sociahive.com/api/mcp | OAuth 2.1 + DCR or X-API-Key | AI assistants — Claude, ChatGPT, Cursor |
| MCP server (stdio) | sociahive-mcp binary | X-API-Key | Local AI clients (Claude Desktop, Claude Code) |
| REST API v1 | https://www.sociahive.com/api/v1/* | X-API-Key or OAuth bearer | Any HTTP client; the foundation under the SDKs |
| CLI | sociahive (npm) | SOCIAHIVE_API_KEY env | Shell scripts, CI/CD, ad-hoc operations |
| Node SDK | @sociahive/sdk | Same as REST | Application code in TypeScript / Node.js |
| Python SDK | sociahive (PyPI) | Same as REST | Application code in Python |
Auxiliary endpoints:
- Interactive API reference — Scalar UI rendering the OpenAPI 3.1 spec, try-it-now enabled.
- OpenAPI 3.1 spec — machine-readable; feed it into Postman, ChatGPT Custom GPTs, or any SDK generator.
- OAuth discovery —
/.well-known/oauth-authorization-server(RFC 8414) and/.well-known/oauth-protected-resource(RFC 9728). MCP clients use these to bootstrap auth automatically.