MCP server

Bill Commons Official

org.billcommons/bill-commons

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Search 209k+ US state bills, all 50 states + DC: full text, sponsors, votes, status. Free.

Website Source

At a glance

Type

MCP server

Publisher

billcommons.org (verified by the MCP Registry)

Status

Working at last check

Tools

10

Token cost

About 2,102 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http bill-commons https://mcp.billcommons.org/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.bill-commons]
url = "https://mcp.billcommons.org/mcp"

Gemini CLI

{"mcpServers":{"bill-commons":{"httpUrl":"https://mcp.billcommons.org/mcp"}}}

Cursor

{"mcpServers":{"bill-commons":{"url":"https://mcp.billcommons.org/mcp"}}}

VS Code

{"servers":{"bill-commons":{"type":"http","url":"https://mcp.billcommons.org/mcp"}}}

Antigravity

agy mcp add bill-commons https://mcp.billcommons.org/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"bill-commons","server_url":"https://mcp.billcommons.org/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"bill-commons","server_url":"https://mcp.billcommons.org/mcp"}

Tools

• build_legislative_evidence_packet ~333 tokens
  Compile a citation-ready evidence packet for a bill: full official record, legislative history timeline, votes with member-level detail, and hearings -- each explicitly labeled official vs. derived with source URLs. Returns a `how_to_cite` block with a one-line `cite_as` sentence, a hum
• compare_bill_versions ~208 tokens
  Deterministic diff (unified + structured) between two versions of a bill's extracted text. Defaults to earliest vs. latest texted version if version ids are omitted. Errors if fewer than 2 versions have extracted text. Result is labeled 'derived' (computed by Bill Commons, not an off
• find_similar_bills ~135 tokens
  Find bills with similar titles via deterministic trigram similarity, across jurisdictions. Labeled 'derived' -- not an official cross-reference or companion-bill designation.
• get_active_sessions ~103 tokens
  List legislative sessions currently flagged active, optionally filtered by jurisdiction (two-letter state code or name).
• get_bill_record ~265 tokens
  Fetch the full record for one bill: metadata, sponsors, subjects, actions, versions, and vote-event summaries. Look up by canonical bill_id (UUID), or by jurisdiction + identifier (+ optional session to disambiguate). For a human bill number like HB 123, use jurisdiction="NC", identi
• get_jurisdiction_coverage ~210 tokens
  Return the jurisdiction_coverage state-machine status for one state (abbreviation or name), or the full stored coverage matrix if state is omitted. Public-registry and unlisted row counts are explicit. Includes bounded retained official-source observation health and evidence links. Cover
• get_vote_details ~139 tokens
  Fetch vote event(s) with member-level (yes/no/other/absent) vote records. Provide vote_event_id for one vote, or bill_id for all recorded votes on that bill.
• list_topics ~214 tokens
  List Bill Commons' curated cross-state topic trackers (e.g. artificial intelligence, youth online safety, platform accountability, cybersecurity, cryptocurrency, data privacy, local government & preemption) -- the entry point for "what subjects does Bill Commons track across all 50 s
• search_legislation ~393 tokens
  Search FULL BILL TEXT -- not just known-bill-number lookup. `q` is matched against titles, descriptions, AND ingested document text via Postgres websearch_to_tsquery (supports "quoted phrases", OR, and -exclusion, same syntax as a search engine), with a fuzzy pg_trgm title-similarity
• trace_legislative_history ~102 tokens
  Full chronological legislative history for a bill: merged timeline of actions, version publications, and votes, plus related-bill links.

Browse

• Web search
• Databases
• APIs and testing
• Crypto and blockchains

Related MCP servers

• Openstates
  Search bills, legislators, committees, and events across all 50 US states, DC, and 5 US territories.
• Openstates
  OpenStates MCP — bills, legislators, votes in all 50 US states
• Rootz Officials
  Origin-signed US political data: 25,546 officials, bills, votes, positions with sources.
• Legiscan
  LegiScan MCP — wraps the LegiScan API (api.legiscan.com)
• Legislation
  U.S. bills, roll-call votes, legislators and 2026 elections for all 50 states, D.C. and Congress.
• Georgia Commons
  Georgia's Code, bills, Supreme Court opinions, and 2026 House and Senate meetings. Independent.
• UK Legal Research
  UK legal research — case law, legislation, Hansard, bills, votes, committees, HMRC, citations
• Uk Parliament
  UK Parliament MCP — Members, Bills, Hansard APIs

Badge for your README

[![AptLynx](https://aptlynx.net/badge/org.billcommons/bill-commons.svg)](https://aptlynx.net/servers/org.billcommons/bill-commons)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents