12 min read
Postel MCP Server for Claude, ChatGPT and Cursor
Postel is the social media MCP server that writes like you. Ask Claude or ChatGPT for this week's LinkedIn post and it comes back sounding like you, then goes on your calendar. It can also find what's going viral on X in your niche and write your take, and it schedules or publishes to X, LinkedIn, Bluesky, Mastodon and Instagram through each network's official API. The server is hosted at https://www.postel.app/api/mcp, so there's one URL to add and nothing to run. It's listed in Claude's connector directory, works in ChatGPT, Cursor, n8n and any other MCP client, and the first 7 days cost $1.
#1 social media MCP server
Postel
Your AI assistant writes posts in your voice and schedules them through Postel. It's hosted, so there's nothing to run yourself.
- Writes in your voice. It learns from your own posts and notes, so drafts read like you wrote them, not like a template.
- Finds what's going viral in your niche. It shows the posts doing best for real creators in your niche, then writes your take on one in your voice.
- Your agent can publish. It schedules or publishes to X, LinkedIn, Bluesky, Mastodon and Instagram through each network's official API, and saves YouTube and TikTok videos as drafts you finish in Postel.
- Works from your AI tools. Use it from Claude, ChatGPT, Cursor or n8n through its MCP server, or from Zapier and Make through its API.
- $1 for 7 days. Then from $29 a month. Cancel anytime.
8,000+ people have signed up · $1 for 7 days · Cancel anytime
Listed in Claude's directory. Needs a Postel account: $1 for 7 days, then from $29 a month.
Install
https://www.postel.app/api/mcp
| Setting | Value |
|---|---|
| Claude connector | Postel in Claude's connector directory |
| Transport | Streamable HTTP |
| Sign-in | OAuth 2.1 in your browser, or an API key as a bearer token |
Claude (web and desktop): open the directory listing, click Connect and sign in to Postel. Or open Customize > Connectors, click + Add, choose Add custom connector and paste the server URL.
Claude Code (plugin):
/plugin marketplace add robinfaraj/postel-mcp
/plugin install postel@postel
Claude Code (server only):
claude mcp add --transport http postel \
https://www.postel.app/api/mcp
Then run /mcp in a session and sign in in your browser.
ChatGPT: open Plugins, click +, choose Add custom MCP server, paste the server URL and sign in to Postel. Custom MCP servers that can write, like Postel's, work on ChatGPT Business, Enterprise and Edu on the web, where an admin may need to add them; Pro can only connect read-only servers (OpenAI's guide, checked October 30, 2026).
The next three examples use an API key, which you create in Postel under Settings > API Keys. Cursor and VS Code can also sign in with OAuth: leave out the headers block.
Cursor:
{
"mcpServers": {
"postel": {
"url": "https://www.postel.app/api/mcp",
"headers": {
"Authorization": "Bearer pstl_YOUR_API_KEY"
}
}
}
}
VS Code:
{
"servers": {
"postel": {
"type": "http",
"url": "https://www.postel.app/api/mcp",
"headers": {
"Authorization": "Bearer pstl_YOUR_API_KEY"
}
}
}
}
Windsurf:
{
"mcpServers": {
"postel": {
"serverUrl": "https://www.postel.app/api/mcp",
"headers": {
"Authorization": "Bearer pstl_YOUR_API_KEY"
}
}
}
}
Other clients take the server URL and the key as a bearer token.
Here's this week's changelog. Write a short post for X, LinkedIn and Bluesky, and schedule them all for Friday at 9am.
Allow Postel to run create-posts?
Postelcreate-posts3 posts scheduled
csv export now works from any view, and search answers before you finish typing.
X · Scheduled in Postel
Two small things shipped this week: CSV export from any view, and search that answers before you finish typing.
LinkedIn · Scheduled in Postel
New this week: CSV export from any view, and faster search.
Bluesky · Scheduled in Postel
Done. Each one is written for its network and goes out Friday at 9:00 AM. You can still edit them in Postel until then.
API keys (Cursor, VS Code, Windsurf and others)
Cursor, VS Code, Windsurf and most other clients can sign in with an API key. An organization admin creates one:
- Open Settings > API Keys in Postel.
- Click Create API Key and give it a name.
- Copy the key now. It's shown only once.
Keys start with pstl_. The dialog also shows ready-to-copy config for each client.
Client details
Jump to: Claude Code · Cursor · VS Code · Gemini CLI · Codex · OpenClaw · Zed · Goose · n8n · Agent skills
Claude Code
Add --scope user to the claude mcp add command to use Postel in every project, or --scope project to share it with your team through .mcp.json. Without a flag it's added to the current project only.
To use an API key in a shared project, add this to .mcp.json:
{
"mcpServers": {
"postel": {
"type": "http",
"url": "https://www.postel.app/api/mcp",
"headers": {
"Authorization": "Bearer pstl_YOUR_API_KEY"
}
}
}
}
Cursor
Add Postel to Cursor in one click: the link opens Cursor with the server filled in, and Cursor asks you to sign in the first time a tool needs your account. Or paste the Cursor config above into ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Visual Studio Code
Install Postel in VS Code in one click, or add it from a terminal:
code --add-mcp '{"name":"postel","type":"http","url":"https://www.postel.app/api/mcp"}'
You can also open the Command Palette (Cmd+Shift+P on Mac, Ctrl+Shift+P on Windows and Linux) and run MCP: Add Server. Choose HTTP and enter the server URL; VS Code adds it to your mcp.json and signs you in with OAuth. To use an API key instead, add the headers block from the VS Code config above. Start or restart the server from MCP: List Servers.
Gemini CLI
Install the Postel extension. It adds the server and a short GEMINI.md that tells Gemini how to research, draft and schedule with it:
gemini extensions install \
https://github.com/robinfaraj/postel-mcp
Then run /mcp auth postel in Gemini CLI and sign in in your browser. To add only the server, without the extension:
gemini mcp add -s user -t http postel \
https://www.postel.app/api/mcp
Codex
Codex CLI, the Codex IDE extension and the desktop app share one config, so you add Postel once:
codex mcp add postel \
--url https://www.postel.app/api/mcp
codex mcp login postel
codex mcp login opens your browser to sign in to Postel. To use an API key instead, keep it in an environment variable and point Codex at it:
export POSTEL_API_KEY=pstl_YOUR_API_KEY
codex mcp add postel \
--url https://www.postel.app/api/mcp \
--bearer-token-env-var POSTEL_API_KEY
Put the export line in your shell profile so new terminals and the IDE extension can read it. If the desktop app doesn't see the key, sign in with OAuth there instead.
OpenClaw
OpenClaw connects to remote MCP servers over Streamable HTTP. It only changes servers while the Gateway is stopped, so run openclaw gateway stop first, then add Postel with OAuth:
openclaw mcp add postel \
--url https://www.postel.app/api/mcp \
--transport streamable-http \
--auth oauth
openclaw mcp login postel
openclaw mcp doctor postel --probe
openclaw gateway start
The login command prints a link to sign in to Postel, the doctor command checks that the tools load, and the last line starts the Gateway again. To add the server while the Gateway runs, use OpenClaw's Control UI. API key setup, the writing skill and prompts that work from a chat app are in OpenClaw for social media.
Zed
Open Settings > AI > MCP Servers, click Add Server, choose Add Remote Server and paste the server URL. Without an Authorization header, Zed asks you to sign in with OAuth. To use an API key, add this postel entry under context_servers in your Zed settings:
{
"context_servers": {
"postel": {
"url": "https://www.postel.app/api/mcp",
"headers": {
"Authorization": "Bearer pstl_YOUR_API_KEY"
}
}
}
}
Goose
Run goose configure, choose Add Extension, then Remote Extension (Streamable HTTP). Name it postel, paste the server URL, and add an Authorization header with Bearer pstl_YOUR_API_KEY. In Goose Desktop it's under Settings > Extensions > Add custom extension.
n8n AI Agent
To let an n8n AI Agent post, add an MCP Client Tool node under the agent's tools. Set the endpoint to the server URL, the transport to HTTP Streamable, and authentication to Bearer Auth with your pstl_ key. Under Tools to Include, pick the ones the agent should have. To keep everything as drafts you review in Postel, leave out schedule-post, create-posts and publish-post. More on agents, the community node and n8n's own MCP server: n8n MCP for social media.
Arcade
Arcade is a platform for giving agents tools through MCP gateways. It doesn't list Postel in its catalog, but you can add Postel to your own Arcade project as a remote server:
- In your project's MCP servers dashboard, click Add Server and choose Remote MCP.
- Set the ID to
posteland the URI to the server URL, then save. Arcade asks you to sign in to Postel with OAuth. - In an MCP Gateway, open Select tools and pick Postel's tools. For a gateway that should only draft, leave out
schedule-post,create-postsandpublish-post.
To use an API key instead of OAuth, store your pstl_ key as an Arcade secret named POSTEL_API_KEY, and in step 2 add this Authorization header under Advanced settings:
Bearer ${secret:POSTEL_API_KEY}
Arcade connects over Streamable HTTP and passes tools only, which is all Postel uses (Arcade's guide, checked November 4, 2026).
Agent skills
The Postel writing skill teaches an agent how to use the tools well: research first, write in your voice, follow each network's limits, and ask before scheduling. The Claude Code plugin includes it. For Codex, Cursor and other agents that read Agent Skills:
npx skills add robinfaraj/postel-mcp \
--skill postel-writing
postel-writing is the skill for the MCP tools. The repo also has postel-api, which calls Postel's REST API with curl and an API key, for agents that can't connect to an MCP server.
The plugin, extension and skill are open source in github.com/robinfaraj/postel-mcp.
All 17 tools
Posts (7 tools)
| Tool | What it does |
|---|---|
list-posts | Lists your posts, optionally by status |
get-post | Returns one post |
create-post | Saves text as a draft, with optional media URLs |
update-post | Edits a draft |
delete-post | Deletes a post and cancels its schedule |
schedule-post | Schedules a draft for a future time |
publish-post | Publishes a draft now |
Bulk and media (2 tools)
| Tool | What it does |
|---|---|
create-posts | Creates up to 25 posts in one call and schedules the ones with a date |
attach-media | Downloads an image or video from a public URL and attaches it to a draft |
Writing (2 tools)
| Tool | What it does |
|---|---|
generate-post | Writes a post or thread in your voice and saves it as a draft (1 AI credit) |
refine-post | Suggests a rewrite of a draft without saving it (1 AI credit) |
Research (1 tool)
| Tool | What it does |
|---|---|
search-viral-tweets | Finds viral X posts by topic. No sign-in needed |
Context (5 tools)
| Tool | What it does |
|---|---|
list-brands | Returns your topics |
get-brand-sources | Returns the background sources for a topic |
get-x-profiles | Returns your X and LinkedIn voice profiles |
get-schedule | Returns your weekly posting slots |
get-usage | Shows your AI credit balance |
Your client asks before it runs a tool that schedules or publishes, unless you turn that off. In Claude, Research can run connector tools without asking, so switch off Postel's schedule and publish tools before you use it.
Networks
The server schedules and publishes to X, LinkedIn, Bluesky, Mastodon and Instagram. On YouTube and TikTok, the agent saves the video post as a draft, and you choose the settings those networks ask for on every post, such as title and privacy, in Postel's editor before it's scheduled. TikTok posts go out as Only me from a private account until TikTok finishes reviewing Postel. generate-post takes a platform (x, linkedin, bluesky, mastodon, youtube, instagram or tiktok), and schedule-post and publish-post send each draft to the network it was written for. LinkedIn company Pages and Threads are coming soon (submitted for review), and the same tools will post there once each is approved.
- X (Twitter) MCP server: research viral posts, draft tweets and threads, schedule them
- LinkedIn MCP server: draft LinkedIn posts in your voice and schedule them
- Connect Claude to X: step-by-step guide
- Connect Claude to LinkedIn: step-by-step guide
- Connect ChatGPT to LinkedIn and to X: setup for ChatGPT Business, Enterprise and Edu
- Build in public from Claude Code: turn commits into posts
- OpenClaw for social media: post to X, LinkedIn, Bluesky, Mastodon and Instagram from your OpenClaw agent
- Hermes Agent for social media, DeepSeek Harness and n8n: the same from other agents
- Social media MCP servers compared: Postel next to the other servers that publish
Built for your own posts
The server writes, schedules and publishes your own posts, and nothing else: it never reads your feeds or messages, and never likes, replies, follows or comments for you, so your accounts don't act like bots. Media comes from public URLs; files you uploaded into the chat go in the Postel editor, along with analytics.
Draft and schedule your posts from your AI assistant, in your voice
Postel learns how you write, drafts posts in your voice and publishes them to X, LinkedIn, Bluesky, Mastodon, Instagram, YouTube and TikTok on schedule. Use it on its own or from Claude, ChatGPT or Cursor.
8,000+ people have signed up
$1 for 7 days · Cancel anytime
Frequently asked questions
What is the best social media MCP server?
Postel's, if you want your assistant to write and post for you. It writes in the voice it learned from your own posts, finds what's going viral in your niche, and schedules or publishes to X, LinkedIn, Bluesky, Mastodon and Instagram. It's hosted, listed in Claude's connector directory, and works in ChatGPT, Cursor, n8n and other MCP clients. See social media MCP servers compared.
Which AI assistants work with the Postel MCP server?
Any client that supports remote MCP servers: Claude on the web and desktop, Claude Code, ChatGPT, Cursor, VS Code, Windsurf, Gemini CLI, Codex, OpenClaw, Hermes Agent, DeepSeek Harness, Zed, Goose, Arcade and n8n's AI Agent. Claude users can add Postel from Claude's connector directory.
Do I need a paid Postel plan to use the MCP server?
Yes. Every Postel plan includes it, and so does the trial: $1 for 7 days, then from $29 a month. Cancel anytime. generate-post and refine-post use 1 AI credit each; saving text your assistant wrote uses none.
Is it safe to give an AI assistant access to Postel?
Your assistant only gets the Postel tools listed above. It never sees your X or LinkedIn password. Every request goes over HTTPS and must carry a valid API key or OAuth sign-in from a member of your workspace. API keys are limited to 60 requests per minute, keys are stored hashed, and the full key is shown only once, when you create it.
Can I use the MCP server with more than one workspace?
Yes. API keys belong to one workspace, so create a key in each workspace you want to use. OAuth connects to the workspace you joined most recently; use an API key to pick a specific workspace.
What happens if I run out of AI credits?
generate-post and refine-post switch to Lite mode (a smaller model, 10 actions a day) until your credits renew or you top up. Every other tool keeps working. Use get-usage to check where you stand.