# Twinpost 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
Server card: https://twinpo.st/.well-known/mcp/server-card.json

## Connect

Sign-in is browser OAuth with your Twinpost account. There is no API key.

### Claude

In Claude, open Settings, then Connectors, add a custom connector and paste the server URL. 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:

```json
{
  "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 https://twinpo.st/mcp as a remote (streamable HTTP) server and finish the sign-in in your browser.

## Tools

| Tool | Access | What it does |
| --- | --- | --- |
| whoami | read | Shows which Twinpost account and workspace the app is using. |
| list_accounts | read | Lists your connected accounts: X and the networks you mirror to. |
| list_mirrors | read | Lists your mirrors, whether each is on, and its targets. |
| list_mirror_activity | read | Shows recent mirrored posts and where each one landed or failed. |
| preview_crosspost | read | Shows how a post would look on each network, with nothing sent. |
| draft_crosspost | draft | Saves a crosspost as a draft. Never publishes. |
| list_drafts | read | Lists your saved drafts. |
| list_scheduled_posts | read | Lists posts that are scheduled to go out. |
| publish_draft | publish | Publishes or schedules a draft. Asks for your confirm first. |
| pause_mirror | pause or resume | Pauses a mirror, or resumes it. Resuming asks for your confirm. |
| retry_mirror_post | publish | Publishes 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 https://twinpo.st/app/apps, find the app and press Disconnect.

## FAQ

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