# X MCP server for AI agents

> Give Claude, Cursor or any MCP client X (Twitter) data: 20 endpoints from $0.0001 a call, no X login. Your AI finds the endpoint, says the price and fetches.

Canonical page: https://okdata.online/mcp/x/

## Connect your AI in one sentence

```text
Set up okdata for me by following https://okdata.online/agents.md. Here is my okdata API key: okd_…. Keep it safe and use it for all okdata calls.
```

## What it answers

| Question | Endpoint | Price |
|---|---|---|
| X post detail: One post by ID or link: text, media, views, likes, reposts and replies. | [x.posts.get](https://okdata.online/apis/x/posts/get/) | $0.0003 per call |
| X post search: Posts matching a query (X search operators work), latest or top. | [x.posts.search](https://okdata.online/apis/x/posts/search/) | $0.002 per call · about 20 posts per page |
| X account profile: An account by handle or numeric ID, or up to 100 accounts by ID in one call: followers, following, post count, bio and verification. IDs that find no account are listed under data.missing and not charged. | [x.users.get](https://okdata.online/apis/x/users/get/) | $0.0004 per account · at most $0.04 per call |
| X account posts: An account's posts, newest first. | [x.users.posts.list](https://okdata.online/apis/x/users/posts/list/) | $0.002 per call · about 20 posts per page |
| X trending topics: Trending topics worldwide or for one country. | [x.trends.list](https://okdata.online/apis/x/trends/list/) | $0.009 per call · about 30 board entries per page |
| X post replies: The replies under a post, in the order X ranks them, up to about 60 a page. A reply is a post itself, so each comes back as a post: text, author, time posted, views, likes and its own reply count. | [x.posts.replies.list](https://okdata.online/apis/x/posts/replies/list/) | $0.002 per call · about 35 posts per page |
| X post quotes: Posts that quote a post, newest or most popular first, 20 a page: what people added, who they are and how far it went. | [x.posts.quotes.list](https://okdata.online/apis/x/posts/quotes/list/) | $0.0003 per post · at most $0.006 per call |
| X post retweeters: The accounts that retweeted a post, about 100 a page: handle, name, bio and follower count. | [x.posts.retweeters.list](https://okdata.online/apis/x/posts/retweeters/list/) | $0.002 per call · about 100 accounts per page |
| X article: The long-form article attached to a post, by the post ID: title, the whole text, author, time published, views, likes and replies. | [x.posts.article.get](https://okdata.online/apis/x/posts/article/get/) | $0.002 per call |
| X thread: The posts of a thread, from the ID of any post in it: the post it started from, the author's follow-ups and the replies in between. X sets the page size, up to about 50. | [x.threads.posts.list](https://okdata.online/apis/x/threads/posts/list/) | $0.0003 per post · at most $0.015 per call |
| X account search: Accounts matching keywords, 20 a page: handle, name, bio, followers, following, post count and verification. | [x.users.search](https://okdata.online/apis/x/users/search/) | $0.0004 per account · at most $0.008 per call |
| X account followers: The accounts following an account, newest followers first, 200 a page: handle, name, bio, followers and post count. | [x.users.followers.list](https://okdata.online/apis/x/users/followers/list/) | $0.0001 per account · at most $0.02 per call |
| X account following: The accounts an account follows, most recently followed first, 200 a page: handle, name, bio, followers and post count. | [x.users.following.list](https://okdata.online/apis/x/users/following/list/) | $0.0001 per account · at most $0.02 per call |
| X account mentions: Posts that mention an account, newest first, 20 a page: text, author, time posted, views, likes and reposts. | [x.users.mentions.list](https://okdata.online/apis/x/users/mentions/list/) | $0.0003 per post · at most $0.006 per call |
| X list posts: The timeline of a list, newest first, about 100 posts a page: text, author, time posted, views, likes and reposts. | [x.lists.posts.list](https://okdata.online/apis/x/lists/posts/list/) | $0.002 per call · about 100 posts per page |
| X list members: The accounts a list is made of, 20 a page: handle, name, bio, followers and verification. | [x.lists.members.list](https://okdata.online/apis/x/lists/members/list/) | $0.0004 per account · at most $0.008 per call |
| X list followers: Up to 20 accounts that follow a list: handle, name, bio, followers and verification. One page only; there is no next page. | [x.lists.followers.list](https://okdata.online/apis/x/lists/followers/list/) | $0.0004 per account · at most $0.008 per call |
| X community profile: A community by ID: name, description, member count, when it was created, and under ext its moderators, how people join and its topic. | [x.communities.get](https://okdata.online/apis/x/communities/get/) | $0.0004 per call |
| X community posts: Posts in a community, newest first, 20 a page: text, author, time posted, views, likes and reposts. | [x.communities.posts.list](https://okdata.online/apis/x/communities/posts/list/) | $0.0003 per post · at most $0.006 per call |
| X community members: The accounts that have joined a community, 20 a page: handle, name, bio, followers and verification. | [x.communities.members.list](https://okdata.online/apis/x/communities/members/list/) | $0.0004 per account · at most $0.008 per call |

## Two calls

1. `find {"query":"x posts"}`: free
2. `call {"capability":"x.posts.search","query":"\"claude code\" lang:zh"}`: $0.002 per call · about 20 posts per page

## Skill package

- `okdata-x`: https://okdata.online/.well-known/agent-skills/okdata-x/SKILL.md · https://okdata.online/skills/okdata-x.zip

[Every X (Twitter) endpoint](https://okdata.online/apis/x/) · [MCP server](https://okdata.online/mcp/) · [Integrations](https://okdata.online/integrations/)