List Twitter profile tweets
twitter_profile_tweets_listRetrieve tweets from an X profile by handle or numeric user ID, with cursor-based pagination and options to include replies or pinned tweets.
Instructions
List tweets from an X profile by handle or numeric user id. Requires handle. Returns a list (use cursor when paginated).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"handle": "<handle>",
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "twitter_profile_tweets_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| by | No | Treat the path value as a handle or a numeric user id. Defaults to id when the value is all digits. | |
| limit | No | Requested page size (1–100). Best-effort; the actual page size may differ. | |
| cursor | No | Opaque pagination cursor returned by a previous response. | |
| handle | Yes | Required. X (Twitter) profile handle without the leading @, or a numeric user id. | |
| context | Yes | Describe the user's underlying goal in one sentence, not the tool you are calling. | |
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (for example "claude-opus-4-8" or "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" and do not guess. | |
| includePinned | No | When true, includes the pinned tweet when available. | |
| includeReplies | No | When true, includes reply tweets. Defaults to false. | |
| conversation_id | No | Echo the conversation_id from the server's previous response. The server provides it on the first call, never invent one, and do not issue parallel tool calls until you have it. |