Home / Servers / X (Twitter) API / stream_posts_sample

Stream Sampled Posts

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

Stream Sampled Posts Streams a 1% sample of public Posts in real-time. [GET /2/tweets/sample/stream]

Name on the gateway: x_api__stream_posts_sample · read-only.

Parameters

Name	Type	Description
`backfill_minutes`	`integer`	The number of minutes of backfill requested.
`tweet.fields`	`array`	A comma separated list of Tweet fields to display.
`expansions`	`array`	A comma separated list of fields to expand.
`media.fields`	`array`	A comma separated list of Media fields to display.
`poll.fields`	`array`	A comma separated list of Poll fields to display.
`user.fields`	`array`	A comma separated list of User fields to display.
`place.fields`	`array`	A comma separated list of Place fields to display.

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__stream_posts_sample",
  "arguments": {}
}

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"

Use the stream sampled posts tool with backfill_minutes set to ….