1. Docs
2. /
3. Tool reference
4. /
5. X
6. /
7. searchXPosts

X

searchXPosts

Search X Posts

Search recent X (Twitter) posts from the last seven days.

readexternal

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "search X for", and it calls searchXPosts.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "query": "<query>"
  },
  "name": "searchXPosts"
}

Arguments

• maxResultsintegeroptionalPosts to return, 10 to 100 (default 10). Each is billed.
• querystringrequiredX search query, e.g. "convex lang:en -is:retweet"

Returns

The registry does not declare a return shape.

Declared limits

• maxResults: minimum 10
• maxResults: maximum 100
• query: minimum length 1
• query: maximum length 512

Ask for it

The Cloud routes these requests to this verb.

• search X for
• what are people saying on Twitter about
• find recent tweets about

Pair it with

The verbs that finish the job.

• readXPost
• readXUser

Questions

• What does searchXPosts do?

  Search recent X (Twitter) posts from the last seven days. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use searchXPosts from Claude or ChatGPT?

  Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "search X for", and it calls searchXPosts.

• Is searchXPosts safe to let an AI call?

  searchXPosts is read-only: it changes nothing. It reaches a system outside The Cloud on your behalf.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.