Skip to content
Browse the docs

AI agents

Use xscraper from AI agents

The MCP server gives Claude, Cursor, VS Code and any other MCP client nine read-only tools for X data. The skills teach the agent which tool fits a task and how to spend as few tokens as the answer needs. Both use your API key, and each tool call costs the same as the REST call behind it.

Get an API keyensp1re/xscraper-agent-kit

MCP server

MCPhttps://mcp.xscraper.online/mcp

Streamable HTTP, with your key in the x-api-key header. For clients that only start local servers, the same tools run from the npm package xscraper-mcp. Results are one line per post or account by default, with the IDs the next call needs; ask for response_format: detailed to get every field.

x_search_tweets
Search posts with X operators, newest or most engaged.Search tweets 6–14 tokens
x_search_users
Find accounts by name or bio.Search profiles 4–6 tokens
x_get_user
One account's profile, optionally with its recent posts or replies.Profile by username 1 tokenUser tweets 3–7 tokensLatest tweet 1 token
x_get_tweet
A post by ID or link, with a page of replies or quotes.Tweet by ID 1 tokenTweet replies 4 tokensTweet quotes 4 tokens
x_get_followers
Followers of an account, or who it follows.Followers 4 tokensFollowing 4 tokens
x_get_user_likes
Posts an account liked.Liked tweets 4–8 tokens
x_get_list_tweets
Posts from an X list.List tweets 3–7 tokens
x_get_trends
What is trending now.Trends 2 tokens
x_get_balance
Tokens left on your key.Token balance 0 tokens

Connect a client

Create a key in the dashboard, then add the server to your client.

Run once in a terminal. The server is added for your user; use --scope project to share it through .mcp.json.

Claude Code
claude mcp add --transport http xscraper \
  https://mcp.xscraper.online/mcp \
  --header "x-api-key: $XSCRAPER_API_KEY"

Skills

Agent Skills are instructions an agent loads when a task matches. They follow the open Agent Skills format, so Claude Code, Codex, Cursor, Copilot and other agents can use them. The source is on GitHub.

xscraper-api
Which tool answers which question, X search operators, spend rules, and the REST reference for agents without MCP.
x-account-research
Who an account is, what it posts, and whether its engagement looks real, as a short sourced brief.
x-topic-research
What X says about a topic, brand, launch or ticker: themes, complaints and praise, with links.
x-thread-digest
A post with its replies and quote posts, summed up into arguments and notable voices.
x-monitor
Watch accounts or keywords on a schedule and report only new posts, with one search per run.

Installs the skills and the MCP server together. Set XSCRAPER_API_KEY in your shell first.

Claude Code plugin
/plugin marketplace add ensp1re/xscraper-agent-kit
/plugin install xscraper@xscraper

Claude apps: download a skill folder from GitHub, zip it, and upload it in Settings → Capabilities → Skills.

Costs and limits

  • Each tool lists its price, and every result ends with the tokens it spent and the balance left.
  • x_get_balance is free. The skills tell the agent to start with one page and to ask you before a task that would cost more than about 50 tokens.
  • Failed calls are refunded, except a not-found answer. A call that times out may still be charged, so the agent checks the balance before retrying.
  • The rate limit is the same as for REST: 100 requests per minute per key.