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

X

readXTimeline

Read X Timeline

Read X (Twitter) posts newest first: with a handle, that account's own recent posts; without one, the member's own home timeline.

readexternal

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "what's on my X timeline", and it calls readXTimeline.

Example call

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

{
  "arguments": {},
  "name": "readXTimeline"
}

Arguments

• maxResultsintegeroptionalPosts to return, 1 to 100 (default 20). Each is billed.
• usernamestringoptionalA handle, with or without "@", to read that account's posts. Leave unset for your own home timeline.

Returns

The registry does not declare a return shape.

Declared limits

• maxResults: minimum 1
• maxResults: maximum 100
• username: minimum length 1
• username: maximum length 16

Ask for it

The Cloud routes these requests to this verb.

• what's on my X timeline
• show my Twitter feed
• what has @name been posting

Pair it with

The verbs that finish the job.

• readXPost
• readXUser
• replyOnX

Questions

• What does readXTimeline do?

  Read X (Twitter) posts newest first: with a handle, that account's own recent posts; without one, the member's own home timeline. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use readXTimeline 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 "what's on my X timeline", and it calls readXTimeline.

• Is readXTimeline safe to let an AI call?

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