Get user tweets
get_user_tweetsFetches a user's recent X/Twitter profile timeline, including retweets and pinned tweets but excluding replies, with pagination to retrieve older posts.
Instructions
Get a user's recent tweets (their profile timeline, without replies), newest first, including retweets and pinned tweet. Paginated.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_user_tweets"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | How many tweets to request per page (default 20). X may return slightly more or fewer. | |
| cursor | No | Pagination cursor. Leave empty for the first page; pass the next_cursor from a previous result to get the next page. | |
| format | No | Response format (default simple). simple: compact JSON with flat camelCase tweets and users, about 60% fewer tokens. raw: X's full GraphQL JSON, only needed for fields simple leaves out (cards, polls, edit history, community notes). | |
| userId | No | Numeric X user ID (rest_id). Provide this or username. Using the ID is faster. | |
| username | No | X handle, used when you do not have the user ID. Provide this or userId. | |
| max_chars | No | Maximum characters of JSON to return (default 50000). Longer output is cut with a [TRUNCATED] marker. Lower it to save context, raise it if you need the full response. |