# bill-commons MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/org-billcommons-bill-commons
- Repository: https://github.com/GDACS-droid/billcommons
- Website: https://billcommons.org

## Install
- Endpoint: https://mcp.billcommons.org/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://mcp.billcommons.org/mcp

## Tools
- search_legislation - 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 fallback when the exact query has no hits. `q` can
    ALSO be a bill number ("HB 123", "H.B. 123", "hb123" all match) and
    that fast path is tried first. Optionally filter by jurisdiction
    (two-letter state code or name), chamber, and status.

    For a curated cross-state slice of a subject (e.g. "every AI bill in the
    country") rather than an ad-hoc keyword search, call list_topics first --
    its membership rules also match on structured subject tags this
    full-text search does not see. Endpoint: https://mcp.billcommons.org/mcp
- get_bill_record - 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). Endpoint: https://mcp.billcommons.org/mcp
- compare_bill_versions - 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
    official document). Endpoint: https://mcp.billcommons.org/mcp
- find_similar_bills - Find bills with similar titles via deterministic trigram similarity,
    across jurisdictions. Labeled 'derived' -- not an official
    cross-reference or companion-bill designation. Endpoint: https://mcp.billcommons.org/mcp
- get_vote_details - 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. Endpoint: https://mcp.billcommons.org/mcp
- get_upcoming_hearings - List upcoming (future-dated) legislative hearings/events, optionally
    filtered by jurisdiction and/or bill. Endpoint: https://mcp.billcommons.org/mcp
- trace_legislative_history - Full chronological legislative history for a bill: merged timeline of
    actions, version publications, and votes, plus related-bill links. Endpoint: https://mcp.billcommons.org/mcp
- build_legislative_evidence_packet - 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 human
    `permalink`, a JSON `download_url`, and a `snapshot_id` that changes if and
    only if a cited fact about the bill changes -- so a reader can check later
    whether the citation still holds. Snapshots are NOT archived; the id is a
    change detector, not a way to retrieve an older packet.

    Pass `question` to record what the packet was assembled to answer; it is
    echoed into the artifact so a filed packet carries its own scope. Endpoint: https://mcp.billcommons.org/mcp
- get_jurisdiction_coverage - Return the jurisdiction_coverage state-machine status for one state
    (abbreviation or name), or the full 51-jurisdiction coverage matrix if
    state is omitted. Endpoint: https://mcp.billcommons.org/mcp
- get_active_sessions - List legislative sessions currently flagged active, optionally
    filtered by jurisdiction (two-letter state code or name). Endpoint: https://mcp.billcommons.org/mcp
- list_topics - 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 states + DC" and "how do I get every bill in one".
    Each topic is a title/subject membership rule tuned for precision over
    recall, with a live bill_count and how_to_fetch_bills. This tool does
    not itself return bill rows -- pair it with search_legislation or the
    REST API's /topics/{slug} for the bills. Endpoint: https://mcp.billcommons.org/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: org.billcommons
- Version: 1.0.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 28, 2026
- Source: https://registry.modelcontextprotocol.io