# Set up x-toolkit

You’re an agent, and the user wants you to read X (Twitter) with x-toolkit. X hides Articles behind sign-in and has no text for videos; x-toolkit turns public posts into text with no X account and no API key.

## 1. Add the MCP server, if you can

The server is `https://x-toolkit.app/mcp` (remote, Streamable HTTP, no auth). Use the line for the client you run in:

- **Claude Code**: Run:

  ```
  claude mcp add --transport http x-toolkit https://x-toolkit.app/mcp
  ```
- **Codex**: Run:

  ```
  codex mcp add x-toolkit --url https://x-toolkit.app/mcp
  ```
- **Gemini CLI**: Run:

  ```
  gemini mcp add --transport http x-toolkit https://x-toolkit.app/mcp
  ```
- **VS Code**: Run:

  ```
  code --add-mcp '{"name":"x-toolkit","type":"http","url":"https://x-toolkit.app/mcp"}'
  ```
- **Cursor**: Add this to ~/.cursor/mcp.json, merged with any servers already there:

  ```
  { "mcpServers": { "x-toolkit": { "url": "https://x-toolkit.app/mcp" } } }
  ```
- **Claude and ChatGPT apps**: These can’t be changed from a chat. Ask the user to add a custom connector with the URL https://x-toolkit.app/mcp and no authentication (in ChatGPT this needs developer mode).
- **Anything else**: Add https://x-toolkit.app/mcp as a remote MCP server (Streamable HTTP). No key, no account, no OAuth.

Most clients only load a new server in a new session, so tell the user to restart or reload you.

It gives you these tools:

- `read_x_article`: an X Article as Markdown, images in place; lang translates it
- `get_x_video_transcript`: a video’s transcript as md, txt, srt or vtt
- `transcribe_x_video`: transcribes a video X has no captions for, one part per call
- `read_x_post`: a single post: author, text, quote, images, counts

All of them take a post link (x.com/name/status/<id>) or the numeric post ID.

## 2. Or use the plain links

If you can’t add MCP servers but can fetch URLs, take the numeric ID from a post link and fetch:

- X Article as Markdown: `https://x-toolkit.app/api/x-article/<postId>.md`. Add ?lang=en (or es, pt, fr, de, it, ja, ko, zh) to translate. .json for structured data.
- X video transcript: `https://x-toolkit.app/api/x-video/<postId>.md`. Also .txt, .srt, .vtt and .json. If the video has no captions it returns 404 with a link to transcribe it once.

## 3. Confirm it’s ready

Tell the user which one you set up, and that they can paste X links to you now. Only public posts work.