Postel

app.postelv1.0.0Updated Oct 1, 2026

Draft, schedule and publish X (Twitter) and LinkedIn posts in your own voice.

Overview

AI-generated overview

Lets an assistant draft, schedule and publish X and LinkedIn posts in your saved voice, and research high-performing X posts.

What it does
Postel is a hosted MCP server for writing and scheduling social posts. Tools cover the post lifecycle: list-posts, get-post, create-post, update-post, delete-post, schedule-post and publish-post. Writing tools generate-post and refine-post draft X posts, X threads or LinkedIn posts in your saved voice, while search-viral-tweets finds high-performing X posts by topic from Postel's indexed library. Context tools expose brands, voice profiles, weekly posting slots and usage limits.
When to use it
Useful if you post as yourself on X or LinkedIn and want an assistant to research hooks, draft posts and threads, and queue or publish them after your approval. It fits founders, consultants and creators who already use Postel for scheduling. It is not for reading timelines, mentions or DMs, or for engagement actions.
Requirements
A remote Streamable HTTP endpoint; nothing runs locally. Research works without an account. Everything else needs a Postel account with a connected X account, LinkedIn profile or both. Authentication is OAuth 2.1 with dynamic client registration, or an API key sent as an Authorization bearer token. Scheduling and publishing need a paid plan or trial.
Before you install
The server can publish to your live X account and personal LinkedIn profile, and delete posts and cancel their schedules, so review drafts before approving. It needs account access and either OAuth sign-in or an API key in the Authorization header; keys are workspace-scoped and limited to 60 requests per minute. AI generation counts against a monthly quota. LinkedIn posts go to personal profiles only, and images, video and first comments are added in the Postel editor.

Installation

In SourceWeft

  1. Open Postel in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

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

README

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 URLhttps://www.postel.app/api/mcp
TransportStreamable HTTP
AuthenticationOAuth 2.1 with dynamic client registration, or an API key as a bearer token
Registry nameapp.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

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

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

bash
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):

json
{  "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

ToolWhat it does
list-postsLists posts, with an optional status filter
get-postReturns one post by ID
create-postSaves text as a new draft
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

Writing and research

ToolWhat it does
generate-postWrites an X post, an X thread or a LinkedIn post in your voice and saves it as a draft
refine-postSuggests a rewrite of a draft from your instructions
search-viral-tweetsFinds high-performing X posts by topic in Postel's library. No sign-in needed

Context

ToolWhat it does
list-brandsLists your brands and topics
get-brand-sourcesReturns background sources for a brand
get-x-profilesReturns your voice profiles
get-scheduleReturns your weekly posting slots and timezone
get-usageShows usage and plan limits

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."
  • "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, video, documents and LinkedIn first comments are added in the Postel editor, not through MCP.
  • 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, and AI generation counts against your monthly quota.
  • Scheduling and publishing need a paid plan or trial. See pricing.
  • API keys are limited to 60 requests per minute.

Links

License

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

Source: README.md at commit 2d83f7b

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.0LatestOct 1, 2026