Read a user's recent posts
x_user_postsRead posts authored by an X user by username or numeric ID, with filters to exclude replies and retweets and to bound results by time or post ID.
Instructions
Read posts authored by an X user. The username is resolved to a user ID first when needed. Read-only.
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": {
"user": "<user>"
},
"name": "x_user_posts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user | Yes | Username with optional @, or numeric user ID. | |
| exclude | No | Exclude replies and/or retweets. | |
| end_time | No | RFC 3339 end time. | |
| since_id | No | Return posts newer than this ID. | |
| until_id | No | Return posts older than this ID. | |
| expansions | No | X API expansions, for example author_id,attachments.media_keys,referenced_posts. | |
| start_time | No | RFC 3339 start time. | |
| max_results | No | Page size accepted by GET /2/users/{id}/tweets. | |
| poll_fields | No | Mapped to poll.fields. | |
| post_fields | No | Mapped to the current query parameter post.fields. | |
| user_fields | No | Mapped to user.fields. | |
| media_fields | No | Mapped to media.fields. | |
| place_fields | No | Mapped to place.fields. | |
| pagination_token | No | Opaque next_token from a previous page. |