query
(string, optional) — Custom search query. Omitting returns mentions of your account.
How to use it
query is exposed by the Twitter MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the query tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
Install Twitter MCP
npx @muhammadsiddiq/twitter-mcpOther tools in Twitter MCP (25)
(enum: "like" "retweet" "bookmark") — Action to perform
(string, max 280) — Text to display above the quoted tweet
(string, 1–10000 chars) — Full text to publish. Use double newlines to indicate tweet breaks.
the thread's conversation ID
URL to the first tweet on X/Twitter
, name, username, description, profileimageurl
(string) — Local path to image (absolute or relative)
(number, optional, default 10) — Results to return (5–100).
array of media items, each with type, url, previewimageurl, width, height, durationms, and variants (for videos/GIFs)
total count
resultcount and optional nexttoken for pagination
(if set)
(followers/following/tweet/listed counts)
the ID of the quoted tweet
(last 5 original tweets with engagement metrics)
(string, optional) — ID of a tweet to reply to
(string) — ID of the tweet to quote
(string) — Tweet content
array of tweets ordered oldest-first with id, text, authorid, createdat, engagement metrics, and inreplytotweetid
count of tweets in the thread
(string) — ID of the tweet in the thread
URL to the quote tweet on X/Twitter
array with id, text, authorid, authorusername, createdat, likecount, retweetcount, replycount
(string) — Twitter handle (without @)
, protected, location, url, createdat