x-toolkit

Send this page to your agent.

It’s written for agents. Give Claude, ChatGPT, Codex or Cursor this link and it adds x-toolkit to itself, then reads any X link you send it: Articles, video transcripts and posts.

x-toolkit.app/agents

Same page as plain Markdown: x-toolkit.app/agents.md

For the agent: 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. Follow these steps.

01Add 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. You’ll get these tools, each taking a post link (x.com/name/status/<id>) or the numeric post ID:

  • read_x_articlean X Article as Markdown, images in place; lang translates it
  • get_x_video_transcripta video’s transcript as md, txt, srt or vtt
  • transcribe_x_videotranscribes a video X has no captions for, one part per call
  • read_x_posta single post: author, text, quote, images, counts

02Or 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:

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

03Confirm 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.