Postel

Find what's going viral in your niche, write your version in your own voice, and schedule it, without leaving Claude, ChatGPT, Cursor or any MCP client.

Postel is an AI writing and scheduling tool for people who post as themselves: founders, consultants and creators. This repository holds the public side of its hosted MCP server: setup for every client, the Claude Code plugin, the Gemini CLI extension, an agent skill and the MCP Registry entry. The server runs at https://www.postel.app/api/mcp; there is nothing to install or host.

• Start from what's working. Postel keeps a library of posts that took off for real creators, scored by how far each one beat its author's usual reach. Your assistant searches it by topic and shows you why the top ones worked.
• Sound like you. Drafts come from your voice profile (built from your own X or LinkedIn posts) and the facts you saved, not from a generic template.
• Schedule where you post. X (posts and threads), personal LinkedIn profiles, Bluesky, Mastodon, YouTube and TikTok, through each network's official API, after you approve.

Install

Before your first post, connect your networks in Postel under Settings > Channels. Research works right away; drafting, scheduling and publishing need a Postel account.

Claude (web, desktop, mobile)

Open Postel in Claude's connector directory, click Connect and sign in to Postel. Or add it by hand: Customize > Connectors, +, Add custom connector, enter https://www.postel.app/api/mcp.

Claude Code

/plugin marketplace add robinfaraj/postel-mcp

/plugin install postel@postel

Then run /mcp and sign in to Postel. The plugin adds the server and the postel-writing skill, which teaches Claude the research, drafting and scheduling workflow. Without the plugin:

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

Add --scope user to use it in every project, or --header "Authorization: Bearer pstl_YOUR_API_KEY" to use an API key instead of signing in.

Cursor

Click Add to Cursor above, or add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{

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

Cursor runs the sign-in the first time a tool needs your account. To use an API key, add "headers": { "Authorization": "Bearer pstl_YOUR_API_KEY" }.

VS Code

Click Install in VS Code above, or add this to .vscode/mcp.json:

{

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

Gemini CLI

gemini extensions install https://github.com/robinfaraj/postel-mcp

Then run /mcp auth postel inside Gemini CLI to sign in. The extension adds the server and a short GEMINI.md with the same workflow rules as the skill.

Codex CLI

codex mcp add postel --url https://www.postel.app/api/mcp

codex mcp login postel

Hermes Agent

hermes plugins install postel --enable

hermes mcp add postel --url https://www.postel.app/api/mcp --auth oauth --connect-timeout 300

The plugin (agent-plugin/, a portable Agent Plugins v1 package) adds the server and the postel-writing skill, and asks Hermes to confirm every tool that isn't read-only. The second command signs you in. Until the plugin is in your Hermes catalog, the second command alone gives you the tools.

The same agent-plugin/ folder works as a Perplexity Computer custom plugin (Plugins, Add custom, paste this repository's URL) and as a NanoClaw template.

DeepSeek Harness

dsh plugin --profile web add "github:robinfaraj/postel-mcp#path:/plugins/dsh-postel"

Research works without a key. To draft and schedule, set POSTEL_API_KEY before starting dsh. Details: plugins/dsh-postel.

Kimi Code CLI

In Kimi Code, run /plugins install https://github.com/robinfaraj/postel-mcp, then /reload and /mcp-config login postel to sign in. The plugin (kimi.plugin.json) adds the server and the postel-writing skill.

Grok Build

grok plugin marketplace add robinfaraj/postel-mcp

grok plugin install postel --trust

ChatGPT

In ChatGPT, open Settings > Apps & Connectors > Advanced settings, turn on Developer mode, then Create a connector with the URL https://www.postel.app/api/mcp and OAuth sign-in. OpenAI decides which plans can use custom connectors that write (draft, schedule, publish); at the time of writing that is Business, Enterprise and Edu workspaces, while research works more widely. Step-by-step: connect ChatGPT to LinkedIn and to X.

Windsurf, Zed, Goose and other clients

Any client that supports remote MCP servers over Streamable HTTP works. Point it at https://www.postel.app/api/mcp and let it run the OAuth sign-in, or send Authorization: Bearer pstl_YOUR_API_KEY. Windsurf names the field serverUrl instead of url. For a client that only runs local servers, use a bridge such as npx mcp-remote https://www.postel.app/api/mcp.

Create an API key in Postel under Settings > API Keys. Keys start with pstl_ and belong to one workspace.

Agent skills

Two plain Agent Skills for any agent that reads SKILL.md files:

• postel-writing (in skills/): how to research, write for each network and confirm before scheduling or publishing, using the MCP server above.
• postel-api (in .agents/skills/): the same workflow over Postel's REST API with curl and a POSTEL_API_KEY, for agents without MCP support.

npx skills add robinfaraj/postel-mcp

Example prompts

• "What's going viral about cold email this month? Write my take for LinkedIn: we stopped using templates and reply rates doubled."
• "Find the most-viewed posts about bootstrapping a SaaS and tell me what the best hooks have in common."
• "Turn this blog post into an X thread and schedule it for Thursday at 3pm New York time."
• "Write the same announcement for X, LinkedIn and Bluesky, each in its own style, and put the changelog link in the LinkedIn first comment."
• "Here's my new video: (link). Write the description, attach the video and save it as a YouTube draft so I can set the title in Postel."
• "Turn these five notes into posts for Monday to Friday at 9am and attach this screenshot to the first one."
• "Show me what's scheduled for next week."

Tools

17 tools. search-viral-tweets works without an account; the rest need a signed-in Postel account or an API key. Every tool carries a title and read-only or destructive hints, so your client can ask before anything is scheduled, published or deleted.

Research and writing

Posts

| `delete-po