Social Media MCP Server for AI Agents
Turn Claude Desktop, Cursor, Cline, or your custom AI agent into an autonomous social media manager. Schedule, draft, and publish across 17 channels with natural language prompts.
What is a Social Media MCP Server?
A Social Media MCP Server is a specialized implementation of Anthropic's open Model Context Protocol that allows AI models (such as Claude 3.7 Sonnet, ChatGPT, and Cursor AI) to securely interact with social media publishing APIs. Through standardized JSON-RPC tool endpoints, AI agents can inspect scheduled calendars, draft platform-compliant captions, validate character limits, and publish directly to 17 social networks without human context switching.
One MCP Server, All Your Favorite AI Clients
Claude Desktop
claude_desktop_config.json{
"mcpServers": {
"hookpost": {
"url": "https://hookpost.hookstep.in/api/mcp/YOUR_API_KEY"
}
}
}Cursor AI
.cursor/mcp.json{
"mcpServers": {
"hookpost": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://hookpost.hookstep.in/api/mcp/YOUR_API_KEY"],
"env": {
"HOOKPOST_API_KEY": "YOUR_API_KEY"
}
}
}
}VS Code (Cline / Roo)
cline_mcp_settings.json{
"mcpServers": {
"hookpost": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://hookpost.hookstep.in/api/mcp/YOUR_API_KEY"],
"env": {
"HOOKPOST_API_KEY": "YOUR_API_KEY"
}
}
}
}Windsurf Cascade
mcp_config.json{
"mcpServers": {
"hookpost": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://hookpost.hookstep.in/api/mcp/YOUR_API_KEY"],
"env": {
"HOOKPOST_API_KEY": "YOUR_API_KEY"
}
}
}
}Native MCP Tools Exposed to Agents
| Tool Name | Function | Input Parameters |
|---|---|---|
| list_channels | Lists all active connected profiles, handles, and character constraints. | None |
| draft_post | Stages a drafted post with platform validation across multiple networks. | channels, content, mediaUrls? |
| schedule_post | Queues content for automated dispatch at a specified UTC timestamp. | channels, content, scheduledAt, media? |
| get_analytics | Queries real-time impressions, engagement rates, and post performance. | postId?, channelId?, timeRange? |
Production MCP Prompts for Claude & Cursor
Natural language instructions you can send directly to Claude Desktop or Cursor to drive Hookpost:
“Inspect my connected channels using Hookpost MCP. Draft a 4-post launch thread about our open-source release with hashtags, validate character counts for X and Bluesky, and queue them for tomorrow at 9:00 AM UTC.”
“Summarize the blog post at this URL into a professional LinkedIn article format and a concise Threads post. Cross-post drafts to Hookpost for review.”
“Query Hookpost for all scheduled posts across our Instagram and Facebook profiles over the next 14 days. Identify days with zero scheduled posts and draft 3 reel concepts to fill the gaps.”
“Call get_analytics for our top 5 performing posts over the past 30 days. Breakdown impressions, click-throughs, and engagement rates by platform, and output an executive markdown summary.”
MCP Protocol Specifications & Architecture
| Protocol Specification | Anthropic Model Context Protocol (v2024-11-05 / 2025 Standard) |
| Supported Transports | stdio (Terminal Subprocess) & sse (Server-Sent Events over TLS 1.3) |
| Cryptographic Security | AES-256 GCM encrypted OAuth tokens; zero transmission of social credentials to LLMs |
| AI Client Compatibility | Claude Desktop, Cursor AI, VS Code (Cline/Roo-Code), Windsurf Cascade, LangChain, CrewAI |
| Supported Social Platforms | 18 Networks (Instagram, YouTube, X, LinkedIn, Facebook, Threads, Bluesky, Pinterest, Discord, Telegram...) |
| Open-Source License | AGPL-3.0 (full self-hosting & commercial SaaS freedom) |
Social Media MCP Server Frequently Asked Questions
What is a Social Media MCP Server?▼
A Social Media MCP Server is a Model Context Protocol bridge that connects Large Language Models (like Claude, ChatGPT, and Cursor AI) directly to social media management APIs. It allows AI agents to inspect scheduled content calendars, generate platform-optimized captions, draft threads, and publish across 17 networks using standard JSON-RPC tools.
What tools does the Hookpost MCP Server provide to AI agents?▼
Hookpost exposes four primary MCP tools: (1) list_channels: inspect connected profiles and limits, (2) draft_post: stage multi-network posts with character validation, (3) schedule_post: queue posts with ISO timestamps and media, and (4) get_analytics: retrieve engagement metrics.
Does Hookpost MCP support Cursor, VS Code, and Windsurf alongside Claude?▼
Yes. Hookpost MCP implements the open Anthropic Model Context Protocol specification and works seamlessly across Claude Desktop, Cursor AI, VS Code (Cline/Roo-Code), Windsurf, and custom terminal agent scripts.
Is the Hookpost MCP Server free and open-source?▼
Yes, Hookpost MCP is licensed under AGPL-3.0. The public source release is not out yet, so the repository is shared on request. You can use it with free cloud accounts or self-host your own Docker instance with zero subscription fees.
How do I install and configure Hookpost MCP in Claude Desktop?▼
Open your claude_desktop_config.json and add 'hookpost': { 'url': 'https://hookpost.hookstep.in/api/mcp/YOUR_API_KEY' }. Restart Claude Desktop and you will see a hammer icon representing the live social media tools.
Can AI agents auto-publish directly, or is there a human-in-the-loop review step?▼
Both workflows are supported. You can configure agents to draft posts into your Hookpost queue as drafts requiring visual review, or grant permissions for autonomous scheduling directly to connected channels.
How are social media OAuth tokens and credentials secured in the MCP server?▼
OAuth credentials and refresh tokens are AES-256 encrypted in Hookpost's database. The local MCP server only communicates with Hookpost via secure HTTPS JSON-RPC API tokens. Your social platform access tokens never pass into LLM context windows or training datasets.
Does Hookpost MCP support custom AI agent frameworks like LangChain, AutoGen, and CrewAI?▼
Yes. Hookpost implements the standard Anthropic Model Context Protocol specification over stdio and SSE transports. Any agent framework that supports MCP clients (LangChain, CrewAI, AutoGen, LlamaIndex) can connect directly to Hookpost tools.
100% Private, On-Premise AI Execution
The Hookpost MCP Server connects directly from your local terminal to your Hookpost instance. Your API tokens, audience analytics, and drafted media never leave your controlled infrastructure.