search_tweets
Search tweets by query and retrieve engagement metrics to measure performance, track mentions, and analyze replies.
Instructions
Search for tweets matching a query and return results with engagement metrics
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>"
},
"name": "search_tweets"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search query string (supports Twitter search operators) | |
| max_results | No | Maximum number of tweets to return (10-100, default: 10) | |
| start_time | No | ISO 8601 date string for earliest tweet (e.g., 2026-01-20T00:00:00Z) |