# Tool reference

| Tool | Required input | Optional input | Purpose |
| --- | --- | --- | --- |
| `get_user_by_username` | `username` | - | Get a public user profile by username without `@`. |
| `get_user_by_id` | `user_id` | - | Get a public user profile by numeric user ID. |
| `get_user_tweets` | `user_id` | `count`, `cursor` | Get posts published by a user. Default count: 20. |
| `get_user_replies` | `user_id` | `count`, `cursor` | Get posts and replies published by a user. Default count: 20. |
| `get_user_media` | `user_id` | `count`, `cursor` | Get media posts published by a user. Default count: 20. |
| `get_followers` | `user_id` | `count`, `cursor` | Get followers of a user. Default count: 20. |
| `get_following` | `user_id` | `count`, `cursor` | Get accounts followed by a user. Default count: 20. |
| `get_tweet_detail` | `tweet_id` | - | Get full details for one public post. |
| `search_tweets` | `query` | `search_type`, `cursor` | Search public posts. `search_type` defaults to `Latest` and also supports `Top`. |
| `get_trending` | - | - | Get current Twitter/X trending topics. |

## Example prompts

- `Search the latest public posts about "AI agents" and summarize the recurring themes.`
- `Look up @openai, then review its recent posts and identify the most discussed topics.`
- `Get the followers of this user ID, continue one cursor page, and group the public profiles by description.`
- `Fetch this tweet ID and preserve the source text and engagement fields in the answer.`

## Pagination

Timeline, follower, following, media, reply, and search results may return a cursor. Pass that cursor into the same tool to request the next page. Store the last processed IDs when building recurring jobs so retries do not duplicate downstream work.