Home / Servers / X (Twitter) API / search_posts_all

Search All Posts

An MCP tool from the X (Twitter) API server, hosted on mcp.hjlabs.in.

Search All Posts Retrieves Posts from the full archive 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… [GET /2/tweets/search/all]

Name on the gateway: x_api__search_posts_all · read-only.

Parameters

NameTypeDescription
query requiredstringquery parameter
start_timestringstart_time parameter
end_timestringend_time parameter
since_idstringsince_id parameter
until_idstringuntil_id parameter
max_resultsintegermax_results parameter
next_tokenstringA base32hex-encoded pagination token.
pagination_tokenstringA base32hex-encoded pagination token.
sort_orderrecency | relevancysort_order parameter
post.fieldsarrayA comma separated list of Post fields to display.
expansionsarrayA comma separated list of fields to expand.
user.fieldsarrayA comma separated list of User fields to display.
media.fieldsarrayA comma separated list of Media fields to display.
poll.fieldsarrayA comma separated list of Poll fields to display.
place.fieldsarrayA 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:

call_tool arguments
{
  "name": "x_api__search_posts_all",
  "arguments": {
    "query": "…"
  }
}

Or connect the X (Twitter) API server directly, which lists 258 tools including this one:

Run in your terminal
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 all posts tool with query set to ….

More from X (Twitter) API