Search Spaces

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

Search Spaces Retrieves a list of Spaces matching the specified search query. [GET /2/spaces/search]

Name on the gateway: x_api__search_spaces · read-only.

Parameters

Name	Type	Description
`query` required	`string`	query parameter
`state`	`live \| scheduled \| all`	state parameter
`max_results`	`integer`	max_results parameter
`space.fields`	`array`	A comma separated list of Space 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.
`topic.fields`	`array`	A comma separated list of Topic 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__search_spaces",
  "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"

Use the search spaces tool with query set to ….