X Reader Mcp

io.github.danishaali9Published by GitHub account danishaali9v1.0.0Updated Oct 29, 2026

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

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingMedia & Design

Overview

AI-generated overview

Remote MCP server that reads public X (Twitter) posts and full X Articles and returns them as clean Markdown, with no X API key.

What you can do
  • Read a public X post from a link or numeric ID and get Markdown with author, date, engagement, text, images, video links, polls and quoted posts
  • Return the complete body of long-form X Articles, rendered from X's article format into headings, lists, links, code blocks and media
  • Fetch the same content through a plain web reader or a Markdown endpoint outside the MCP tool
When to use it
Useful when you often paste x.com or twitter.com post links into chat and want the assistant to read the actual text, especially long-form X Articles whose body other tools only link to. It is a small, read-only convenience for public posts, not a research or archive tool.
Requirements
A remote MCP endpoint added as a custom connector or remote server in the client; no sign-in, API key, headers or environment variables are needed. The server itself depends on the free community FxTwitter API and runs on Cloudflare Workers.
Before you install
Only public posts are readable; private accounts, deleted posts and bare article links fail, and replies and full multi-post threads are not returned. Post content is fetched through the third-party FxTwitter service, so links you submit go to that service. The endpoint is public and rate-limited by Cloudflare's free plan. The README includes a donation link; nothing is charged by the tool itself.

Installation

In SourceWeft

  1. Open X Reader Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.danishaali9%2Fx-reader-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "x-reader": {
      "type": "http",
      "url": "https://x-reader-mcp.roastedrants.workers.dev/mcp"
    }
  }
}

README

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

markdown
# 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 Claude3. Paste any post link

Deploy (about 5 minutes)

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

bash
npm installnpx wrangler login      # opens the browser oncenpm 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:

bash
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

bash
npm test          # offline tests with a sample article (no network)npm run dev       # local server at http://localhost:8787npm 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

Source: README.md at commit 2f39d70

Tools

1

read_x_post

Read X post or article

Reads a public X (Twitter) post and returns it as Markdown: author, date, engagement, text, images, video links, polls, quoted post, and the FULL body of X Articles (long-form posts). Use it whenever the user shares an x.com or twitter.com status link. Does not return replies or full multi-post threads.

Parametersurlrequired

Version history

1
  1. v1.0.0LatestOct 29, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts