美國國會法案搜尋 (Congress.gov)

us_search_bills

台灣專屬MIT

**關鍵字 / 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.

輸入 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"
}

呼叫方式

配置好 Twinkle Hub 的 MCP client 後，agent 會看到 us_search_bills。直接讓它呼叫即可，例如：

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

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

尚未設定 Client？

Claude Desktop 約 3 分鐘即可完成設定 — 下載 .mcpb 檔案並雙擊即可，或參閱文件中的各 Client 安裝步驟。

查看使用者設定文件

輸入 schema

呼叫​方式

呼叫方式