# mcp-x-publisher

MCP (Model Context Protocol) server for posting single tweets, threads, and saving drafts to X (Twitter) automatically using Playwright.

## Installation / Usage with MCP Clients

Add the following JSON configuration to your MCP client (Claude Desktop, Cursor, Kiro, Claude Code, etc.):

```json
{
  "mcpServers": {
    "x-publisher": {
      "command": "npx",
      "args": ["-y", "mcp-x-publisher"],
      "env": {
        "X_AUTH_TOKEN": "YOUR_AUTH_TOKEN_HERE",
        "X_CT0": "YOUR_CT0_HERE"
      }
    }
  }
}
```

## Features

- `x_publish_post`: Publish single post to X (text and optional image).
- `x_publish_thread`: Publish multi-tweet thread to X sequentially.
- `x_save_draft`: Save a tweet to X online draft box.

## Authentication

Authentication cookies can be provided via environment variables:
- `X_AUTH_TOKEN`: `auth_token` cookie value from your X login session.
- `X_CT0`: `ct0` cookie value from your X login session.

Alternatively, if no environment variables are specified, it will attempt to load saved cookies from `~/.config/baoyu-skills/x-to-markdown/cookies.json` (Linux/macOS) or `%APPDATA%\baoyu-skills\x-to-markdown\cookies.json` (Windows).

## License

MIT