Skip to content

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.

Joschua SünnekeUpdated

#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.
Connect in Claude (opens in a new tab)

Listed in Claude's directory. Needs a Postel account: $1 for 7 days, then from $29 a month.

Install

Server URL
https://www.postel.app/api/mcp
SettingValue
Claude connectorPostel in Claude's connector directory
TransportStreamable HTTP
Sign-inOAuth 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):

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

Claude Code (server only):

Terminal
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:

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

VS Code:

.vscode/mcp.json
{
  "servers": {
    "postel": {
      "type": "http",
      "url": "https://www.postel.app/api/mcp",
      "headers": {
        "Authorization": "Bearer pstl_YOUR_API_KEY"
      }
    }
  }
}

Windsurf:

~/.codeium/windsurf/mcp_config.json
{
  "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.

Chat in ClaudePostel connector on

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.

Postel calendarFri 9:00 AMXcsv export now works from any view, and search answers before you finish typing.Fri 9:00 AMLinkedInTwo small things shipped this week: CSV export from any view, and search that answers before you finish typing.Fri 9:00 AMBlueskyNew this week: CSV export from any view, and faster search.
An example chat, drawn by us with Postel's real tool names. Claude's own screens look a little different.

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:

  1. Open Settings > API Keys in Postel.
  2. Click Create API Key and give it a name.
  3. 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:

.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:

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:

Terminal
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:

Terminal
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:

Terminal
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:

Terminal
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:

Terminal
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:

settings.json
{
  "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:

  1. In your project's MCP servers dashboard, click Add Server and choose Remote MCP.
  2. Set the ID to postel and the URI to the server URL, then save. Arcade asks you to sign in to Postel with OAuth.
  3. In an MCP Gateway, open Select tools and pick Postel's tools. For a gateway that should only draft, leave out schedule-post, create-posts and publish-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:

Authorization header
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:

Terminal
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)

ToolWhat it does
list-postsLists your posts, optionally by status
get-postReturns one post
create-postSaves text as a draft, with optional media URLs
update-postEdits a draft
delete-postDeletes a post and cancels its schedule
schedule-postSchedules a draft for a future time
publish-postPublishes a draft now

Bulk and media (2 tools)

ToolWhat it does
create-postsCreates up to 25 posts in one call and schedules the ones with a date
attach-mediaDownloads an image or video from a public URL and attaches it to a draft

Writing (2 tools)

ToolWhat it does
generate-postWrites a post or thread in your voice and saves it as a draft (1 AI credit)
refine-postSuggests a rewrite of a draft without saving it (1 AI credit)

Research (1 tool)

ToolWhat it does
search-viral-tweetsFinds viral X posts by topic. No sign-in needed

Context (5 tools)

ToolWhat it does
list-brandsReturns your topics
get-brand-sourcesReturns the background sources for a topic
get-x-profilesReturns your X and LinkedIn voice profiles
get-scheduleReturns your weekly posting slots
get-usageShows 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.

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

Or connect Postel from Claude's directory (opens in a new tab)

One email a week. Unsubscribe 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.