Home / Servers / X (Twitter) API / search_posts_recent
Search Recent Posts
An MCP tool from the X (Twitter) API server, hosted on mcp.hjlabs.in.
Search Recent Posts Retrieves Posts from the last 7 days matching a search query. At most one of start_time, since_id may be provided. At most one of end_time, until_id may be provided. At most one of pagination_token… [GET /2/tweets/search/recent]
Name on the gateway: x_api__search_posts_recent · read-only.
Parameters
| Name | Type | Description |
|---|---|---|
query required | string | query parameter |
max_results | integer | max_results parameter |
next_token | string | A base32hex-encoded pagination token. |
pagination_token | string | A base32hex-encoded pagination token. |
start_time | string | Must be within the last 7 days. |
end_time | string | end_time parameter |
since_id | string | since_id parameter |
until_id | string | until_id parameter |
sort_order | recency | relevancy | sort_order parameter |
post.fields | array | A comma separated list of Post fields to display. |
expansions | array | A comma separated list of fields to expand. |
user.fields | array | A comma separated list of User fields to display. |
media.fields | array | A comma separated list of Media fields to display. |
poll.fields | array | A comma separated list of Poll fields to display. |
place.fields | array | A comma separated list of Place fields to display. |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "x_api__search_posts_recent",
"arguments": {
"query": "…"
}
}Or connect the X (Twitter) API server directly, which lists 258 tools including this one:
claude mcp add --transport http hj-x-api https://mcp.hjlabs.in/mcp/x-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the search recent posts tool with query set to ….