Skip to main content
← Back to blog
•by Engineering

X (Twitter) MCP Server: Use X Data in Claude, ChatGPT and Cursor

AI assistants are good at reading and reasoning, but on their own they cannot see what is happening on X right now. The XCROP MCP server fixes that. Add one URL to Claude, ChatGPT, Cursor or VS Code and your assistant can read public X data and check follows, reposts, replies and quotes, whenever a question needs it

You ask in plain words. The assistant decides which tool to call, calls it on your API key and answers with the result. No code, no copying JSON around

What MCP is, in one paragraph

The Model Context Protocol is an open standard for connecting AI apps to outside tools. An MCP server publishes a list of tools with their inputs, and the AI app calls them when it needs to. XCROP runs a remote MCP server, so there is nothing to install: your app talks to https://xcrop.io/api/mcp over HTTP

What you can ask

Here are real questions and answers from the server, read on 21 November 2026

• "How many followers does @elonmusk have, and how many accounts does he follow?" The assistant calls get_user and answers: 240.4M followers, following 1,427 accounts, with 112,529 posts since June 2009
• "Does @elonmusk follow @NASA, and does @NASA follow @elonmusk back?" It calls check_follow: yes, @elonmusk follows @NASA, but @NASA does not follow him back
• "Did @elonmusk repost @jamesdouma's post about his Grok subscription?" It calls check_interaction and finds the repost in the post's reposts list
• "What is trending on X in the United States right now?" It calls get_trending and lists the top topics

Counts and trends change by the hour, so the numbers above are a snapshot. Ask the same question tomorrow and you get tomorrow's data

The 14 tools

All tools are read-only. Each one is a normal XCROP API request, so it costs the same credits

ToolWhat it doesCost
get_userProfile of an account18 credits
get_user_tweetsLatest posts of an account15 per post
search_tweetsSearch posts with X operators15 per post
search_usersFind accounts by name or keyword18 per account
get_tweetOne post with its counts and media15 credits
get_tweet_repliesReplies under a post15 per reply
get_tweet_quotesPosts that quote a post15 per quote
get_tweet_retweetersAccounts that reposted a post1 per account
get_followersFollowers of an account1 per follower
get_followingAccounts an account follows1 per account
check_followDoes one account follow another50 credits
check_interactionDid an account repost, reply to or quote a post50 credits
get_trendingTrending topics, worldwide or by country100 credits
get_creditsYour credit balanceFree

Lists are small by default (10 posts, or 100 accounts for followers and reposters) and capped per call, so an assistant cannot burn through your credits by paging on its own

Set it up

You need an XCROP API key. Create one in the dashboard; the free plan includes 5,000 credits a month

Claude Code

Run this once in your terminal, with your key in place of xc_live_YOUR_KEY. Claude Code saves the server, and from then on you just ask

BASH
claude mcp add --transport http xcrop https://xcrop.io/api/mcp \
  --header "Authorization: Bearer xc_live_YOUR_KEY"

Cursor

Add this to Cursor's MCP config file (mcp.json)

JSON
{
  "mcpServers": {
    "xcrop": {
      "url": "https://xcrop.io/api/mcp",
      "headers": { "Authorization": "Bearer xc_live_YOUR_KEY" }
    }
  }
}

VS Code

Add this to .vscode/mcp.json in your project, then use Copilot Chat in agent mode

JSON
{
  "servers": {
    "xcrop": {
      "type": "http",
      "url": "https://xcrop.io/api/mcp",
      "headers": { "Authorization": "Bearer xc_live_YOUR_KEY" }
    }
  }
}

Claude and ChatGPT on the web

Open Settings, then Connectors, add a custom connector and paste this URL with your key

BASH
https://xcrop.io/api/mcp?key=xc_live_YOUR_KEY

Treat that URL like the key itself: anyone who has it can spend your credits. Where your client lets you set a header, use the Authorization header instead

Is it safe?

• Read-only. No tool can post, like, follow or send a DM
• Your own key. Every call runs on your key with your plan's limits. Revoke the key in the dashboard and access stops at once
• Hard caps. Page sizes are capped per call, and the assistant only fetches more when you ask for more

Built for giveaway and airdrop checks

check_follow and check_interaction run the same checks as XCROP's follow and interaction check endpoints, the ones giveaway hosts use to verify entries (and the Winner Picker draws from a post's reposts, quotes and replies). Ask your assistant whether a list of entrants follows your account, or whether someone reposted and replied with the required number of tags, and it runs the checks for you instead of opening X profile by profile

Next steps

• Full setup and the tool reference: MCP server docs
• Overview page: xcrop.io/mcp
• Prefer code? The same data is in the REST API and the official SDKs

Frequently Asked Questions

What is an MCP server?

MCP (Model Context Protocol) is an open standard that lets AI apps call outside tools. An MCP server exposes those tools. Once you add the XCROP server, your assistant can fetch X data whenever a question needs it

Is there an official X (Twitter) MCP server?

XCROP runs a remote MCP server for public X data at https://xcrop.io/api/mcp, listed on the official MCP Registry as io.xcrop/x-data. It works with any client that supports remote MCP servers over HTTP

Does it cost extra?

No separate plan. Every tool call is a normal XCROP API request on your key and uses the same credits. A profile is 18 credits, a post 15, a follower 1, a follow or interaction check 50. The free plan includes 5,000 credits a month

Can the assistant post, like or follow for me?

No. All 14 MCP tools are read-only. Posting, liking and following are only in the REST Write API

Which apps work with it?

Claude Code, Claude, ChatGPT, Cursor, VS Code and any other MCP client that supports remote servers over HTTP

Build this with the XCROP API

One API for X (formerly Twitter) data: profiles, tweets, followers, search and real-time streams. Start free with 5,000 credits/month, no card required