X Twitter

Official6 tools

by veezeehq

X (formerly Twitter) posts, profiles, and search for AI agents. No key needed to start.

Topics

ai-agentslinkedinmcpmcp-servermodel-context-protocol

Captured live from the server via tools/list.

x_search

Search X by keywords. type picks the mode: recent (default) is the deep chronological sweep and keeps paginating as far as you follow the cursor; popular returns the highest-engagement tweets for the query; people finds accounts and returns a single page (no cursor). Advanced query operators pass through verbatim, e.g. "from:nasa", "min_faves:100", exact phrases in quotes -- there is no separate date parameter, so use since:/until: operators for time windows. Costs 6 credits per page; a cursor page is a NEW call priced the same way, so a deep sweep costs linearly in pages. Returns tweet summaries (text, author with follower count, views, likes, retweets, replies, created_at, url, id) with a cursor. Fetch one tweet's full detail with x_get_tweet and an account's timeline with x_get_tweets. For comment-level sentiment inside topic communities, reddit_search type=comments is usually the sharper instrument.

Parameters5

query	string	required	Free-text keywords; X advanced operators work, e.g. 'claude code from:AnthropicAI since:2026-06-01'.
type	string	optional
cursor	string	optional
freshness	string	optional
max_credits	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text keywords; X advanced operators work, e.g. 'claude code from:AnthropicAI since:2026-06-01'."
    },
    "type": {
      "type": "string"
    },
    "cursor": {
      "type": "string"
    },
    "freshness": {
      "type": "string"
    },
    "max_credits": {
      "type": "number"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

x_get_profile

Fetch one X account's profile: name, bio, location, website, follower/following counts, tweet and media counts, verification state, and join date. identifier accepts a screen name without the @ (e.g. 'nasa'), a full x.com or twitter.com profile URL, or the numeric account id; numeric strings are treated as ids, and the rare all-digit handle can be forced with by='screen_name'. Costs 4 credits. The returned platform_fields.id is stable across handle changes; store it for repeat lookups. To find accounts by topic use x_search type=people, and to read what an account posts use x_get_tweets; this tool returns no tweets.

Parameters4

identifier	string	required	Screen name without the @ (e.g. 'nasa'), profile URL, or numeric account id.
by	string	optional
freshness	string	optional
max_credits	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "description": "Screen name without the @ (e.g. 'nasa'), profile URL, or numeric account id."
    },
    "by": {
      "type": "string"
    },
    "freshness": {
      "type": "string"
    },
    "max_credits": {
      "type": "number"
    }
  },
  "required": [
    "identifier"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

x_get_tweets

Fetch one page of an X account's timeline. identifier is a screen name, profile URL, or numeric id (auto-detected). mode picks the view: posts (default) is the account's own tweets, posts_and_replies includes their replies, highlights is the account's pinned highlights tab. include_retweets (default true) filters retweets out when false. Costs 4 credits per page; a cursor page is a NEW call priced the same way. Returns tweet summaries with engagement counts and a cursor for older tweets. Use this for 'what has X been posting', voice checks before outreach, or drafting replies in an account's register. For keyword search across all of X use x_search; for one specific tweet you already have, x_get_tweet.

Parameters6

identifier	string	required	Screen name without the @, profile URL, or numeric account id.
mode	string	optional
include_retweets	boolean	optional
cursor	string	optional
freshness	string	optional
max_credits	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "description": "Screen name without the @, profile URL, or numeric account id."
    },
    "mode": {
      "type": "string"
    },
    "include_retweets": {
      "type": "boolean"
    },
    "cursor": {
      "type": "string"
    },
    "freshness": {
      "type": "string"
    },
    "max_credits": {
      "type": "number"
    }
  },
  "required": [
    "identifier"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

x_get_tweet

Fetch one tweet by id with full engagement metrics: views, likes, retweets, quotes, replies, bookmarks, language, and the quoted tweet inline when there is one. tweet_id is the numeric id from a tweet URL (the digits after /status/) or from any other X tool's results; full tweet URLs are accepted too. Costs 4 credits. Use this to verify engagement before citing a tweet or to read a quoted thread hop by hop. It returns a single tweet, not the conversation around it: for the author's other tweets use x_get_tweets, and to find tweets by topic use x_search.

Parameters3

tweet_id	string	required	Numeric tweet id, e.g. '2054497961162478079', or a full tweet URL.
freshness	string	optional
max_credits	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "tweet_id": {
      "type": "string",
      "description": "Numeric tweet id, e.g. '2054497961162478079', or a full tweet URL."
    },
    "freshness": {
      "type": "string"
    },
    "max_credits": {
      "type": "number"
    }
  },
  "required": [
    "tweet_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

x_resolve_url

Identify what an X (formerly Twitter) URL points at before fetching it. Give any x.com or twitter.com URL (mobile links, query params, /i/web/status forms are fine); get back {type: profile|tweet, id, handle, canonical_url}. Tweet URLs yield the numeric id for x_get_tweet; profile URLs yield the handle for x_get_profile or x_get_tweets. Costs 2 credits and parses offline without fetching the page. t.co short links cannot be expanded offline and return INVALID_INPUT telling you so; expand them in your own browser step first. Skip this tool when you already have a handle or tweet id: the other X tools accept those directly.

Parameters1

url

string

required

An X URL, e.g. https://x.com/nasa/status/2054497961162478079 or https://twitter.com/nasa.

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "An X URL, e.g. https://x.com/nasa/status/2054497961162478079 or https://twitter.com/nasa."
    }
  },
  "required": [
    "url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_usage

Check your balance, plan, limits, and the last 10 charges (receipt ids included). Costs 0 credits and is exempt from the per-minute rate limit, so call it whenever you need to budget. The response includes upgrade_url (give it to your human when credits or plan limits block you; purchases credit this account directly with no login) and manage_url (give it to your human to change or cancel a paid plan in the Stripe billing portal). Trial accounts also get a claim_url that attaches an email so the account can be recovered if the key is lost. Requires an API key: keyless calls have no account, and each keyless response already reports its cost in the usage block. Not for fetching platform data.

Parameters

No parameters.

Raw schema

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

README.md5 KBView on GitHub

Veezee MCP server

LinkedIn, Reddit, and X (formerly Twitter) data for AI agents, over MCP or REST. This repo is the public home and issue tracker for the hosted servers on the official MCP Registry: io.veezee/linkedin (3.0.0), io.veezee/reddit (1.0.0), and io.veezee/x-twitter (1.0.0). The server is a hosted service; there is nothing to build or run from this repo.

No key needed to start: every data tool works keyless, under a shared budget of 20 credits per IP per day across all platforms, recent data only. Buy a key at https://veezee.io/upgrade for a higher budget; it's shown once on the confirmation page.
Website and docs: https://veezee.io
Found a bug or a gap? Open an issue or write hello@veezee.io.

Mounts

Four endpoints, all streamable-http, same auth and pricing:

mount	covers
`https://mcp.veezee.io/linkedin`	LinkedIn only (5 tools + `get_usage`)
`https://mcp.veezee.io/reddit`	Reddit only (6 tools + `get_usage`)
`https://mcp.veezee.io/x`	X (formerly Twitter) only (5 tools + `get_usage`)
`https://mcp.veezee.io/all`	Every platform (17 tools + `get_usage`)

Pick a single-platform mount when your agent only needs one platform: a smaller tool list is easier for the model to pick from correctly and costs less context per turn. Pick /all when one task spans platforms, e.g. a research brief that pulls LinkedIn, Reddit, and X signal on the same account, or a monitoring loop that watches more than one platform at once.

The 17 tools

LinkedIn (https://mcp.veezee.io/linkedin)

tool	what it does	credits
`linkedin_resolve_url`	identify a LinkedIn URL	2
`linkedin_get_profile`	get a person profile	4 base (2 sections included, +2/section, max 4)
`linkedin_search_people`	search people	10 base (10 results included, +1/10 more, max 30)
`linkedin_get_company`	get a company	4 base (+4 to resolve a new domain)
`linkedin_get_posts`	recent posts by a person or company	4/page (+4 to resolve a new domain)

Reddit (https://mcp.veezee.io/reddit)

tool	what it does	credits
`reddit_search`	search posts, comments, subreddits, or users	6/page
`reddit_get_subreddit`	get subreddit details	4 base (+2 for rules and moderators)
`reddit_get_subreddit_posts`	get a subreddit's posts	4/page
`reddit_get_user`	get a Reddit user	4 base (+2/section, max 2)
`reddit_get_post`	get posts by id, with an optional discussion thread	4 for up to 10 ids (+1/10 more, max 100; +4 for the full thread or one comment in context)
`reddit_resolve_url`	identify a Reddit URL	2

X, formerly Twitter (https://mcp.veezee.io/x)

tool	what it does	credits
`x_search`	search X (formerly Twitter)	6/page
`x_get_profile`	get an X profile	4
`x_get_tweets`	get an account's tweets	4/page
`x_get_tweet`	get one tweet with full metrics	4
`x_resolve_url`	identify an X URL	2

Every mount

tool	what it does	credits
`get_usage`	check credits and recent charges (needs a key)	0

Any tool call can set freshness: "realtime" for +2 credits to force a live fetch instead of cached data (needs a key). Full tool reference with schemas: https://veezee.io/docs

Keyless quickstart

No signup, no card, no key: the calls below work as-is. One example per platform.

LinkedIn — get a person profile:

json

{
  "method": "tools/call",
  "params": {
    "name": "linkedin_get_profile",
    "arguments": { "identifier": "williamhgates" }
  }
}

Reddit — search comments for what people say about a product:

json

{
  "method": "tools/call",
  "params": {
    "name": "reddit_search",
    "arguments": { "query": "notion alternative", "type": "comments" }
  }
}

X, formerly Twitter — get a profile:

json

{
  "method": "tools/call",
  "params": {
    "name": "x_get_profile",
    "arguments": { "identifier": "nasa" }
  }
}

Install

Examples below use /all; swap in /linkedin, /reddit, or /x for a single-platform mount.

Claude Code:

code

claude mcp add --transport http veezee https://mcp.veezee.io/all

Codex CLI:

code

codex mcp add veezee --url https://mcp.veezee.io/all

Cursor (.cursor/mcp.json or ~/.cursor/mcp.json):

json

{
  "mcpServers": {
    "veezee": { "url": "https://mcp.veezee.io/all" }
  }
}

VS Code (.vscode/mcp.json):

json

{
  "servers": {
    "veezee": { "type": "http", "url": "https://mcp.veezee.io/all" }
  }
}

claude.ai: Settings > Connectors > Add custom connector > https://mcp.veezee.io/all (or a single-platform mount).

More clients (Windsurf, Cline, Zed, plain REST), each snippet verified against the client's official docs: https://veezee.io/docs/clients

REST twin

Every tool has a REST route with identical semantics at https://api.veezee.io (contract: https://veezee.io/openapi.json). A typed TypeScript SDK and CLI ship as @veezee/sdk (docs: https://veezee.io/docs/sdk).

Install

Tools (6)

x_searchx_get_profilex_get_tweetsx_get_tweetx_resolve_urlget_usage

Remote endpoint

Streamable HTTP

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

url

https://mcp.veezee.io/x

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "x-twitter": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.veezee.io/x"
      ]
    }
  }
}

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

Topics

x_search

x_get_profile

x_get_tweets

x_get_tweet

x_resolve_url

get_usage

Veezee MCP server

Mounts

The 17 tools

Keyless quickstart

Install

REST twin

Links

Install

Remote endpoint