# Is there an X (Twitter) MCP server for Claude that reads live posts, replies and followers?

> Give Claude, Claude Code or Cursor live X data through one MCP server: post search, timelines, replies, followers, lists, communities and trends. Setup, prompts and a priced job.

Canonical page: https://okdata.online/answers/x-twitter-mcp-server-claude/

**Short answer: **Yes, two kinds. X's own MCP server runs on an X developer app that you create and set up. To only read public X data, add okdata's MCP server (https://api.okdata.online/mcp) to Claude as a custom connector and sign in, with no X account: Claude can then search posts ($0.002 for about 20 posts), read an account's timeline, the replies under a post, followers, lists, communities and trends. Every post that mentioned a brand this week plus the replies under the 20 most-liked costs about $0.10.

A marketer at a small software company opens Claude on Monday and asks: what did people on X say about us last week, and what are the replies under the posts that took off? To answer from real posts instead of memory, Claude needs a tool that reads X. An MCP server is that tool. You add one URL, and Claude can search X, open an account's timeline and read the replies, then answer with links.

## Two servers, two jobs

**X's own server** is at `https://api.x.com/mcp`. Its docs list tools for posts, search, users, bookmarks, news and trends, and Articles. To use it you create an X app: with OAuth 2.0 and X's `xurl` bridge it can act as you (bookmarks, publishing Articles); with an app-only Bearer token it is read-only. When an app is not in the right X package, X's fix is to move it to **Pay-per-use** and **Production**, and X's pricing page lists a post read at $0.005 (both read on 17 November 2026). Choose it when Claude needs to act on your own account.

**okdata's server** only reads public data. There is no X account, X app or token to manage: in Claude you sign in to okdata once. The same URL also gives Claude TikTok, YouTube and the other platforms; the [TikTok, YouTube and X MCP answer](/answers/tiktok-youtube-x-mcp-server/) covers that side.

## What Claude can read on X

| Ask Claude for | Endpoint | Price |
|---|---|---|
| Posts matching a search, with X's operators | [X post search](/apis/x/posts/search/) | $0.002 a page of about 20 |
| An account's timeline, newest first | [X account posts](/apis/x/users/posts/list/) | $0.002 a page of about 20 |
| Posts that @mention an account | [X account mentions](/apis/x/users/mentions/list/) | $0.0003 a post, 20 a page |
| The replies under a post | [X post replies](/apis/x/posts/replies/list/) | $0.002 a page of about 35 |
| An account's followers, newest first | [X account followers](/apis/x/users/followers/list/) | $0.0001 an account, 200 a page |
| A list's timeline | [X list posts](/apis/x/lists/posts/list/) | $0.002 a page of about 100 |
| A community's posts, newest first | [X community posts](/apis/x/communities/posts/list/) | $0.0003 a post, 20 a page |
| Trends, worldwide or for one country | [X trending topics](/apis/x/trends/list/) | $0.009 for 30 topics |

Post detail, whole threads, quote posts, account profiles, account search, who an account follows, and list and community members are there too; see [all X endpoints](/apis/x/). Accounts go by handle. Posts, lists and communities go by the number in their link: the digits after `/status/`, `/i/lists/` or `/i/communities/`.

## Connect it

**Claude on claude.ai or the desktop app.** Go to Customize → Connectors → Add → Add custom connector. Name it `okdata`, enter `https://api.okdata.online/mcp` as the URL and set Authentication to **Sign in now**; Claude picks No sign-in by default, so change it. Click Add, sign in to okdata and allow. Claude gets a key of its own, which can spend at most $5 a month unless you change it in the console. In a chat, open + → Connectors and switch okdata on. On Team and Enterprise plans an Owner adds the connector first. The full steps are on [Claude setup](/integrations/claude/); the config-file route for the desktop app is on [Claude Desktop](/integrations/claude-desktop/).

**Claude Code.** Keep your key in `OKDATA_API_KEY` and run this once (with single quotes, so the key itself never lands in a settings file). More on [Claude Code setup](/integrations/claude-code/).

```bash
claude mcp add --transport http --scope user okdata https://api.okdata.online/mcp \
  --header 'Authorization: Bearer ${OKDATA_API_KEY}'
```

**Cursor.** Add this to `~/.cursor/mcp.json`, quit Cursor completely and reopen it ([Cursor setup](/integrations/cursor/)):

```json
{
  "mcpServers": {
    "okdata": {
      "url": "https://api.okdata.online/mcp",
      "headers": { "Authorization": "Bearer ${env:OKDATA_API_KEY}" }
    }
  }
}
```

To check it, ask "What is my okdata balance?" A number in the answer means the connection works.

## Things to ask Claude

- "Search X for posts that mention Acme or @acme since Monday, latest first, ten pages at most. Read the replies under the 20 most-liked and sort what people say into praise, complaints and questions, with links."
- "Read @competitor's last 100 posts and tell me which topics drew the most replies."
- "List the newest 400 followers of @ourbrand who have more than 10,000 followers themselves."
- "Summarise this week in the list x.com/i/lists/84839422."
- "What is the X community 1539231166569410560 talking about today?"
- "What is trending on X in the US right now, and does any of it touch our category?"

## The brand week, priced

| Step | Calls | Cost |
|---|---|---|
| Posts that mention the brand this week, latest first, 10 pages (about 200 posts) | 10 | $0.02 |
| Replies under the 20 most-liked, 2 pages each (up to about 70 a post) | 40 | $0.08 |
| **The brand week** | 50 | $0.10 |
| Also: the newest 1,000 followers of your account | 5 | $0.10 |
| Also: an industry list, one page a day for a week | 7 | $0.014 |
| Also: the 100 newest posts in one community | 5 | $0.03 |
| Also: US trends once a day for a week | 7 | $0.063 |

You pay per call, with no subscription. Each endpoint has its own price, all on the [pricing page](/pricing/), in US dollars. A new key comes with $0.10 of credit. Claude can read an endpoint's price before it calls it, so ask for an estimate before a long run.

## The same job in Python

For a scheduled report outside Claude, the brand week is a short script:

```python
import os, requests
from datetime import date, timedelta

API = "https://api.okdata.online"
H = {"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"}

def pages(path, max_pages, **params):
    cursor = None
    for _ in range(max_pages):
        query = {**params, **({"cursor": cursor} if cursor else {})}
        body = requests.get(API + path, headers=H, params=query, timeout=60).json()
        if body["code"] != "ok":
            raise RuntimeError(f"{body['code']}: {body['message']}")
        yield from body["data"]["items"]
        if not body["page"]["has_more"]:
            return
        cursor = body["page"]["next_cursor"]

since = (date.today() - timedelta(days=7)).isoformat()
posts = list(pages("/v1/x/posts/search", 10, query=f"(acme OR @acme) -from:acme since:{since}",
                   sort="latest", fields="id,url,text,author.username,metrics.likes,metrics.comments"))
top = sorted(posts, key=lambda p: p["metrics"]["likes"] or 0, reverse=True)[:20]
replies = {p["url"]: list(pages("/v1/x/posts/replies/list", 2, id=p["id"],
                                fields="text,author.username,metrics.likes"))
           for p in top if p["metrics"]["comments"]}
print(len(posts), "posts;", sum(map(len, replies.values())), "replies under the top 20")
```

Posts without replies are skipped, so a quiet week makes fewer calls than the table.

## Things that trip people up

- **Put a page cap in the prompt.** "Ten pages at most" keeps a viral week from turning into hundreds of calls.
- **Big accounts have long follower lists.** Followers come 200 a page, newest first, so 100,000 followers are 500 pages ($10.00). Ask for the newest few hundred unless you need them all.
- **Replies come in X's order**, not by time. Ask Claude to sort by `published_at` if you want a timeline.
- **Lists and communities need their number.** Paste the link; Claude reads the ID from it.
- **Only public data.** Protected accounts never appear, and nothing posts, likes or follows for you.
- **Strangers wrote the text.** Tell Claude to treat posts and replies as data, never as instructions.
- **The X endpoints are in preview.** Field names may still change.

## Other routes

For a single post or account, opening x.com yourself is quicker. Logged-in browser tools and open-source scrapers cost nothing but run on X accounts or browser cookies you supply, and they stop when the session expires or the account gets limited. X's own server is the right pick when Claude must act as you. For the query syntax Claude can use, see [X search operators](/answers/x-search-operators-api/); to put one post's replies and quotes in a spreadsheet, [exporting replies and quotes](/answers/export-x-post-replies-quotes/); for an hourly alert, [monitoring brand mentions on X](/answers/monitor-brand-mentions-x/).

## Endpoints used

- [X post search](https://okdata.online/apis/x/posts/search/) `x.posts.search`: $0.002 per call · about 20 posts per page
- [X account posts](https://okdata.online/apis/x/users/posts/list/) `x.users.posts.list`: $0.002 per call · about 20 posts per page
- [X post replies](https://okdata.online/apis/x/posts/replies/list/) `x.posts.replies.list`: $0.002 per call · about 35 posts per page
- [X account followers](https://okdata.online/apis/x/users/followers/list/) `x.users.followers.list`: $0.0001 per account · at most $0.02 per call
- [X list posts](https://okdata.online/apis/x/lists/posts/list/) `x.lists.posts.list`: $0.002 per call · about 100 posts per page
- [X community posts](https://okdata.online/apis/x/communities/posts/list/) `x.communities.posts.list`: $0.0003 per post · at most $0.006 per call
- [X trending topics](https://okdata.online/apis/x/trends/list/) `x.trends.list`: $0.009 per call · about 30 board entries per page
- [X account mentions](https://okdata.online/apis/x/users/mentions/list/) `x.users.mentions.list`: $0.0003 per post · at most $0.006 per call

## More about X (Twitter)

- [X (Twitter) API](https://okdata.online/apis/x/)
- [How to search X (Twitter) posts by keyword and export them](https://okdata.online/guides/x-search-posts-by-keyword/)
- [How to record X (Twitter) trends for several countries every day](https://okdata.online/guides/x-trends-by-country/)
- [How do I give my AI agent live X (Twitter) search without the official X API?](https://okdata.online/answers/ai-agent-live-x-search/)
- [How do I get all the tweets from a Twitter account?](https://okdata.online/answers/get-all-tweets-from-account/)
- [snscrape fails on Twitter with blocked (404). Is there a working replacement?](https://okdata.online/answers/snscrape-twitter-blocked-404/)
- [Is there an MCP server that gives Claude TikTok, YouTube and X data?](https://okdata.online/answers/tiktok-youtube-x-mcp-server/)
- [Twitter's free academic API is gone. How can researchers collect tweets now?](https://okdata.online/answers/twitter-academic-api-alternative/)
- [Official platform APIs vs third-party data APIs (2026)](https://okdata.online/compare/official-apis-vs-data-apis/)
- [How to choose a social media data API (2026)](https://okdata.online/compare/social-media-data-apis/)
- [Trending topics API](https://okdata.online/roles/trends-list/)
- [Account posts API](https://okdata.online/roles/accounts-posts-list/)
- [Post search API](https://okdata.online/roles/posts-search/)
- [Community posts API](https://okdata.online/roles/communities-posts-list/)

## Sources

- [X developer docs, X MCP server: hosted at api.x.com/mcp, needs your own X app (OAuth 2.0 via the xurl bridge, or an app-only Bearer token that is read-only), tool groups, client-not-enrolled fix](https://docs.x.com/tools/mcp) (read 2026-11-17)
- [X API pricing: pay-per-usage credits, no subscriptions, Posts read $0.005 per resource, 3 million post reads a month cap](https://docs.x.com/x-api/getting-started/pricing) (read 2026-11-17)

Where people asked this (read 2026-11-17): 

- https://github.com/anthropics/claude-ai-mcp/issues/959
- https://github.com/nearai/ironclaw/issues/2230
- https://github.com/dennisonbertram/claude-tauri-boilerplate/issues/391
- https://github.com/xdevplatform/xmcp/issues/7

Updated 2026-11-17
