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/mcpas a custom connector (no sign-in needed), then paste any post link in chat.
Want your own copy? Deploy it yourself below.
Related MCP server: Scrapling MCP Server
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**](https://workers.cloudflare.com)
2. Add the connector in Claude
3. Paste any post linkDeploy (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 deployWrangler prints your URL, something like https://x-reader-mcp.<your-subdomain>.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/mcpChatGPT: 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
Tool | Input | Returns |
|
| Markdown of the post, and the full article if it's an X Article |
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 typecheckCode 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
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read public X (Twitter) posts, threads and X Articles as clean Markdown. Read-only, no auth.
Read public X posts with no account or key: Articles as Markdown, video transcripts, posts.
Read any public web page as clean Markdown for LLMs. Respects robots.txt. Free tier; x402 paid API.
Read any public web page as clean Markdown for LLMs, with its metadata. Paid per call, x402.
Related MCP Servers
- AlicenseAqualityDmaintenanceRead WeChat (微信) Official Account articles with native multimodal output — body, images, and video keyframes returned as MCP content blocks. Handles all three embed types: Tencent Video, WeChat-native, and Channels (视频号 metadata via public API).113MIT
- FlicenseBqualityBmaintenanceEnables MCP-compatible AI clients to extract live web content and convert it into structured Markdown for LLM ingestion, RAG pipelines, and agentic workflows.16-
- AlicenseNot gradedqualityCmaintenanceEnables reading public X/Twitter posts by URL or numeric ID and returning original structured data, including articles, quoted posts, and media fields, without requiring an X API key.MIT
- AlicenseAqualityCmaintenanceEnables MCP-compatible AI clients to read WeChat Official Account articles directly by fetching and converting them into clean structured Markdown, including single and batch article retrieval.21MIT