llms.txt
Compare with other sites' llms.txt files →# Postel
> Postel is an AI writing and scheduling tool for X, LinkedIn, Bluesky, Mastodon, YouTube and TikTok. It finds what's going viral in your niche, from real creators, and turns it into your own post in your voice. It also drafts posts from your ideas, videos and articles, on Pro writes your next week of posts for you to approve, and works inside Claude through its connector.
Postel is made for people who post as themselves: founders, consultants, creators and small teams. It is not a general social media management suite.
## Key facts
- Networks: X, LinkedIn, Bluesky, Mastodon, YouTube and TikTok.
- Coming soon (built and submitted for review, with no date yet): publishing to LinkedIn company Pages, Instagram and Threads and LinkedIn analytics.
- X: posts, threads with media, and posts to X Communities.
- LinkedIn: personal profiles. Text up to 3,000 characters with up to 20 images, one MP4 video or one document (PDF, PowerPoint or Word), plus an optional first comment.
- Bluesky: posts and threads from the same composer, up to 300 characters and 4 images.
- Mastodon: posts and threads on any server, using the server's limit (500 by default) with images, a video or a GIF.
- YouTube: one video per post, up to 1 GB, with its own title, privacy and made-for-kids setting; a vertical or square video of 3 minutes or less goes out as a Short.
- TikTok: one video per post, with TikTok's settings for who can view, comments, duets, stitches and branded content. Until TikTok finishes reviewing Postel, posts go out as Only me and the TikTok account must be private.
- Writing: drafts in the user's own voice, from a voice profile built on their X timeline or a public LinkedIn profile, and from a knowledge base of their topics and background.
- Repurposing: turns YouTube videos, reels, articles and voice notes into posts.
- One post, a version per network: a thread splits where the network threads and merges into one post on LinkedIn; each version can be edited separately.
- Plan next week (Pro and up): fills the free posting slots of the next 7, 14 or 28 days with X and LinkedIn posts, each built from the user's own material (facts, best older posts, niche trends, viral posts, topics). The posts wait in Review for the user to approve, or the user can choose to have them scheduled in their slots as soon as they're written.
- For You (Pro and up): a Review queue of X and LinkedIn drafts, including LinkedIn carousels, written from viral posts in the user's niche and their own material; the user approves, edits or skips each one.
- Bring your own AI key (Pro and up): run Postel's AI on an Anthropic, OpenAI or OpenRouter key; that usage bills to the provider and costs no Postel credits.
- Approvals: an optional approval step for teams and agencies, on every plan.
- Analytics: post and follower analytics for X, Bluesky and Mastodon on every plan.
- Viral posts: a searchable library of X posts and short and long videos that took off, from individual creators (no brands, politicians or aggregator pages), filterable by topic, views and account size, and scored by how far each one outran its author's usual reach. Any X post in it can be turned into the user's own post in their voice ("Use as template").
- Post templates: the public template pages ([X](https://www.postel.app/twitter-templates), [LinkedIn](https://www.postel.app/linkedin-post-templates)) show 26 outlines; in the app, Viral posts › Formats has 30+ formats (launch, playbook, the numbers behind a result, hiring and more), each proven by real viral posts that follow it. Answering one question writes the format in the user's voice for LinkedIn and X (one AI credit per platform); an outline is free. Any viral post can also be used as a template.
- Scheduling: weekly posting slots, schedule-to-next-slot, and a calendar with month, week, day and list views, shared across all connected platforms.
- MCP server: a hosted server at https://www.postel.app/api/mcp lets Claude, ChatGPT, Claude Code, Cursor and other MCP clients search Postel's library of high-performing X posts, write posts in the user's voice, and draft, schedule and publish them to X, LinkedIn, Bluesky, Mastodon, YouTube and TikTok, with media from URLs and up to 25 posts per call. It supports OAuth 2.1 and API keys, and is on every paid plan. Postel is listed in Claude's connector directory; ChatGPT, Cursor and other MCP clients connect with the server URL. Directory listing: https://claude.ai/directory/connectors/www-postel-app
- Postel does not offer: Facebook publishing, a social inbox, or social listening.
## AI agents and install paths
- Server: `https://www.postel.app/api/mcp` (Streamable HTTP). Sign-in is OAuth 2.1 with dynamic client registration, or a Postel API key (`pstl_`, from Settings > API Keys) sent as `Authorization: Bearer pstl_...`. 17 tools; `search-viral-tweets` works without an account. MCP Registry name: `app.postel/postel`. Public repo with the plugin, extension and skill: https://github.com/robinfaraj/postel-mcp
- Claude (web, desktop, mobile): click Connect on https://claude.ai/directory/connectors/www-postel-app and sign in. Or Customize > Connectors > + Add > Add custom connector, with the server URL.
- Claude Code plugin (server plus writing skill): `/plugin marketplace add robinfaraj/postel-mcp`, then `/plugin install postel@postel`.
- Claude Code, server only: `claude mcp add --transport http postel https://www.postel.app/api/mcp`, then run `/mcp` to sign in. Add `--header "Authorization: Bearer pstl_..."` to use an API key.
- 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](https://help.openai.com/en/articles/12584461-connecting-custom-mcp-servers-in-chatgpt), checked October 30, 2026).
- Cursor: one-click install at https://cursor.com/install-mcp?name=postel&config=eyJ1cmwiOiJodHRwczovL3d3dy5wb3N0ZWwuYXBwL2FwaS9tY3AifQ==, or add `{"mcpServers": {"postel": {"url": "https://www.postel.app/api/mcp"}}}` to `~/.cursor/mcp.json`.
- VS Code: one-click install at https://vscode.dev/redirect/mcp/install?name=postel&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fwww.postel.app%2Fapi%2Fmcp%22%7D, or run `code --add-mcp '{"name":"postel","type":"http","url":"https://www.postel.app/api/mcp"}'`.
- Windsurf: add `{"mcpServers": {"postel": {"serverUrl": "https://www.postel.app/api/mcp"}}}` to `~/.codeium/windsurf/mcp_config.json`.
- Gemini CLI extension: `gemini extensions install https://github.com/robinfaraj/postel-mcp`, then `/mcp auth postel`. Server only: `gemini mcp add -s user -t http postel https://www.postel.app/api/mcp`.
- Codex (CLI, IDE extension and app share one config): `codex mcp add postel --url https://www.postel.app/api/mcp`, then `codex mcp login postel`. With an API key: add `--bearer-token-env-var POSTEL_API_KEY`.
- OpenClaw: with the Gateway stopped (`openclaw gateway stop`), run `openclaw mcp add postel --url https://www.postel.app/api/mcp --transport streamable-http --auth oauth`, then `openclaw mcp login postel`, then start the Gateway again. While it runs, use the Control UI instead. Guide: https://www.postel.app/openclaw-social-media
- OpenClaw skill from ClawHub (REST API with curl and `POSTEL_API_KEY`, no MCP): `openclaw skills install @robinsadeghpour/postel`. Other skills worth pairing: https://www.postel.app/best-openclaw-skills
- Hermes Agent: `hermes mcp add postel --url https://www.postel.app/api/mcp --auth oauth` (signs in in the browser), or a `mcp_servers` entry in `~/.hermes/config.yaml` with an `Authorization: Bearer ${POSTEL_API_KEY}` header. Writing skill: `hermes skills install robinfaraj/postel-mcp/skills/postel-writing`. Guide: https://www.postel.app/hermes-agent-social-media
- DeepSeek Harness: `dsh plugin --profile web add dsh-postel`, then set `POSTEL_API_KEY` before starting dsh (research works without it). Guide: https://www.postel.app/deepseek-harness-social-media
- Zed: Settings > AI > MCP Servers > Add Server > Add Remote Server, with the server URL (Zed runs the OAuth sign-in).
- Goose: `goose configure` > Add Extension > Remote Extension (Streamable HTTP), with the server URL and an `Authorization: Bearer pstl_...` header.
- n8n AI Agent: an MCP Client Tool node with the server URL, transport HTTP Streamable and Bearer Auth with a `pstl_` key. Guide: https://www.postel.app/n8n-mcp-social-media
- Arcade: add Postel to your own account as a Remote MCP server (MCP servers dashboard > Add Server > Remote MCP, with the server URL), sign in with OAuth or add an `Authorization: Bearer ${secret:POSTEL_API_KEY}` header, then select its tools in an MCP Gateway.
- Agent skills (Claude Code, Codex, Cursor, OpenClaw and other agents that read Agent Skills): `npx skills add robinfaraj/postel-mcp --skill postel-writing` for the MCP tools, or `--skill postel-api` for agents without MCP (it calls the REST API with curl and a `POSTEL_API_KEY`).
- Install steps written for an agent to follow: https://github.com/robinfaraj/postel-mcp/blob/main/llms-install.md
- Any other MCP client: the server URL with OAuth or the bearer key. A client that only runs local servers can use `npx mcp-remote https://www.postel.app/api/mcp`.
- REST API: `https://www.postel.app/api/v1` with `Authorization: Bearer pstl_...`, 60 requests a minute per key. Create, write, schedule and publish posts, list connected channels, search the viral library and poll for events. Docs: https://www.postel.app/docs, reference: https://www.postel.app/docs/api, OpenAPI spec: https://www.postel.app/api/v1/openapi.json.
- Setup for every client, with config snippets and the full tool list: https://www.postel.app/postel-mcp-server
## Developer docs
- [Introduction](https://www.postel.app/docs): Use the Postel API to draft, schedule and publish posts, write in your own voice, and turn viral posts into your own.
- [API reference](https://www.postel.app/docs/api): Every endpoint of the Postel API v1, with its full reference and the guide that covers it.
- [Authentication](https://www.postel.app/docs/authentication): Send a Postel API key as a bearer token; the key decides which workspace every request acts for.
- [Changelog](https://www.postel.app/docs/changelog): Changes to the Postel API and these docs, newest first.
- [Errors](https://www.postel.app/docs/errors): Every error has the same JSON shape, a stable code to branch on, and a message you can show to people as is.
- [Idempotency](https://www.postel.app/docs/idempotency): Send an Idempotency-Key header so a retried request returns the first result instead of creating a second post or spending a second credit.
- [Pagination and cursors](https://www.postel.app/docs/pagination): Page through posts with cursor and nextCursor, and through events with since and before.
- [Quickstart](https://www.postel.app/docs/quickstart): Create an API key, check it, find a connected network, save a draft and schedule it, in under five minutes.
- [Rate limits](https://www.postel.app/docs/rate-limits): 60 requests a minute per key, 3 posts written at once per workspace, and 30 viral searches a minute per workspace.
- [Request IDs](https://www.postel.app/docs/request-ids): Every response carries an X-Request-Id header; log it and include it when you contact support.
- [Versioning and stability](https://www.postel.app/docs/versioning): v1 only grows; anything that would break your code ships as /v2.
- [Approvals and plans](https://www.postel.app/docs/guides/approvals-and-plans): What each plan allows through the API, and how posts wait for approval when the workspace asks for it.
- [Polling events for automations](https://www.postel.app/docs/guides/polling-events): Poll GET /v1/events to react when a post goes out, a post fails, a draft is ready or a post takes off in your niche.
- [Publish and schedule posts](https://www.postel.app/docs/guides/publish-and-schedule): Create drafts, threads and posts with media, then schedule them for a time or publish them now.
- [Viral posts to your take](https://www.postel.app/docs/guides/viral-takes): Find posts that took off in your niche, then have Postel write your own version as a draft.
- [Write in your voice](https://www.postel.app/docs/guides/write-in-your-voice): Send a prompt and Postel writes the post in your own voice and saves it as a draft.
- [Zapier, n8n and Make](https://www.postel.app/docs/integrations/automation-tools): Use Postel's apps for Zapier, n8n and Make, or call the API from any HTTP step.
- [MCP server](https://www.postel.app/docs/integrations/mcp): Connect Claude, ChatGPT, Cursor and other MCP clients to Postel so they can research, draft and schedule posts for you.
- [Get the key's account](https://www.postel.app/docs/api/account/get-me): The person and workspace the API key acts for, and whether the plan can schedule and publish. Integrations call this to test a connection and use label as its name. Free on every plan.
- [List channels](https://www.postel.app/docs/api/channels/list-channels): Every network Postel can post to, and whether this workspace has it connected. Connected channels come first, the order a dropdown should show. Use a channel's id as platform when you create a post.
- [List events](https://www.postel.app/docs/api/events/list-events): Polling triggers, newest first, one type at a time. Each event's id is unique per occurrence: dedupe on it. Poll every few minutes with since for only newer events; page back with before while pages come back full.
- [Create a post](https://www.postel.app/docs/api/posts/create-post): Saves a draft; with scheduledAt it's scheduled, with publishNow Postel publishes it within a minute (the response comes back at once with status scheduled; post.published or post.failed events say how it went). Scheduling and publishing need a paid plan; drafts work on every plan.
- [Get a post](https://www.postel.app/docs/api/posts/get-post): One post by id, with its status, publish time, link once published, and failure when the last publish failed.
- [List posts](https://www.postel.app/docs/api/posts/list-posts): The workspace's posts, newest first, 25 a page. Filter by status and platform. When nextCursor isn't null, pass it as cursor for the next page.
- [Publish a draft now](https://www.postel.app/docs/api/posts/publish-post): Needs a paid plan. Postel publishes the draft within a minute; the response comes back at once (202, status scheduled) and post.published or post.failed events say how it went. Publishing never runs inside the request, so a client that times out and retries can't post twice. Refused when the workspace needs approval (409 approval_required): schedule the post instead.
- [Schedule a draft](https://www.postel.app/docs/api/posts/schedule-post): Schedules a draft for scheduledAt. Needs a paid plan and a connected channel. When the workspace needs approval, the post waits for an owner or admin (status pending_approval, with a message). Only drafts can be scheduled: a scheduled post keeps its slot (409 not_a_draft), and two posts can't share the exact minute on one network (409 time_taken).
- [Get a viral post](https://www.postel.app/docs/api/viral/get-viral-post): One X post or video from the viral library, by its id.
- [List post formats](https://www.postel.app/docs/api/viral/list-viral-formats): The shapes viral posts keep using, each with the question Postel asks before writing one. Write one with POST /v1/viral/takes and your answer to its question.
- [Find viral posts](https://www.postel.app/docs/api/viral/list-viral-posts): Posts and videos that took off, from individual creators (brands, politicians and aggregator pages are kept out). Most viewed first. Search X posts by topic, or YouTube, TikTok and Instagram videos. Read-only and free on every plan; 30 searches a minute per workspace.
- [Write my take](https://www.postel.app/docs/api/writing/create-viral-take): Your own post in your voice from a viral X post or a format, saved as a draft per network (the Viral posts page's Use as template). Works on every plan. One AI credit per network; a network whose draft fails costs nothing. Takes 10 to 40 seconds, so give the request a 60-second timeout. Videos aren't supported yet (422 not_supported). Shares the 3-at-once writing slots with POST /v1/posts/generate. Send an Idempotency-Key only when it is unique per run.
- [Write a post in your voice](https://www.postel.app/docs/api/writing/generate-post): Postel writes a post from your prompt in your own voice and saves it as a draft. Uses 1 AI credit (none when the workspace uses its own AI key); works on every plan. Takes 5 to 30 seconds, so give the request a 60-second timeout. Up to 3 at a time per workspace; a fourth gets 429. Send an Idempotency-Key header so a retried step returns the first draft instead of writing (and charging) again.
## Pricing
- Starter: $19/month billed yearly, or $29 month to month. 300 AI credits a month, 1 seat.
- Pro: $29/month billed yearly, or $49 month to month. 1,000 AI credits a month, 3 seats. Includes For You drafts, Plan next week and bring your own AI key.
- Team: $79/month billed yearly, or $99 month to month. Unlimited AI credits, 5 seats. Includes For You drafts, Plan next week and bring your own AI key.
- Agency: $159/month billed yearly, or $199 month to month. Up to 30 brands, unlimited seats and AI credits. Includes For You drafts, Plan next week and bring your own AI key. Set up with the team.
- Starter and Pro start with a 7-day trial for $1.
- Every paid plan includes AI writing in the user's voice, the viral post library and post templates, the knowledge base, the MCP server for Claude, ChatGPT and other AI assistants, and scheduling and publishing to X, LinkedIn, Bluesky, Mastodon, YouTube and TikTok.
- AI credits: a chat turn costs 2, a drafted post 1. At 0 credits Postel keeps working in Lite mode. Extra credit packs never expire.
- There is no free plan.
- Current prices: https://www.postel.app/#pricing
## Product pages
- [What is Postel](https://www.postel.app/what-is-postel): overview of the product, features and pricing
- [X (Twitter) post scheduler](https://www.postel.app/twitter-post-scheduler): how to schedule a tweet on X, and scheduling tweets, threads and X Community posts into posting slots
- [LinkedIn post scheduler](https://www.postel.app/linkedin-post-scheduler): how to schedule a LinkedIn post, LinkedIn's built-in scheduler vs Postel, formats, limits and first comments
- [Instagram scheduler (coming soon)](https://www.postel.app/instagram-scheduler): built and submitted to Meta's App Review, not available yet; what it will do, an email on launch day, and the networks Postel posts to today
- [Threads scheduler (coming soon)](https://www.postel.app/threads-scheduler): built and submitted to Meta's App Review, not available yet; what it will do, an email on launch day, and the networks Postel posts to today
- [YouTube scheduler](https://www.postel.app/youtube-scheduler): what Postel posts to YouTube, from its calendar and from Claude
- [LinkedIn company Pages (coming soon)](https://www.postel.app/linkedin-company-page-scheduler): built and submitted to LinkedIn's review of Postel's Pages app, not available yet; what it will do, an email on launch day, and the networks Postel posts to today
- [Bluesky scheduler](https://www.postel.app/bluesky-scheduler): scheduling Bluesky posts and threads, setup with an app password, limits and a comparison
- [Cross-posting tool](https://www.postel.app/cross-posting-tool): one post to X, LinkedIn, Bluesky, Mastodon, YouTube and TikTok, with a version fitted to each network
- [AI content calendar](https://www.postel.app/ai-content-calendar): Plan next week, which plans and writes a week of X and LinkedIn post