Developer & MCP Platform

Programmatic Infrastructure
Built For AI Agents

Automate social media publishing from your terminal, backend services, or autonomous AI agents via the Model Context Protocol (MCP), Streamable HTTP APIs, and cryptographically signed webhooks.

Model Context Protocol (MCP)Streamable REST APIWebhooks Architecture
Standard Anthropic Protocol

Official MCP Server Card

Connect Claude Desktop, Cursor, Antigravity, or autonomous LangChain / LlamaIndex pipelines directly to your SocialHive account. Your AI assistant can draft, validate character limits, render images, and dispatch social campaigns natively.

Available MCP Tools
compose_social_postDrafts & optimizes multi-platform post
trigger_workflowExecutes 5-stage BullMQ pipeline
generate_episodic_videoCreates 4-scene MiniMax video
list_connected_accountsInspects OAuth token status
Discovery URL: /.well-known/mcp/server-card.json
claude_desktop_config.json
{
  "mcpServers": {
    "socialhive": {
      "command": "npx",
      "args": ["-y", "@socialhive/mcp-server@latest"],
      "env": {
        "SOCIALHIVE_API_KEY": "sh_live_89fa10bc938e..."
      }
    }
  }
}
High-Throughput REST & SSE

Streamable HTTP Publishing API

Dispatch campaigns synchronously or stream execution logs with Server-Sent Events (SSE).

curl -X POST https://platform.socialhive.pro/api/v1/publish \
  -H "Authorization: Bearer sh_live_89fa10bc938e..." \
  -H "Content-Type: application/json" \
  -d '{
    "profiles": ["linkedin_corp", "x_brand", "instagram_reels"],
    "content": "Autonomous publishing at 99.99% reliability.",
    "media": [{ "type": "image", "url": "https://cdn.socialhive.pro/media/flux_88.jpg" }],
    "schedule": "immediate"
  }'
Real-Time Ingestion

Webhooks Architecture & Cryptography

Every critical lifecycle transition triggers an asynchronous webhook signed with HMAC-SHA256. Verify requests against the `X-SocialHive-Signature` header to guarantee authenticity.

post.publishedDispatched to network
review.approvedClient signed token
post.failedNetwork rate limit error
workflow.completedAll 5 stages finished
verify-signature.ts
import crypto from "crypto";

export function verifySocialHiveWebhook(
  payload: string, 
  signatureHeader: string, 
  secret: string
): boolean {
  const hmac = crypto.createHmac("sha256", secret);
  const digest = "sha256=" + hmac.update(payload).digest("hex");
  return crypto.timingSafeEqual(
    Buffer.from(signatureHeader), 
    Buffer.from(digest)
  );
}
Status Endpoint

Public System Health & Uptime API

GET https://platform.socialhive.pro/api/health
Queue Engine
BullMQ Redis 7.2
0 backpressure
Database Latency
PostgreSQL 16
2.4ms avg ping
Token Vault
AES-256-GCM
HSM Active
API Availability
Global Anycast
99.99% 30d SLA