Postel

Postel MCP server for X (Twitter) and LinkedIn

Draft, schedule and publish X (Twitter) and LinkedIn posts from Claude, Cursor and other MCP clients.

Postel is a writing and scheduling tool for people who post as themselves: founders, consultants and creators. Its hosted MCP server lets an AI assistant research high-performing X posts, draft posts and threads in your saved voice, and schedule or publish them to your X account and your personal LinkedIn profile once you approve.

This repository holds the public metadata for that server: the Claude plugin, the MCP Registry entry and setup instructions. The server itself is hosted by Postel; there is nothing to run locally.

Server URL	https://www.postel.app/api/mcp
Transport	Streamable HTTP
Authentication	OAuth 2.1 with dynamic client registration, or an API key as a bearer token
Registry name	app.postel/postel

Setup

Post research (search-viral-tweets) works without an account. For everything else you need a Postel account; connect your X account, your LinkedIn profile or both under Settings > Channels.

Claude Code plugin

/plugin marketplace add robinfaraj/postel-mcp
/plugin install postel@postel

Then run /mcp and sign in to Postel. The plugin adds the server and a postel-writing skill that teaches Claude the drafting and scheduling workflow.

Claude Code without the plugin

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

Run /mcp to sign in. To use an API key instead:

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

Claude (web and desktop)

Open Customize > Connectors, click +, choose Add custom connector, enter https://www.postel.app/api/mcp and sign in to Postel when asked.

Cursor

Add this to your MCP settings (~/.cursor/mcp.json or .cursor/mcp.json in a project):

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

Create the key in Postel under Settings > API Keys. Keys start with pstl_ and are scoped to one workspace.

Other clients

Any client that supports remote MCP servers over Streamable HTTP works. Point it at the server URL above and either let it run the OAuth sign-in or send Authorization: Bearer pstl_YOUR_API_KEY.

Tools

Posts

Tool	What it does
list-posts	Lists posts, with an optional status filter
get-post	Returns one post by ID
create-post	Saves text as a new X or LinkedIn draft, with optional images or video from public URLs and an optional LinkedIn first comment
create-posts	Saves up to 25 posts in one call, each with its own platform, media and first comment, and optionally schedules each one
attach-media	Downloads an image or video from a public URL and adds it to a draft
update-post	Edits the text of a draft
delete-post	Deletes a post and cancels its schedule
schedule-post	Schedules a draft for a future time, optionally setting a LinkedIn first comment
publish-post	Publishes a draft now

Writing and research

Tool	What it does
generate-post	Writes an X post, an X thread or a LinkedIn post in your voice and saves it as a draft
refine-post	Suggests a rewrite of a draft from your instructions
search-viral-tweets	Finds high-performing X posts by topic in Postel's library. No sign-in needed

Context

Tool	What it does
list-brands	Lists your brands and topics
get-brand-sources	Returns background sources for a brand
get-x-profiles	Returns your X and LinkedIn voice profiles
get-schedule	Returns your weekly posting slots and timezone
get-usage	Shows your AI credit balance and plan

Example prompts

• "Find viral posts about bootstrapping a SaaS and tell me what the best hooks have in common."
• "Draft a LinkedIn post about the pricing change we shipped this week, and put the changelog link in the first comment."
• "Turn these three notes into LinkedIn drafts and attach this screenshot to the first one."
• "Write a thread about what we learned from our last launch."
• "Show me what is scheduled for next week."
• "Schedule that post for Tuesday at 9am Berlin time."

What it does not do

• It does not read your X timeline, mentions or DMs, or your LinkedIn feed or messages.
• It does not like, reply, follow, comment or send connection requests.
• LinkedIn posts go to personal profiles only, not company pages.
• Images and video are added from public URLs. Uploading a local file and adding documents (LinkedIn PDF carousels) happen in the Postel editor.
• First comments are LinkedIn only. X posts have no first comment.
• Threads are X only. generate-post writes them; create-post saves a single post.
• Research searches Postel's indexed library of X posts, not live X.

Plans and limits

• Research needs no account. Drafting and reading posts work on any plan. generate-post and refine-post use 1 AI credit each.
• If your workspace requires approval, scheduling submits the post for approval instead. An owner or admin approves it in Postel.
• Scheduling and publishing need a paid plan or trial. See pricing.
• API keys are limited to 60 requests per minute.

Links

• Setup guide and FAQ
• LinkedIn MCP server
• X MCP server
• Connect Claude to LinkedIn
• Privacy policy · Terms
• Support: contact form

License

The files in this repository are released under the MIT License. The Postel service is covered by its own terms.