PostHubify MCP Server

Exposes the PostHubify /v1 API as a Model Context Protocol server — letting Claude Desktop, Cursor, and other MCP clients drive social media publishing, inbox, contacts, analytics, ads, and SMS/OTP operations through natural language.

• Zero dependencies — Node standard library only (raw JSON-RPC over stdio).
• Auto-generated tools — tools are generated at runtime from the live /v1/openapi.json spec; when a new endpoint is added, the corresponding tool appears automatically (operationId = tool name).
• 190+ operations → 190+ MCP tools (can be narrowed with a tag filter).

Configuration

| Environment variable | Required | Description | |---|---|---| | POSTHUBIFY_API_KEY | yes | sk_… API key (from the API Keys screen) | | POSTHUBIFY_BASE_URL | no | Defaults to http://localhost:8787/v1 | | POSTHUBIFY_MCP_TAGS | no | Comma-separated tag filter, e.g. posts,inbox,contacts — if omitted, all endpoints |

Claude Desktop / Cursor setup

Add the following to claude_desktop_config.json (or your Cursor MCP settings):

{
  "mcpServers": {
    "posthubify": {
      "command": "npx",
      "args": ["-y", "@posthubify/mcp"],
      "env": {
        "POSTHUBIFY_API_KEY": "sk_...",
        "POSTHUBIFY_BASE_URL": "https://api.posthubify.com/v1"
      }
    }
  }
}

To narrow the tool surface (so it doesn't consume too much context), add POSTHUBIFY_MCP_TAGS:

"env": { "POSTHUBIFY_API_KEY": "sk_...", "POSTHUBIFY_MCP_TAGS": "posts,inbox,contacts,analytics" }

How it works

1. At startup, BASE_URL/openapi.json is fetched → each operation becomes a tool (named by operationId, described by summary, with a combined path+query+body inputSchema).
2. When the client sends tools/call, the arguments are split into path/query/body based on the tool metadata, forwarded to the /v1 endpoint with Bearer auth, and the response is returned as text.

Development

# Run locally (with the API open on 8787):
POSTHUBIFY_API_KEY=sk_test POSTHUBIFY_BASE_URL=http://localhost:8787/v1 npm run start --workspace @posthubify/mcp

# Tests (from root):
npx vitest run packages/mcp

License

MIT