Servers Playground How we check Submit a server

xdataapi: X (Twitter) data

Working · 2.1 s

io.xdataapi/xdataapiv0.3.2 Domain verified

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

Marketing & SEO

Source Website Registry entry

Try it

Call this server's tools from your browser. Nothing to install.

https://api.xdataapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

get_balance

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

This tool takes no arguments.

xdataapi: X (Twitter) data MCP server | mcptry

Tools (14)

get_balance

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

read-only

No arguments.

Input schema (JSON)

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

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.

read-only

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

Input schema (JSON)

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

get_followers

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

read-only

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

Input schema (JSON)

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

get_following

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

read-only

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

Input schema (JSON)

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

get_quotes

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

read-only

Argument	Type	Description
id*	string
count	integer
fresh	boolean	Bypass the cache. Costs 2x credits.
cursor	string	next_cursor from the previous page

Input schema (JSON)

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

get_replies

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

read-only

Argument	Type	Description
id*	string
fresh	boolean	Bypass the cache. Costs 2x credits.
cursor	string	next_cursor from the previous page

Input schema (JSON)

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

get_retweeters

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

read-only

Argument	Type	Description
id*	string
count	integer
fresh	boolean	Bypass the cache. Costs 2x credits.
cursor	string	next_cursor from the previous page

Input schema (JSON)

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

get_thread

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

read-only

Argument	Type	Description
id*	string
fresh	boolean	Bypass the cache. Costs 2x credits.
cursor	string	next_cursor from the previous page

Input schema (JSON)

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

get_tweet

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

read-only

Argument	Type	Description
id*	string
fresh	boolean	Bypass the cache. Costs 2x credits.

Input schema (JSON)

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

get_tweets

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

read-only

Argument	Type	Description
ids*	array
fresh	boolean	Bypass the cache. Costs 2x credits.

Input schema (JSON)

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

get_user

Profile of one X user by handle. 1 credit.

read-only

Argument	Type	Description
fresh	boolean	Bypass the cache. Costs 2x credits.
handle*	string	Handle, with or without @

Input schema (JSON)

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

get_user_tweets

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

read-only

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

Input schema (JSON)

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

get_users

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

read-only

Argument	Type	Description
fresh	boolean	Bypass the cache. Costs 2x credits.
handles*	array

Input schema (JSON)

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

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

read-only

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

Input schema (JSON)

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