Home / Servers / X (Twitter) API / get_users_pinned_lists

Get Pinned Lists

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

Get Pinned Lists Retrieves a list of Lists pinned by the authenticated user. [GET /2/users/{id}/pinned_lists]

Name on the gateway: x_api__get_users_pinned_lists · read-only.

Parameters

NameTypeDescription
id requiredstringUnique identifier of a User
list.fieldsarrayA comma separated list of List fields to display.
expansionsarrayA comma separated list of fields to expand.
user.fieldsarrayA comma separated list of User 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__get_users_pinned_lists",
  "arguments": {
    "id": "…"
  }
}

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 get pinned lists tool with id set to ….

More from X (Twitter) API