MCP server

Connect Claude, ChatGPT, Cursor and other MCP clients to Postel so they can research, draft and schedule posts for you.

Postel runs a hosted Model Context Protocol server. Once you connect it, an AI client like Claude can write posts in your voice, save them as drafts in Postel, and schedule or publish them after you approve.

Server URL

https://www.postel.app/api/mcp

It uses the Streamable HTTP transport. You sign in with your Postel account through OAuth, or send an API key.

Claude

Postel is listed in Claude's connector directory.

Open Postel in Claude's connector directory and click Connect.
A Postel window opens. Sign in and approve access.
In a chat, click +, open Connectors and switch Postel on.

To add it by hand instead, open Customize → Connectors, click + Add, choose Add custom connector and enter the server URL. On Claude Team and Enterprise plans, an owner adds the connector first under Organization settings → Connectors.

Claude Desktop uses the same connectors as Claude on the web.

Claude Code

Terminal

claude mcp add --transport http postel https://www.postel.app/api/mcp

Or connect with an API key:

Terminal

claude mcp add --transport http postel \
  https://www.postel.app/api/mcp \
  --header "Authorization: Bearer $POSTEL_API_KEY"

Cursor and other clients

Add the server URL to your client's MCP settings. For Cursor, put this in .cursor/mcp.json, and Cursor asks you to sign in:

.cursor/mcp.json

{
  "mcpServers": {
    "postel": {
      "url": "https://www.postel.app/api/mcp"
    }
  }
}

To use an API key instead, add a header:

.cursor/mcp.json

{
  "mcpServers": {
    "postel": {
      "url": "https://www.postel.app/api/mcp",
      "headers": {
        "Authorization": "Bearer pstl_..."
      }
    }
  }
}

ChatGPT and other clients that support remote MCP servers connect with the same URL.

OAuth or API key

	OAuth	API key
Setup	Sign in with your Postel account	Create a key in Settings → API & MCP
Workspace	The workspace you joined most recently	The workspace the key was created in
Best for	Claude, ChatGPT and other chat apps	Claude Code, scripts, and choosing a workspace

API keys for MCP are the same keys the REST API uses. See Authentication.

Tools

Tool	What it does
`search-viral-tweets`	Searches Postel's index of high-performing X posts by topic. Works without signing in.
`generate-post`	Writes a post in your voice from a prompt and saves it as a draft. Uses 1 AI credit.
`refine-post`	Suggests a rewrite of a post from your instructions, without saving it. Uses 1 AI credit.
`create-post`	Saves a draft, with optional media URLs and a LinkedIn first comment.
`create-posts`	Saves up to 25 posts in one call, and schedules the ones with a time.
`attach-media`	Downloads an image or video from a public URL and attaches it to a draft.
`update-post`	Changes a draft.
`delete-post`	Deletes a post. A scheduled post is taken off the schedule first.
`list-posts`	Lists posts, filtered by status.
`get-post`	Gets one post.
`schedule-post`	Schedules a draft, or sends it for approval when the workspace needs it. Needs a paid plan.
`publish-post`	Publishes a draft now. Needs a paid plan.
`list-brands`	Lists your brands, the background Postel uses when it writes.
`get-brand-sources`	Gets the sources behind a brand.
`get-x-profiles`	Lists your voice profiles.
`get-schedule`	Gets your weekly posting slots.
`get-usage`	Shows your AI credit balance.

When the AI writes the text itself and only saves it in Postel, no credits are used.

Approval

Claude asks you before it runs a tool that schedules or publishes. In Postel, you can also make every post from MCP wait for approval: turn on Posts written by AI under Settings → General → Approvals. Then MCP can only send posts for approval. See Approvals and plans.

In Claude, Research can run connector tools without asking, so switch off Postel's schedule and publish tools before you use it.