English Français العربية

io.github.danishaali9/x-reader-mcp

Official registry Productivity

Read public X posts and full X Articles as clean Markdown. Free, no X API key.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http x-reader-mcp 'https://x-reader-mcp.roastedrants.workers.dev/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "x-reader-mcp": {
            "type": "http",
            "url": "https://x-reader-mcp.roastedrants.workers.dev/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. X Reader MCP
  2. Use it now (no install)
  3. Example output
  4. Deploy (about 5 minutes)
  5. Connect it
  6. Tool
  7. Limits (honest list)
  8. Develop
  9. Credits

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**](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

ToolInputReturns
read_x_posturl: post URL (x.com, twitter.com, mobile, fxtwitter...) or numeric IDMarkdown 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

Frequently asked questions

What is io.github.danishaali9/x-reader-mcp?

Read public X posts and full X Articles as clean Markdown. Free, no X API key.

How do I install io.github.danishaali9/x-reader-mcp?

It runs as a remote server. In Claude Code: claude mcp add --transport http x-reader-mcp 'https://x-reader-mcp.roastedrants.workers.dev/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.danishaali9/x-reader-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.danishaali9/x-reader-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.danishaali9/x-reader-mcp?

It is published by danishaali9. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.