Skip to main content

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

BASH
https://xcrop.io/mcp

Transport 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

BASH
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)

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

⚠
Treat a connector URL that contains your key like the key itself. If it leaks, revoke the key in the dashboard and create a new one

Tools

ToolWhat it does
get_userProfile of an X (Twitter) account: name, bio, followers, following, post count, verification, creation date. Costs 18 credits
get_user_tweetsLatest posts of an X account (its Posts tab). Costs 15 credits per post returned
search_tweetsSearch 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_usersFind X accounts by name or keyword. Costs 18 credits per account returned
get_tweetOne X post with its text, author, counts (likes, reposts, replies, quotes, views) and media. Costs 15 credits
get_tweet_repliesReplies under an X post (its conversation). Costs 15 credits per reply returned
get_tweet_quotesPosts that quote an X post. Costs 15 credits per quote returned
get_tweet_retweetersAccounts that reposted (retweeted) an X post. Costs 1 credit per account returned
get_followersFollowers of an X account, newest first. Costs 1 credit per follower returned
get_followingAccounts an X account follows, newest first. Costs 1 credit per account returned
check_followDoes one X account follow another? Returns both directions. Costs 50 credits
check_interactionDid 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_trendingTrending topics on X, worldwide or for a country. Costs 100 credits
get_creditsCredits 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