Skip to main content
Glama
danishaali9

X Reader MCP

by danishaali9
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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.

  • 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.

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 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.<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/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

Tool

Input

Returns

read_x_post

url: post URL (x.com, twitter.com, mobile, fxtwitter...) or numeric ID

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 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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • weixin-articles-mcp

    jj-cheng25
    A
    license
    A
    quality
    D
    maintenance
    Read 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).
    1
    12
    MIT

  • X Reader MCP

    skymao2021
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables 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

  • wechat-mcp

    lfc1402046
    A
    license
    A
    quality
    C
    maintenance
    Enables 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.
    2
    1
    MIT