# x-to-markdown

x-to-markdown turns X articles, posts, and threads into structured Markdown. Use it when an agent cannot read X links on its own.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 423 installs
- Author: xtomd
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/xtomd/x-to-markdown
- Updated: 2026-03-17
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/x-to-markdown

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

## Requirements
- Remote server: `https://x-to-markdown--xtomd.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http x-to-markdown https://x-to-markdown--xtomd.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add x-to-markdown --url https://x-to-markdown--xtomd.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "x-to-markdown": {
            "url": "https://x-to-markdown--xtomd.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "x-to-markdown": {
            "type": "http",
            "url": "https://x-to-markdown--xtomd.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http x-to-markdown https://x-to-markdown--xtomd.run.tools
```

## When to use it
- 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
- 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_markdown` to extract the full text from this X post.

## Similar
- [baoyu-danger-x-to-markdown](https://affpapa.org/en/nevibecode/skills/baoyu-danger-x-to-markdown.md) — skill · 28600 installs
- [qiaomu-markdown-proxy](https://affpapa.org/en/nevibecode/skills/qiaomu-markdown-proxy.md) — skill · 663 installs
- [baoyu-url-to-markdown](https://affpapa.org/en/nevibecode/skills/baoyu-url-to-markdown.md) — skill · 31000 installs
- [wechat-article-to-markdown](https://affpapa.org/en/nevibecode/skills/wechat-article-to-markdown.md) — skill · 939 installs
- [web-to-markdown](https://affpapa.org/en/nevibecode/skills/web-to-markdown.md) — skill · 796 installs
- [Web to Markdown](https://affpapa.org/en/nevibecode/skills/jackwener-web-to-markdown.md) — skill · ★ 239 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
