US Congress members directory

us_search_members

TW-specificMIT

**關鍵字 / Keywords**: 美國國會議員參議員眾議員國會議員州別 congress member senator representative house senate state district bioguide legislator

Scope: US Senators + Representatives (past and present).

List members from Congress.gov's member directory, optionally
filtered by state / district / current-membership.

Endpoint:
    GET https://api.congress.gov/v3/member[/{state}[/{district}]]

Args:
    state_code: 2-letter USPS state code (`CA`, `TX`, `NY`, ...).
                None → all states.
    district: House district integer (0 = at-large / non-voting
              delegate). Requires `state_code`.
    current_member: True = only currently-serving (default);
                    False = only historical; None = both.
    limit: max rows (default 20, Congress.gov cap 250).
    offset: pagination offset.

Returns dict with `members` — each row has `bioguide_id` (the
stable member key used by `us_get_member_voting`), `name`,
`party`, `state`, `district`, `chambers_served[]`, term year
range, `image_url`, `original_url` (www.congress.gov reader).
License: US Public Domain.

Input schema

{
  "properties": {
    "state_code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State Code"
    },
    "district": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "District"
    },
    "current_member": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": true,
      "title": "Current Member"
    },
    "limit": {
      "default": 20,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "title": "us_search_membersArguments",
  "type": "object"
}

How to call

Once your Twinkle Hub MCP client is configured, your agent will see us_search_members. Just ask it to call — example:

# Ask Claude / any MCP client:
請用 us_search_members 處理 "…"。

# It will call:
us_search_members(input="…")

Haven't set up a client yet?

Claude Desktop in 3 minutes — download the .mcpb and double-click, or see docs for other clients.

See user docs