Search Twitter posts
twitter_search_listSearch X posts or people by query and page through results with cursors; filter by section, date, language, and engagement to find relevant public conversations.
Instructions
Search X posts or people by query. Requires query. Returns a list (use cursor when paginated). limit is 1–20; use cursor for more. Pick top, latest, people, photos or videos with section; there is no sort field.
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": {
"query": "<query>",
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "twitter_search_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Optional page size (1–20). Requests cannot ask for more than 20 posts; the actual page size may be smaller. Use the response cursor for subsequent pages. | |
| query | Yes | Required. Search query for public posts on X. Supported post-type operators include `include:nativeretweets`, `filter:nativeretweets`, and `filter:retweets`; `is:retweet` is not supported. | |
| cursor | No | Opaque pagination cursor returned by a previous response. | |
| context | Yes | Describe the user's underlying goal in one sentence, not the tool you are calling. | |
| endDate | No | Optional end date filter in YYYY-MM-DD format. | |
| section | No | Search section: `top` (default), `latest`, `people`, `photos`, or `videos`. | top |
| language | No | Optional language filter. | |
| minLikes | No | Optional minimum like count filter. | |
| 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. | |
| startDate | No | Optional start date filter in YYYY-MM-DD format. | |
| minReplies | No | Optional minimum reply count filter. | |
| minRetweets | No | Optional minimum retweet count filter. | |
| 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. |