What is a social media MCP server?

An MCP (Model Context Protocol) server gives an AI assistant tools it can call. Hookpost's lists your connected channels, reads each network's rules and creates posts, so you can ask Claude or Cursor to draft and schedule posts on Instagram, Facebook Pages, Threads, X, LinkedIn, YouTube, Pinterest, Discord and Slack instead of copying text into a scheduler.

Which Hookpost plan includes the MCP server?

Standard ($19 a month, ₹599 in India) and Pro ($29 a month, ₹1,999 in India). The server authenticates with your workspace API key, which is under Settings > Developers on those plans, 3-day trial included.

Can an AI agent publish without me reviewing it?

It can, if you ask it to: the schedule tool creates drafts, scheduled posts or posts that go out now. Ask for drafts and review them in the calendar first. Most MCP clients, including Claude Code, also ask your permission before they run a tool.

Does the AI see my social media passwords or tokens?

No. Network tokens stay on Hookpost’s servers and the tools return channel names and ids, never credentials. The text of the posts, and anything the assistant reads to write them, does pass through the AI model you use.

Can the agent delete or edit posts?

It can change the network settings of a post that has not gone out. There is no delete tool, and no tool changes a post’s text or date or reads analytics. Do those in the Hookpost app.

Does it work with ChatGPT?

No. Hookpost has no ChatGPT connector set up, so ChatGPT is not listed as supported. The clients on this page connect to the same remote MCP server.

MCP server · Standard plan and above

Connect Claude, Cursor or any MCP client to Hookpost

Hookpost runs a hosted MCP server. Add it to your AI assistant with your API key and the assistant can see your connected channels, read each network's rules and save posts to your Hookpost calendar as drafts or scheduled posts. In the 30 days to 22 October 2026, Hookpost published posts on Instagram, Facebook Pages, Threads, X, LinkedIn, YouTube, Pinterest, Discord and Slack; 18 networks can be connected in all. Nothing to install: it is one URL. It comes with Standard at $19 a month (₹599 in India) and Pro.

Get an API key Setup for your client Post from the terminal

By the Hookpost team · Updated 11 October 2026

Set it up in your client

Every client talks to the same endpoint, https://hookpost.hookstep.in/api/mcp, with your key in an Authorization: Bearer header. Copy the key from Settings → Developers in Hookpost (the app also generates these snippets with your key filled in). For a client that cannot send headers, put the key in the path: https://hookpost.hookstep.in/api/mcp/YOUR_API_KEY.

Copy your API key. In Hookpost on Standard or Pro, open Settings > Developers and copy the API key.
Add the server to your client. Point your MCP client at https://hookpost.hookstep.in/api/mcp with the header Authorization: Bearer YOUR_API_KEY, or at https://hookpost.hookstep.in/api/mcp/YOUR_API_KEY if the client cannot send headers.
Ask for drafts. Ask the assistant to list your Hookpost channels and save posts as drafts, then review them in the Hookpost calendar.

Claude Code

Run in your terminal

claude mcp add --transport http hookpost https://hookpost.hookstep.in/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Check it with claude mcp list. Team setup with .mcp.json, headless runs and CI: Claude Code guide.

Claude (claude.ai and Claude Desktop)

Customize → Connectors → + Add → Add custom connector

https://hookpost.hookstep.in/api/mcp/YOUR_API_KEY

Paste the URL with your key, and choose no sign-in. Claude adds remote servers as connectors, not in claude_desktop_config.json; on Claude's free plan you get one custom connector. If Claude can't connect, use the config file with the mcp-remote bridge below in Claude Desktop. Step by step: schedule posts from Claude.

Cursor

.cursor/mcp.json in a project, or ~/.cursor/mcp.json for all projects

{
  "mcpServers": {
    "hookpost": {
      "url": "https://hookpost.hookstep.in/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code (Copilot agent mode)

.vscode/mcp.json in your workspace

{
  "servers": {
    "hookpost": {
      "type": "http",
      "url": "https://hookpost.hookstep.in/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code tries Streamable HTTP first and falls back to SSE. Open Copilot Chat in Agent mode to use the tools.

Windsurf

Windsurf's mcp_config.json

{
  "mcpServers": {
    "hookpost": {
      "serverUrl": "https://hookpost.hookstep.in/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Codex CLI

~/.codex/config.toml

# ~/.codex/config.toml
[mcp_servers.hookpost]
url = "https://hookpost.hookstep.in/api/mcp"
bearer_token_env_var = "HOOKPOST_API_KEY"

Codex reads the key from the HOOKPOST_API_KEY environment variable and sends it as a Bearer token, so the key never sits in the file.

Gemini CLI

~/.gemini/settings.json

{
  "mcpServers": {
    "hookpost": {
      "httpUrl": "https://hookpost.hookstep.in/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Use httpUrl, not url: in Gemini CLI, url means an SSE server.

Config-file clients without HTTP support

e.g. claude_desktop_config.json

{
  "mcpServers": {
    "hookpost": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://hookpost.hookstep.in/api/mcp/YOUR_API_KEY"]
    }
  }
}

mcp-remote is a third-party bridge that runs locally (it needs Node.js) and forwards to the hosted server.

ChatGPT

Not listed as supported: Hookpost has no ChatGPT connector set up. Until it does, draft in ChatGPT and paste into the Hookpost editor.

Prefer the terminal?

The hookpost CLI takes the same API key. Install it from npm (it needs Node.js 18 or later), sign in once, and post in one line:

npm install -g hookpost
hookpost auth login
hookpost channels
hookpost post "Hello" --channel abc123

Run the commands one at a time: hookpost auth login asks for your API key, then the API host (press Enter to keep the default). Replace abc123 with an id from hookpost channels. With no --at, the post is scheduled into the next free slot in your posting schedule; add --at and an ISO date for an exact time, --now to publish straight away or --draft to save a draft. In CI, set HOOKPOST_API_KEY instead of signing in.

hookpost on npm (its README lists every command) · More examples, and the Node SDK: CLI and SDK

Where agent posts land

In the same calendar as everything else. A post queued from Cursor sits next to the one your colleague wrote in the browser, so there is one place to see what goes out when.

Drafts are marked. A draft shows as "Draft:" on its day and in the list view's draft filter. Scheduled posts show at their time.
You can tell who wrote it. Open a post and the editor header shows a badge for how it was created: MCP for an AI assistant, API or CLI for code, WEB for the app. The share preview shows it too.
Same checks as the editor. Posts from MCP go through the validation the app runs: character limits, media rules and required settings. A failure comes back to the assistant with the reason.
Failures are visible. If a network rejects a post at publish time, it turns red in the calendar with the error, and you get an in-app notification and, unless you turned them off, an email.

Tools the assistant gets

Hookpost MCP tools
Tool	What it does	Input
integrationList	Lists your connected channels, optionally for one customer group.	group?
groupList	Lists your customer groups.	none
integrationSchema	Returns a network's rules, character limit and the settings a post needs.	platform, isPremium
triggerTool	Calls a channel helper, for example to fetch your Pinterest boards.	integrationId, methodName, dataSchema
integrationSchedulePostTool	Creates posts on one or more channels: as a draft, scheduled for a time, or published now.	socialPost[]
postsListTool	Lists posts between two dates with their state (queued, draft, published or error).	startDate, endDate, customer?, includeAttachments?
postSettingsTool	Changes the network settings of a post that has not gone out yet. Text and date stay as they are.	id, settings[]
uploadFromUrlTool	Imports an image or video from a public URL into your media library (images up to 10 MB, video up to 1 GB).	url
generateImageTool	Generates an AI image for a post. Uses the plan's AI image allowance.	prompt
generateVideoOptions	Lists the AI video types.	none
videoFunctionTool	Helper lookups for AI video generation.	varies
generateVideoTool	Generates an AI video. No plan on sale includes video credits today.	varies

There is no delete tool, and no tool edits the text or date of an existing post, reads analytics or connects a new channel. Do those in the app.

How this compares with Buffer, Hootsuite, Planoly and others: social media MCP servers compared.

Prompts to start with

Launch thread

List my Hookpost channels. Write a 4-post launch thread for X and one post for Bluesky about our release, check both against the network limits, and save them as drafts for tomorrow 9:00 IST.

Blog post to LinkedIn and Threads

Summarise the blog post at this URL as a LinkedIn post and a shorter Threads post. Save both as drafts in Hookpost.

Gaps in the calendar

List my Hookpost posts for the next 14 days. Tell me which days have nothing scheduled on LinkedIn and draft a post for each of them.

Weekly recap

List every post Hookpost published in the last 7 days, group them by channel, and flag any post in ERROR state with its error.

Plans

Standard · $19/month (₹599 in India)

MCP, REST API and CLI. 5 channels, 500 posts a month, 20 AI images a month.

Pro · $29/month (₹1,999 in India)

Everything in Standard, 20 channels, 2,000 posts a month, 100 AI images and up to 15 team members.

Billed in US dollars by card; in India, in rupees through Razorpay with UPI AutoPay, cards or NetBanking. Each plan starts with a 3-day trial. All limits: pricing.

How the server works

Transport: Remote Streamable HTTP at https://hookpost.hookstep.in/api/mcp, stateless, with JSON responses. A legacy HTTP+SSE route stays available for older clients. There is no stdio package to install.
Authentication: Your workspace API key, as a Bearer header or in the URL path. One key per workspace; rotating it in Settings stops the old one at once.
What the model sees: Channel names and ids, network rules and your posts. Never the network tokens, which stay on Hookpost's servers.
Errors without a key: 401 Missing Authorization header, or 401 Invalid API Key or OAuth token for a wrong or rotated key.

Prefer plain HTTP from your own code? The same key works with the REST API, the hookpost CLI and the n8n node.

Questions

What is a social media MCP server?: An MCP (Model Context Protocol) server gives an AI assistant tools it can call. Hookpost's lists your connected channels, reads each network's rules and creates posts, so you can ask Claude or Cursor to draft and schedule posts on Instagram, Facebook Pages, Threads, X, LinkedIn, YouTube, Pinterest, Discord and Slack instead of copying text into a scheduler.
Which Hookpost plan includes the MCP server?: Standard ($19 a month, ₹599 in India) and Pro ($29 a month, ₹1,999 in India). The server authenticates with your workspace API key, which is under Settings > Developers on those plans, 3-day trial included.
Can an AI agent publish without me reviewing it?: It can, if you ask it to: the schedule tool creates drafts, scheduled posts or posts that go out now. Ask for drafts and review them in the calendar first. Most MCP clients, including Claude Code, also ask your permission before they run a tool.
Does the AI see my social media passwords or tokens?: No. Network tokens stay on Hookpost’s servers and the tools return channel names and ids, never credentials. The text of the posts, and anything the assistant reads to write them, does pass through the AI model you use.
Can the agent delete or edit posts?: It can change the network settings of a post that has not gone out. There is no delete tool, and no tool changes a post’s text or date or reads analytics. Do those in the Hookpost app.
Does it work with ChatGPT?: No. Hookpost has no ChatGPT connector set up, so ChatGPT is not listed as supported. The clients on this page connect to the same remote MCP server.

Guides: Claude Code, Claude in the browser or desktop app, one post to several networks.