
Hookpost by Hookstep: hosted MCP server, CLI and n8n node to draft and schedule social media posts
Hookpost by Hookstep: hosted MCP server, CLI and n8n node to draft and schedule social media posts from Claude, Cursor, VS Code and Gemini CLI.
·
Hookpost by Hookstep. A social media scheduler you can drive from Claude, Cursor, VS Code, Gemini CLI and other AI assistants. (Not related to the Shopify Flow app called HookPost.)
Website: https://hookpost.hookstep.in · Setup guide: https://hookpost.hookstep.in/mcp
Hookpost runs a hosted MCP server. Connect your AI assistant to it once, and the assistant can:
Posts from an assistant land in the same calendar as posts written in the app, with an MCP badge, and go through the same checks as the editor. If a post breaks a network's rules, the assistant gets the reason back. There is no delete tool: deleting, and editing the text or date of an existing post, stay in the app.
There is nothing to install for the MCP server. It is one URL:
https://hookpost.hookstep.in/api/mcpYour workspace API key goes in an Authorization: Bearer header. Copy the key from Settings → Developers in Hookpost. For a client that cannot send headers, put the key in the path instead: https://hookpost.hookstep.in/api/mcp/YOUR_API_KEY.
Behind a gateway that keeps the Authorization header for itself, such as Smithery, send the key as x-hookpost-api-key: YOUR_API_KEY instead (the raw key; a Bearer prefix is also accepted). If a request carries both headers, Authorization wins.
Treat the key like a password. It gives full access to your workspace's channels and posts, so keep it out of shared configs and public repos.
claude mcp add --transport http hookpost https://hookpost.hookstep.in/api/mcp \
--header "Authorization: Bearer YOUR_API_KEY"Check it with claude mcp list.
Or install the Hookpost plugin, which adds the server plus a skill that tells Claude to check each network's rules and save drafts first. Claude Code asks for your API key once and keeps it in your system's credential store:
/plugin marketplace add jatinder14/hookpost-mcp
/plugin install hookpost@hookpostGo to Customize → Connectors → + Add → Add custom connector, paste the URL with your key in the path, and choose no sign-in:
https://hookpost.hookstep.in/api/mcp/YOUR_API_KEYClaude adds remote servers as connectors, not through claude_desktop_config.json. On Claude's free plan you get one custom connector. If Claude Desktop can't connect that way, use the mcp-remote bridge in claude_desktop_config.json (it needs Node.js):
{
"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 on your machine and forwards to the hosted server.
A Hookpost app for ChatGPT is not available yet. Until it is, draft in ChatGPT and paste into the Hookpost editor, or use one of the clients on this page.
Click Add to Cursor at the top of this page, then set HOOKPOST_API_KEY in your environment (Cursor reads ${env:HOOKPOST_API_KEY} from it). Or add it by hand in .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" }
}
}
}Click Install in VS Code at the top of this page. VS Code asks for your API key once and stores it as a secret. Or add it by hand in .vscode/mcp.json in your workspace:
{
"servers": {
"hookpost": {
"type": "http",
"url": "https://hookpost.hookstep.in/api/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}Install this repo as an extension. It asks for your API key once and keeps it in your system keychain:
gemini extensions install https://github.com/jatinder14/hookpost-mcpOr add the server by hand to ~/.gemini/settings.json. Use httpUrl, not url (in Gemini CLI, url means an SSE server):
{
"mcpServers": {
"hookpost": {
"httpUrl": "https://hookpost.hookstep.in/api/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}~/.codex/config.toml. Codex reads the key from the HOOKPOST_API_KEY environment variable, so it never sits in the file:
[mcp_servers.hookpost]
url = "https://hookpost.hookstep.in/api/mcp"
bearer_token_env_var = "HOOKPOST_API_KEY"Install the Hookpost power: in the Powers panel, choose Add Custom Power → Import power from GitHub and enter https://github.com/jatinder14/hookpost-mcp/tree/main/powers/hookpost. It signs in with OAuth, so there is no key to copy.
Grok adds remote MCP servers as custom connectors: open grok.com/connectors, click New Connector → Custom, enter https://hookpost.hookstep.in/mcp-oauth and sign in with your Hookpost account. For Grok Build, the grok/hookpost/ plugin installs the same server with the hookpost skill.
Open Windsurf's MCP settings, choose View raw config to open mcp_config.json, and add the hookpost entry from windsurf/mcp_config.json:
{
"mcpServers": {
"hookpost": {
"serverUrl": "https://hookpost.hookstep.in/api/mcp",
"headers": {
"Authorization": "Bearer ${env:HOOKPOST_API_KEY}"
}
}
}
}Windsurf reads HOOKPOST_API_KEY from your environment, so the key stays out of the file. On macOS an app opened from the Dock doesn't see variables set in .zshrc: open Windsurf from a terminal, or put the key in the file in place of ${env:HOOKPOST_API_KEY}. Windsurf takes serverUrl for remote servers, not url. Restart Cascade after saving.
In your agent, go to Tools → Add a tool → New tool → Model Context Protocol. Enter https://hookpost.hookstep.in/api/mcp as the server URL, choose API key authentication with type Header and header name x-hookpost-api-key, then paste your key (without Bearer) when you create the connection. A ready-to-import custom connector and the Microsoft 365 Copilot package are in microsoft/.
Other clients: see https://hookpost.hookstep.in/mcp.
| Tool | What it does |
|---|---|
integrationList | Lists your connected channels, optionally for one customer group. |
groupList | Lists your customer groups. |
integrationSchema | Returns a network's rules, character limit and the settings a post needs. |
triggerTool | Calls a channel helper, for example to fetch your Pinterest boards. |
integrationSchedulePostTool | Creates posts on one or more channels: as a draft, scheduled for a time, or published now. |
postsListTool | Lists posts between two dates with their state (queued, draft, published or error). |
postSettingsTool | Changes the network settings of a post that has not gone out yet. Text and date stay as they are. |
uploadFromUrlTool | Imports an image or video from a public URL into your media library. |
generateImageTool | Generates an AI image for a post, from the plan's AI image allowance. |
generateVideoOptions, videoFunctionTool, generateVideoTool | AI video helpers. No plan on sale includes video credits today. |
The hookpost CLI uses the same API key. It needs Node.js 18 or later.
npm install -g hookpost
hookpost auth login
hookpost channels
hookpost post "Hello" --channel abc123With no --at, a post goes into the next free slot in your posting schedule. Add --at with 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. Source: cli/.
The n8n-nodes-hookpost community node creates, lists and deletes posts, lists channels, finds the next free slot and uploads media from a URL. In n8n, go to Settings → Community Nodes → Install and enter n8n-nodes-hookpost. Source: n8n-node/.
The MCP server, CLI and REST API come with Hookpost's Standard and Pro plans. New workspaces get 3 free posts with no card needed; then Standard is $19/month (₹599 in India) or Pro $29/month (₹1,999 in India). Current prices are at https://hookpost.hookstep.in/pricing.
| Path | What it is |
|---|---|
cli/ | Source of the hookpost CLI on npm |
n8n-node/ | Source of the n8n-nodes-hookpost community node on npm |
gemini-extension.json | Gemini CLI extension that connects to the hosted MCP server |
plugins/hookpost/ | Claude Code plugin (marketplace in .claude-plugin/marketplace.json) |
.cursor-plugin/ and mcp.json | Cursor plugin: the hosted MCP server plus the hookpost skill |
powers/hookpost/ | Kiro power (Agent Plugins format): the hosted MCP server over OAuth plus the hookpost skill |
grok/hookpost/ | Grok Build plugin: the hosted MCP server over OAuth plus the hookpost skill |
llms-install.md | Setup steps for AI agents such as Cline |
windsurf/mcp_config.json | Windsurf config for the hosted MCP server |
microsoft/ | Copilot Studio custom connector, and the Microsoft 365 / Copilot certification package (how to submit it) |
tests/ | Checks for every listing manifest (cd tests && npm ci && npm test) |
server.json | The server's entry in the official MCP Registry, as in.hookstep/hookpost |
The MCP server itself is hosted by Hookpost; its code is not in this repo.
Official MCP Registry (in.hookstep/hookpost) · GitHub MCP Registry · Glama · LobeHub · mcpservers.org · RapidAPI
Email [email protected], or open an issue here. Docs: https://hookpost.hookstep.in/docs/public-api. Privacy policy: https://hookpost.hookstep.in/privacy.
MIT. Copyright (c) 2026 Hookstep. See LICENSE.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add hookpost -- npx -y mcp-remote https://hookpost.hookstep.in/api/mcp/YOUR_API_KEY{
"mcpServers": {
"hookpost": {
"args": [
"-y",
"mcp-remote",
"https://hookpost.hookstep.in/api/mcp/YOUR_API_KEY"
],
"command": "npx"
}
}
}code --add-mcp '{"name":"hookpost","args":["-y","mcp-remote","https://hookpost.hookstep.in/api/mcp/YOUR_API_KEY"],"command":"npx"}'[mcp_servers.hookpost]
command = "npx"
args = ["-y", "mcp-remote", "https://hookpost.hookstep.in/api/mcp/YOUR_API_KEY"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/hookpost-mcp to learn what the "Hookpost Mcp" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add --transport http hookpost https://hookpost.hookstep.in/api/mcpnpm install -g hookpostThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: its endpoint did not list its tools to an anonymous client, which usually means it asks for an API key or a sign-in. The four checks that need a live server are left out, and the grade tops out at B until we can read its tools.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/hookpost-mcp)Nothing comparable is listed yet.
v1.0.0Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "hookpost-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.