Skip to content
MCP server

X Reader MCP

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

Install
Pricing
Free
Platforms
Web, API, self-hosted
Runs
Remotely
Version
1.0.0
Listing updated
2 days ago

About X Reader MCP

X Reader MCP is a free MCP server for web search and scraping. It runs as a hosted remote server, so there is nothing to install locally.

Most tweet readers return only the link to an X Article. This one renders the article's own long-form format into Markdown with headings, lists, bold and italic, links, code blocks, images and videos, and for ordinary posts it returns the author, date, engagement counts, text, media, polls and quoted posts.

There is one tool, read_x_post, which accepts an x.com or twitter.com link, mobile and fxtwitter variants, or a numeric ID. A web page at the same address lets you paste a link and copy or download the result. Data comes from the free FxTwitter API, and the code is a tiny Cloudflare Worker you can deploy yourself on the free plan.

The README is open about limits: public posts only, no replies or full threads, bare article links cannot be resolved (paste the post that shares it), and it depends on FxTwitter being up. The public endpoint is shared, so personal use is the intended scale.

Install

Run in a terminal

claude mcp add --transport http x-reader-mcp https://x-reader-mcp.roastedrants.workers.dev/mcp

Add to Settings → Connectors → Add custom connector

https://x-reader-mcp.roastedrants.workers.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "x-reader-mcp": {
      "url": "https://x-reader-mcp.roastedrants.workers.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "x-reader-mcp": {
      "serverUrl": "https://x-reader-mcp.roastedrants.workers.dev/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

read_x_post
Read an X post by URL or ID and return Markdown, including the full article for X Articles.

What it does

Full X Articles
Renders the long-form article body, not just its link.
Post details
Author, date, engagement, text, images, video links, polls and quotes.
No API key
Uses the public FxTwitter API.
Web reader
Paste a link and copy or download the Markdown.
Self-deployable
Small Cloudflare Worker you can run on the free plan.
Clear errors
Private or deleted posts return a clear error.

Good for

  • Give an assistant the text of a shared X Article
  • Archive a post and its media links as Markdown
  • Summarise a post with its polls and quoted post
  • Check a link's content without opening X

Pricing

Free

Free to use; the README says it runs on Cloudflare's free plan

Prices change. Check x-reader-mcp.roastedrants.workers.dev before you buy.

X Reader MCP FAQ

Do I need an X API key?

No. It uses the public FxTwitter API.

Does it read threads or replies?

No. Only the single post is returned.

Can it read private accounts?

No. Public posts only.

Can I host my own?

Yes. Deploy to Cloudflare Workers with Wrangler; Node.js 22.18 or newer is needed.

Is X Reader MCP free?

Yes. X Reader MCP is free to use.

How do I add X Reader MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http x-reader-mcp https://x-reader-mcp.roastedrants.workers.dev/mcp

What are the best alternatives to X Reader MCP?

The closest alternatives to X Reader MCP are Scrapling MCP Server, Firecrawl MCP Server, SearXNG Search, NeuralVerge and AI-Powered directory.

Alternatives to X Reader MCP

  1. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  2. MCP server that lets AI agents search, scrape and interact with web pages

    • 3 tools
    • Remote
    • Freemium
    • 7.8K GitHub stars
    • Web search and scraping
  3. SearXNG Search

    MCP server

    MCP server for web search and page reading through a SearXNG instance

    Runs locally
    • 3 tools
    • Open source
    • 1.4K GitHub stars
    • Web search and scraping
  4. NeuralVerge

    MCP server

    Structured, source-tagged business and people data from 300+ sources for agents

    • 200 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Web search and scraping
  5. Search AI tools, agents and MCP servers and get install configs from inside your AI assistant.

    • 4 tools
    • Remote
    • Free
    • Developer tools
  6. Hosted MCP server that returns any Shopify store's products, prices and stock

    Not checked yet
    • 4 tools
    • Remote
    • Paid
    • E-commerce