xdataapi: X (Twitter) data

Official14 toolsLive

by xdataapi · Python

Read-only public X (Twitter) data: profiles, tweets, threads, followers, search. Pay per result.

io.xdataapi/xdataapi — MCP Server

This MCP server provides read-only access to public X (Twitter) data, covering profiles, tweets, threads, followers, and search. The service is described as pay per result, and the catalog entry is titled io.xdataapi/xdataapi with the slug io-xdataapi-xdataapi.

🛠️ Key Features

Read-only public X (Twitter) data access
Supports: profiles, tweets, threads, followers, search
Billing model described as pay per result

🚀 Use Cases

Retrieve X profiles and related follower information
Collect tweets and thread content for lookup and review
Run search queries across public X (Twitter) data

⚡ Developer Benefits

Targets specific X data entities (profiles, tweets, threads, followers, search)
Clear scope: public and read-only

⚠️ Limitations

Only public X (Twitter) data
Read-only access
Cost model is pay per result (pricing details not provided)

Topics

ai-agentsapillm-toolsmcpmcp-servermodel-context-protocolopenapipythontwittertwitter-apitypescriptx-api

Captured live from the server via tools/list.

get_user

Profile of one X user by handle. 1 credit.

Parameters2

handle	string	required	Handle, with or without @
fresh	boolean	optional	Bypass the cache. Costs 2x credits.

Raw schema

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "minLength": 1,
      "maxLength": 16,
      "description": "Handle, with or without @"
    },
    "fresh": {
      "description": "Bypass the cache. Costs 2x credits.",
      "type": "boolean"
    }
  },
  "required": [
    "handle"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_users

Profiles of up to 100 X users by handle in one call. 1 credit per profile found.

Parameters2

handles	array	required
fresh	boolean	optional	Bypass the cache. Costs 2x credits.

Raw schema

{
  "type": "object",
  "properties": {
    "handles": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 16
      }
    },
    "fresh": {
      "description": "Bypass the cache. Costs 2x credits.",
      "type": "boolean"
    }
  },
  "required": [
    "handles"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_user_tweets

Latest tweets of a user, newest first. 1 credit per tweet.

Parameters4

user	string	required	Handle (with or without @) or numeric user id
count	integer	optional	Page size, 1 to 100
cursor	string	optional	next_cursor from the previous page
fresh	boolean	optional	Bypass the cache. Costs 2x credits.

Raw schema

{
  "type": "object",
  "properties": {
    "user": {
      "type": "string",
      "minLength": 1,
      "maxLength": 30,
      "description": "Handle (with or without @) or numeric user id"
    },
    "count": {
      "description": "Page size, 1 to 100",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "next_cursor from the previous page",
      "type": "string"
    },
    "fresh": {
      "description": "Bypass the cache. Costs 2x credits.",
      "type": "boolean"
    }
  },
  "required": [
    "user"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_followers

Followers of a user. 0.1 credit per profile. Not every account tier can read this; a 403 is free.

Parameters4

user	string	required	Handle (with or without @) or numeric user id
count	integer	optional
cursor	string	optional	next_cursor from the previous page
fresh	boolean	optional	Bypass the cache. Costs 2x credits.

Raw schema

{
  "type": "object",
  "properties": {
    "user": {
      "type": "string",
      "minLength": 1,
      "maxLength": 30,
      "description": "Handle (with or without @) or numeric user id"
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "cursor": {
      "description": "next_cursor from the previous page",
      "type": "string"
    },
    "fresh": {
      "description": "Bypass the cache. Costs 2x credits.",
      "type": "boolean"
    }
  },
  "required": [
    "user"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_follower_ids

Numeric ids of the followers of a user, no profiles. 0.02 credit per id. Same page as get_followers, so a page read there is a cache hit here. A 403 is free.

Parameters4

user	string	required	Handle (with or without @) or numeric user id
count	integer	optional
cursor	string	optional	next_cursor from the previous page
fresh	boolean	optional	Bypass the cache. Costs 2x credits.

Raw schema

{
  "type": "object",
  "properties": {
    "user": {
      "type": "string",
      "minLength": 1,
      "maxLength": 30,
      "description": "Handle (with or without @) or numeric user id"
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "cursor": {
      "description": "next_cursor from the previous page",
      "type": "string"
    },
    "fresh": {
      "description": "Bypass the cache. Costs 2x credits.",
      "type": "boolean"
    }
  },
  "required": [
    "user"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_following

Accounts a user follows. 0.1 credit per profile. Not every account tier can read this; a 403 is free.

Parameters4

user	string	required	Handle (with or without @) or numeric user id
count	integer	optional
cursor	string	optional	next_cursor from the previous page
fresh	boolean	optional	Bypass the cache. Costs 2x credits.

Raw schema

{
  "type": "object",
  "properties": {
    "user": {
      "type": "string",
      "minLength": 1,
      "maxLength": 30,
      "description": "Handle (with or without @) or numeric user id"
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "cursor": {
      "description": "next_cursor from the previous page",
      "type": "string"
    },
    "fresh": {
      "description": "Bypass the cache. Costs 2x credits.",
      "type": "boolean"
    }
  },
  "required": [
    "user"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_tweets

X advanced search. q takes the x.com operators. 1 credit per tweet or profile. product Latest is always available; Top may answer 403 (free).

Parameters5

q	string	required	Query with x.com operators, e.g. "from:x since:2026-09-01 -filter:replies"
product	string	optional	Default Latest. People returns profiles.
count	integer	optional
cursor	string	optional	next_cursor from the previous page
fresh	boolean	optional	Bypass the cache. Costs 2x credits.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "Query with x.com operators, e.g. \"from:x since:2026-09-01 -filter:replies\""
    },
    "product": {
      "description": "Default Latest. People returns profiles.",
      "type": "string",
      "enum": [
        "Latest",
        "Top",
        "People",
        "Photos",
        "Videos"
      ]
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "cursor": {
      "description": "next_cursor from the previous page",
      "type": "string"
    },
    "fresh": {
      "description": "Bypass the cache. Costs 2x credits.",
      "type": "boolean"
    }
  },
  "required": [
    "q"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_tweet

One tweet by numeric id, with its author. 1 credit.

Parameters2

id	string	required
fresh	boolean	optional	Bypass the cache. Costs 2x credits.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^\\d{1,25}$"
    },
    "fresh": {
      "description": "Bypass the cache. Costs 2x credits.",
      "type": "boolean"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_tweets

Up to 100 tweets by numeric id in one call. 1 credit per tweet found.

Parameters2

ids	array	required
fresh	boolean	optional	Bypass the cache. Costs 2x credits.

Raw schema

{
  "type": "object",
  "properties": {
    "ids": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^\\d{1,25}$"
      }
    },
    "fresh": {
      "description": "Bypass the cache. Costs 2x credits.",
      "type": "boolean"
    }
  },
  "required": [
    "ids"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_thread

A tweet with its thread and replies; the focal tweet comes first. 1 credit per tweet returned.

Parameters3

id	string	required
cursor	string	optional	next_cursor from the previous page
fresh	boolean	optional	Bypass the cache. Costs 2x credits.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^\\d{1,25}$"
    },
    "cursor": {
      "description": "next_cursor from the previous page",
      "type": "string"
    },
    "fresh": {
      "description": "Bypass the cache. Costs 2x credits.",
      "type": "boolean"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_replies

Direct replies to a tweet, one page. 1 credit per reply.

Parameters3

id	string	required
cursor	string	optional	next_cursor from the previous page
fresh	boolean	optional	Bypass the cache. Costs 2x credits.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^\\d{1,25}$"
    },
    "cursor": {
      "description": "next_cursor from the previous page",
      "type": "string"
    },
    "fresh": {
      "description": "Bypass the cache. Costs 2x credits.",
      "type": "boolean"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_quotes

Tweets that quote a tweet, newest first. 1 credit per tweet.

Parameters4

id	string	required
count	integer	optional
cursor	string	optional	next_cursor from the previous page
fresh	boolean	optional	Bypass the cache. Costs 2x credits.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^\\d{1,25}$"
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "cursor": {
      "description": "next_cursor from the previous page",
      "type": "string"
    },
    "fresh": {
      "description": "Bypass the cache. Costs 2x credits.",
      "type": "boolean"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_retweeters

Accounts that retweeted a tweet. 0.5 credit per profile. Not every account tier can read this; a 403 is free.

Parameters4

id	string	required
count	integer	optional
cursor	string	optional	next_cursor from the previous page
fresh	boolean	optional	Bypass the cache. Costs 2x credits.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^\\d{1,25}$"
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "cursor": {
      "description": "next_cursor from the previous page",
      "type": "string"
    },
    "fresh": {
      "description": "Bypass the cache. Costs 2x credits.",
      "type": "boolean"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_balance

Credits left on this key and its rate limit. Free.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md4 KBView on GitHub

xdataapi

Read-only public X (Twitter) data for developers and AI agents. Profiles, tweets, timelines, threads, followers, and search with the x.com operators. One credit per tweet or profile returned. Empty results and errors are free.

Site and docs: https://xdataapi.io/docs
API: https://api.xdataapi.io (OpenAPI 3.1: openapi.yaml, also at https://api.xdataapi.io/openapi.yaml)
Hosted MCP server: https://api.xdataapi.io/mcp (Streamable HTTP, OAuth or x-api-key)
Status, checked every minute from outside: https://xdataapi.io/status
Docs for agents: https://xdataapi.io/llms.txt

Not affiliated with X Corp. Public data only. No write endpoints.

MCP

Claude Code, as a plugin — the server plus a skill that teaches the search operators and the cost rules:

bash

claude plugin marketplace add xdataapi/xdataapi
claude plugin install xdataapi@xdataapi

Or the server on its own, in any MCP client:

bash

claude mcp add --transport http xdataapi https://api.xdataapi.io/mcp

The server signs you in with OAuth on first use. Clients without OAuth pass a key instead:

json

{
  "mcpServers": {
    "xdataapi": {
      "url": "https://api.xdataapi.io/mcp",
      "headers": { "x-api-key": "xd_live_..." }
    }
  }
}

Stdio-only clients can bridge with mcp-remote:

json

{
  "mcpServers": {
    "xdataapi": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.xdataapi.io/mcp", "--header", "x-api-key:${XDATAAPI_KEY}"],
      "env": { "XDATAAPI_KEY": "xd_live_..." }
    }
  }
}

Tools: get_user, get_users, get_user_tweets, get_followers, get_following, get_follower_ids, search_tweets, get_tweet, get_tweets, get_thread, get_replies, get_quotes, get_retweeters, get_balance. All read-only. Listed on the official MCP Registry as io.xdataapi/xdataapi.

REST

bash

curl "https://api.xdataapi.io/v1/tweets/search?q=from:x%20since:2026-09-01&count=20" \
  -H "x-api-key: xd_live_..."

Every response carries credits_charged and balance_remaining. Pages return next_cursor; pass it back as cursor.

SDKs

TypeScript, npm install xdataapi:

import { xdataapi } from 'xdataapi';
const api = xdataapi({ apiKey: process.env.XDATAAPI_KEY! });
const { data } = await api.searchTweets({ query: { q: 'from:x', count: 20 } });

Python, pip install xdataapi:

python

from xdataapi import AuthenticatedClient
from xdataapi.api.tweets import search_tweets
client = AuthenticatedClient(base_url="https://api.xdataapi.io", token=KEY, prefix="", auth_header_name="x-api-key")
page = search_tweets.sync(client=client, q="from:x", count=20)

The TypeScript client has no runtime dependencies; npm install xdataapi pulls one package.

Both are generated from openapi.yaml by sdk/generate.sh; the source is in sdk/typescript and sdk/python. Nothing in them is hand-written except the small wrapper in sdk/typescript/src/index.ts and the READMEs, so an API change means regenerating rather than editing.

Framework packages

Installable tools for agent frameworks. Each one carries the credit cost in every tool description, so the model can see what a plan costs before it runs it, and each takes a max_results cap so one agent step cannot empty the balance.

Package	Install	Source
LangChain and LangGraph	`pip install langchain-xdataapi`	packages/langchain
LlamaIndex	`pip install llama-index-tools-xdataapi`	packages/llama-index
n8n	community node `n8n-nodes-xdataapi`	packages/n8n
Claude Code	`claude plugin install xdataapi@xdataapi`	plugins/xdataapi

For anything else, see examples/: CrewAI, the Vercel AI SDK, and the OpenAI Agents SDK. An agent that speaks MCP needs none of them.

Pricing

Prepaid credit packs from $10. Credits never expire. No per-call minimum. Rate limit rises with lifetime spend. Details: https://xdataapi.io/#pricing

Support

hello@xdataapi.io. Security reports: https://xdataapi.io/.well-known/security.txt

Install

Tools (14)

get_userget_usersget_user_tweetsget_followersget_follower_idsget_followingsearch_tweetsget_tweet

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.xdataapi.io/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "xdataapi": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.xdataapi.io/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.xdataapi/xdataapi — MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

get_user

get_users

get_user_tweets

get_followers

get_follower_ids

get_following

search_tweets

get_tweet

get_tweets

get_thread

get_replies

get_quotes

get_retweeters

get_balance

xdataapi

MCP

REST

SDKs

Framework packages

Pricing

Support

Install

Remote endpoint

Related servers