# X Reader MCP

> X Reader MCP is a free MCP server for web search and scraping. Read public X posts and full X Articles as clean Markdown, with no X API key. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API, self-hosted
- **Website:** https://x-reader-mcp.roastedrants.workers.dev
- **Repository:** https://github.com/danishaali9/x-reader-mcp
- **MCP Registry name:** io.github.danishaali9/x-reader-mcp
- **Categories:** web search and scraping
- **Listing updated:** 2026-11-15

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://x-reader-mcp.roastedrants.workers.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "x-reader-mcp": {
      "url": "https://x-reader-mcp.roastedrants.workers.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

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

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [AI-Powered directory](https://ai-powered.com/mcp/ai-powered-directory): AI-Powered directory is a free MCP server for developer tools.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [Chanroll: YouTube Channel Video Scraper (Official API)](https://ai-powered.com/mcp/chanroll-youtube-channel-video-scraper-official-api): Chanroll: YouTube Channel Video Scraper (Official API) is a paid MCP server for design and media.
- [Vidvett: YouTube Video Details Scraper (Official API)](https://ai-powered.com/mcp/vidvett-youtube-video-details-scraper-official-api): Vidvett: YouTube Video Details Scraper (Official API) is a paid MCP server for design and media.

---
Source: https://ai-powered.com/mcp/x-reader-mcp
