X Reader MCP

X Reader MCP

Let Claude (or ChatGPT, Cursor, any MCP client) read public X posts and full X Articles. Paste a post link in chat and the AI gets clean Markdown: title, author, date, engagement, text, images, best-quality video links, polls, quoted posts, and the entire long-form article body.

Connector URL: https://x-reader-mcp.roastedrants.workers.dev/mcp (add it as a custom connector, no sign-in needed)

• Free: uses the public FxTwitter API, no X API key
• Tiny: zero runtime dependencies, about 17 KB, runs on Cloudflare Workers' free plan
• Read-only: it only reads public posts

Why I built it: other tweet MCPs returned only the article *link* for X Articles, never the text.

This one renders X's article format (Draft.js) into proper Markdown with headings, lists,

bold/italic, links, code blocks, images and videos.

If this saves you time, you can buy me a coffee ☕

Use it now (no install)

• Web reader: https://x-reader-mcp.roastedrants.workers.dev Paste a post link, preview it, copy or download the Markdown.
• Claude / ChatGPT connector: add https://x-reader-mcp.roastedrants.workers.dev/mcp as a custom connector (no sign-in needed), then paste any post link in chat.

Want your own copy? Deploy it yourself below.

---

Example output

# I built a free MCP that lets Claude read X Articles

Author: roastedrants (@roastedrants), 1,234 followers Posted: 2026-10-21 15:08 UTC Engagement: 150 likes, 12 reposts, 5 replies, 2 quotes, 1,300 bookmarks, 45,678 views Type: X Article

---

Why TweetSave was not enough

It only returned the article link, never the body.

1. Deploy it on Cloudflare
2. Add the connector in Claude
3. Paste any post link

Deploy (about 5 minutes)

You need Node.js 22.18 or newer and a free Cloudflare account.

npm install

npx wrangler login # opens the browser once npm run deploy

Wrangler prints your URL, something like https://x-reader-mcp. .workers.dev.

Quick check in any browser (phone works too):

https://x-reader-mcp.<your-subdomain>.workers.dev/read?url=https://x.com/<user>/status/<id>

Connect it

Your MCP endpoint is the URL above plus /mcp.

Claude app (web, desktop, mobile): Settings → Connectors → Add custom connector → paste the /mcp URL. Then enable it in a chat and paste any post link.

Claude Code:

claude mcp add --transport http x-reader https://x-reader-mcp.<your-subdomain>.workers.dev/mcp

ChatGPT: Settings → Apps & Connectors (Developer mode) → create a connector with the /mcp URL, no auth.

Cursor / other clients: add a remote server with "url": "https://.../mcp".

Tool

Other endpoints: GET / is the web reader, GET /read?url=... returns plain Markdown.

Limits (honest list)

• Public posts only. Private accounts and deleted posts return a clear error.
• No replies and no full multi-post threads (FxTwitter only returns the single post).
• Bare article links (x.com/i/article/...) can't be resolved; paste the post that shares the article.
• Depends on FxTwitter, a free community service. If it is down, the tool says so.
• The endpoint is public. Cloudflare's free plan allows 100,000 requests a day, plenty for personal use.

Develop

npm test          # offline tests with a sample article (no network)

npm run dev # local server at http://localhost:8787 npm run typecheck

Code map: src/index.ts (MCP over Streamable HTTP, stateless), src/fxtwitter.ts (URL parsing and fetch), src/markdown.ts (post and Draft.js article to Markdown), src/page.ts (web reader page).

Credits

Data comes from FxTwitter / FxEmbed. Please be kind to their servers. Not affiliated with X Corp.

Made by @roastedrants. Buy me a coffee ☕

MIT License