US Congress bill search

us_search_bills

TW-specificMIT

**關鍵字 / Keywords**: 美國國會法案眾議院參議院提案表決議員 congress bill house senate legislation vote sponsor amendment 118th 119th HR resolution

Scope: US Congress bills via Congress.gov (Library of Congress).

Paginated catalog of bills for one Congress (+ optional type / date
window). Not a full-text search — Congress.gov's `/v3/bill` family
is a directory; for keyword search within a bill's text use the
GovInfo BILLS collection via a separate call.

Endpoint:
    GET https://api.congress.gov/v3/bill/{congress}[/{bill_type}]

Args:
    congress: Congress number (e.g. 118 for 2023-2024, 119 for
              2025-2026). None → hits `/v3/bill` for the latest.
    bill_type: hr (House bill) · s (Senate bill) · hjres / sjres
               (joint resolutions) · hconres / sconres (concurrent)
               · hres / sres (simple resolutions). None → all types.
    from_date / to_date: YYYY-MM-DD update-date filter.
    limit: max rows (default 20, Congress.gov cap 250).
    offset: pagination offset.

Returns dict with `bills` — each row has `congress`, `bill_type`,
`number`, `title`, `origin_chamber`, `introduced_date`,
`latest_action_date`, `latest_action_text`, `original_url` (link
to www.congress.gov reader page). Plus `total_available` from
Congress.gov pagination metadata. License: US Public Domain
(17 USC §105). Requires `US_CONGRESS_API_KEY` env for signed
rate ceiling (5000/hr); DEMO_KEY fallback ~10 req/hr.

Input schema

{
  "properties": {
    "congress": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Congress"
    },
    "bill_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Bill Type"
    },
    "from_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "From Date"
    },
    "to_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "To Date"
    },
    "limit": {
      "default": 20,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "title": "us_search_billsArguments",
  "type": "object"
}

How to call

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

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

# It will call:
us_search_bills(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