Docs · MCP server

Crosspost from Claude, ChatGPT and Cursor.

The Twinpost MCP server lets an AI app work with your Twinpost account. Ask it to check your mirrors, see what happened to your last posts, or draft a crosspost for your networks. It can only publish when you say yes in the chat.

Server URL

https://twinpo.st/mcp

Machine-readable details: server card (https://twinpo.st/.well-known/mcp/server-card.json). This page as markdown: /docs/mcp.md.

Connect

Sign-in is browser OAuth with your Twinpost account. There is no API key. You approve the app once and can disconnect it any time.

Claude

In Claude, open Settings, then Connectors, add a custom connector and paste the server URL. Or from the command line:

claude mcp add --transport http twinpost https://twinpo.st/mcp

ChatGPT

Turn on developer mode in ChatGPT settings, add a connector, paste the server URL and sign in with Twinpost when asked.

Cursor

Add this to your MCP settings:

{
  "mcpServers": {
    "twinpost": {
      "url": "https://twinpo.st/mcp"
    }
  }
}

VS Code

Run MCP: Add Server, choose HTTP, and paste the server URL.

Any other MCP client

Point it at the server URL as a remote (streamable HTTP) server and finish the sign-in in your browser.

Tools

ToolAccessWhat it does
whoamireadShows which Twinpost account and workspace the app is using.
list_accountsreadLists your connected accounts: X and the networks you mirror to.
list_mirrorsreadLists your mirrors, whether each is on, and its targets.
list_mirror_activityreadShows recent mirrored posts and where each one landed or failed.
preview_crosspostreadShows how a post would look on each network, with nothing sent.
draft_crosspostdraftSaves a crosspost as a draft. Never publishes.
list_draftsreadLists your saved drafts.
list_scheduled_postsreadLists posts that are scheduled to go out.
publish_draftpublishPublishes or schedules a draft. Asks for your confirm first.
pause_mirrorpause or resumePauses a mirror, or resumes it. Resuming asks for your confirm.
retry_mirror_postpublishPublishes again a mirrored post that failed. Asks for your confirm first.

Safety

  • Drafts never publish on their own.
  • Anything that reaches an audience needs confirm: true. The AI only sends it after you say yes.
  • Twinpost plans post through your X mirror. Publishing a draft directly needs a plan that includes direct posts, and otherwise returns a clear plan message.

Disconnect

Open Connected apps in Twinpost, find the app and press Disconnect. It loses access straight away.

Questions

Is it free to connect?

Connecting is free. What the AI can do follows your Twinpost plan. Reading, previews and drafts work on any plan. Publishing a draft directly needs a plan that includes direct posts, and otherwise you get a clear message about the plan.

Which apps work with it?

Any app that supports remote MCP servers with browser sign-in: Claude, ChatGPT, Cursor, VS Code and other MCP clients. Use the URL https://twinpo.st/mcp.

Can the AI post without me?

No. Drafts never publish on their own. Anything that reaches an audience needs confirm: true, which the AI only sends after you say yes in the chat.

How do I disconnect an app?

Open Connected apps in Twinpost, find the app and press Disconnect. It loses access straight away.

Does the AI see my password?

No. You sign in on twinpo.st in your own browser and approve the app. The app never sees your password and you do not create an API key.

Mirror your X posts, and let your AI help.

Free for X and one network. No card.

Continue with X