x-to-markdown — Claude Code MCP server: setup
x-to-markdown turns X articles, posts, and threads into structured Markdown. Use it when an agent cannot read X links on its own.
no license 423 installs updated 2026-03-17
claude mcp add --transport http x-to-markdown https://x-to-markdown--xtomd.run.toolsWhat x-to-markdown does
x-to-markdown exposes convert_x_to_markdown, an MCP tool that accepts an X or Twitter URL and returns readable Markdown. The result keeps the post’s formatting and includes its full text together with author, date, and engagement details. It handles long-form X Articles, regular posts, note posts, and threads.
The connection uses a hosted MCP endpoint over HTTP. No sign-in or API key is needed, so there is no X credential setup before use. Add the server to Claude Code with one command, then ask the agent to process an X link when its content is needed in the project context.
What it helps with
- read an X article as Markdown
- turn a post or thread into structured text
- give an agent the contents of an X link
- retain formatting from a long-form post
Example prompts for the agent
- Read the X link and return its contents as Markdown using
convert_x_to_markdown. - Convert this X thread into structured text with the author, date, and engagement details.
- Use
convert_x_to_markdownto extract the full text from this X post.
How to install x-to-markdown
Platform CLI: remote server
claude mcp add --transport http x-to-markdown https://x-to-markdown--xtomd.run.toolsPlatform CLI: remote server
codex mcp add x-to-markdown --url https://x-to-markdown--xtomd.run.toolsConfig file
{
"mcpServers": {
"x-to-markdown": {
"url": "https://x-to-markdown--xtomd.run.tools"
}
}
}Config file
{
"servers": {
"x-to-markdown": {
"type": "http",
"url": "https://x-to-markdown--xtomd.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http x-to-markdown https://x-to-markdown--xtomd.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about x-to-markdown
How do I install x-to-markdown in Claude Code?
Run claude mcp add --transport http x-to-markdown https://x-to-markdown--xtomd.run.tools.
What does x-to-markdown do?
It converts X and Twitter links into structured Markdown for an agent. The server supports articles, regular posts, note posts, and threads, while returning content details such as the author and date.
Does x-to-markdown require an API key?
No. The server works without authentication and accepts the link through convert_x_to_markdown.