MCP Server: XCROP API Documentation
MCP Server
XCROP runs a remote Model Context Protocol server, so AI assistants and agents (Claude, ChatGPT, Cursor, VS Code, Claude Code) can read X data and verify follows, reposts, replies and quotes by calling tools. Every tool call is a normal API request on your own key: same credits, same rate limits, same error codes as the REST API
Server URL
https://xcrop.io/mcpTransport is Streamable HTTP. Authenticate with your API key from the dashboard as Authorization: Bearer xc_live_.... Listing the tools needs no key; calling one does
Claude Code
claude mcp add --transport http xcrop https://xcrop.io/mcp \ --header "Authorization: Bearer xc_live_YOUR_KEY"
Cursor, VS Code and other clients (mcp.json)
{ "mcpServers": { "xcrop": { "url": "https://xcrop.io/mcp", "headers": { "Authorization": "Bearer xc_live_YOUR_KEY" } } } }
Claude or ChatGPT on the web
Clients that only accept a URL can pass the key in it: add a custom connector with https://xcrop.io/mcp?key=xc_live_YOUR_KEY. Prefer the header wherever the client offers one, because a URL can end up in logs
Tools
| Tool | What it does |
|---|---|
get_user | Profile of an X (Twitter) account: name, bio, followers, following, post count, verification, creation date. Costs 18 credits |
get_user_tweets | Latest posts of an X account (its Posts tab). Costs 15 credits per post returned |
search_tweets | Search X posts. Supports X search operators in the query (from:, to:, lang:, min_faves:, since:, until:, -filter:replies). Costs 15 credits per post returned |
search_users | Find X accounts by name or keyword. Costs 18 credits per account returned |
get_tweet | One X post with its text, author, counts (likes, reposts, replies, quotes, views) and media. Costs 15 credits |
get_tweet_replies | Replies under an X post (its conversation). Costs 15 credits per reply returned |
get_tweet_quotes | Posts that quote an X post. Costs 15 credits per quote returned |
get_tweet_retweeters | Accounts that reposted (retweeted) an X post. Costs 1 credit per account returned |
get_followers | Followers of an X account, newest first. Costs 1 credit per follower returned |
get_following | Accounts an X account follows, newest first. Costs 1 credit per account returned |
check_follow | Does one X account follow another? Returns both directions. Costs 50 credits |
check_interaction | Did an account repost, reply to or quote a given X post? Built for giveaway, airdrop and quest verification. For reply and quote, min_tags requires that many @mentions in the text. Costs 50 credits |
get_trending | Trending topics on X, worldwide or for a country. Costs 100 credits |
get_credits | Credits left on your XCROP key: plan allowance, used, remaining and top-up balance. Free |
Paging and credits
List tools return a small page by default (10 posts, or 100 accounts for followers and reposters) and cap each call (100 posts; 1,000 accounts for followers, following and reposters; 50 for account search). When there is more, the reply carries next_cursor, and the assistant asks again only if you need it. This keeps an agent from spending your credits on pages nobody reads. get_credits is free and shows what is left