MCP.Market

Bill Commons MCP server

online · 100% uptime
by billcommons.org·org.billcommons/bill-commons·v1.0.0

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

A87/100grade A
What users say
No reviews yet
Be the first
Safety scan
A87/100

full report

Adoption
Growing

0 stars

Reviews

Write one

Nobody has reviewed Bill Commons yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Bill Commons tools (11)

write = sends, deletes, buys or posts
  • build_legislative_evidence_packetFree

    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.

  • compare_bill_versionsFree

    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).

  • find_similar_billsFree

    Find bills with similar titles via deterministic trigram similarity, across jurisdictions. Labeled 'derived' -- not an official cross-reference or companion-bill designation.

  • get_active_sessionsFree

    List legislative sessions currently flagged active, optionally filtered by jurisdiction (two-letter state code or name).

  • get_bill_recordFree

    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).

  • get_jurisdiction_coverageFree

    Return the jurisdiction_coverage state-machine status for one state (abbreviation or name), or the full 51-jurisdiction coverage matrix if state is omitted.

  • get_upcoming_hearingsFree

    List upcoming (future-dated) legislative hearings/events, optionally filtered by jurisdiction and/or bill.

  • get_vote_detailsFree

    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_topicsFree

    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.

  • search_legislationFree

    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.

  • trace_legislative_historyFree

    Full chronological legislative history for a bill: merged timeline of actions, version publications, and votes, plus related-bill links.

Public scan report

scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it

no findings
  • –Code scanremote-only server, no package to scann/a
  • Live reliabilityremote reachable in 754ms20/20
  • Tool poisoning11 tool descriptions checked15/15
  • Auth qualityopen endpoint, read-only tools10/15
  • Maintenancelast push 4 days ago15/15
  • Maintainer identitynamespace and repository owner differ; website matches verified namespace5/10
Overall 87/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Bill Commons compares

Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
87/100
higher than 78% of 3,470 Web search servers
Tools
11
the typical Web search server has 5
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Uptime
100%
of our recent checks; the typical remote Web search server answers 100%
Response time
134 ms
faster than 82% of 2,238 Web search servers

What its tools let an agent do: 11 read

Install Bill Commons in Claude Code, Cursor or VS Code

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

What the publisher says

From the Bill Commons repository's README, as published. We do not edit it. Read it on GitHub

Bill Commons

Bill Commons is a public, open-source legislative search platform covering the current session/biennium for all 50 U.S. states plus DC. It provides a web search UI, a REST API, an MCP (Model Context Protocol) server, and a public status/coverage page. Public infrastructure first: no paywall on ordinary search or reasonable API use — anonymous callers get a generous daily cap (2,000 requests/day per IP, 5,000/day per /24 subnet); a free API key raises that further, and only high-volume/bulk use is paid. See /docs/bulk for API keys and full-corpus snapshots.

See docs/architecture/ARCHITECTURE.md for the locked architecture and data model.

Production

https://status.billcommons.org)

  • Web: https://billcommons.org (search UI + public status/coverage page at

https://api.billcommons.org/docs

  • API: https://api.billcommons.org/api/v1 — interactive OpenAPI docs at
  • MCP (Streamable HTTP): https://mcp.billcommons.org/mcp

Hosted on Railway (project billcommons: api, mcp, worker services + managed Postgres) and Vercel (project billcommons-web). See docs/operations/deployment-runbook.md for the full deploy/rollback procedure.

Use with Claude (or any MCP client)

The hosted MCP server gives AI assistants direct access to all 209k+ bills — no API key, no setup beyond one command:

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

Claude Desktop: Settings → Connectors → Add custom connector with URL https://mcp.billcommons.org/mcp. Cursor and other clients: add the same URL as a Streamable HTTP server in mcp.json.

Ten tools including searchlegislation, getbillrecord, comparebillversions, and tracelegislative_history. Full walkthrough (including REST recipes for agents without MCP): https://billcommons.org/docs/agents

Architecture at a glance

┌─────────────┐
   users ─────────▶ │  apps/web   │  Next.js, billcommons.org
                    │ (Vercel)    │  status.billcommons.org (rewrite → /coverage)
                    └──────┬──────┘
                           │ HTTPS (NEXT_PUBLIC_API_BASE)
                           ▼
                    ┌─────────────┐        ┌──────────────┐
                    │  apps/api   │◀──────▶│  apps/mcp    │  Streamable HTTP
                    │  FastAPI    │        │  10 MCP tools│  mcp.billcommons.org
                    │ /api/v1     │        └──────────────┘
                    │ api.billcommons.org
                    └──────┬──────┘
                           │ reads (SQLAlchemy)
                           ▼
                    ┌─────────────────────────────┐
                    │   Postgres 16 (Railway)      │
                    │  jurisdictions, sessions,     │
                    │  bills, actions, sponsorships,│
                    │  votes, ingest_jobs, coverage  │
                    └──────────────▲──────────────┘
                                   │ writes (idempotent upserts)
                    ┌──────────────┴──────────────┐
                    │  workers/ingest (worker s

packages/schema (SQLAlchemy models + Alembic) is the single source of truth every other package/app imports from — no service owns its own copy of the data model.

Monorepo layout

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Bill Commons: common questions

Is Bill Commons MCP server safe?
Yes, by our scan: it is graded A (87/100). Read the Bill Commons safety report
How do I install Bill Commons?
It runs remotely at mcp.billcommons.org. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
Does Bill Commons need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Bill Commons maintained?
The last commit was 44 days ago (2026-09-21). The latest release is v1.0.0.
Is Bill Commons up?
100% of our last 28 checks got an answer. We check remote servers about four times a day.
What can I use instead of Bill Commons?
Servers from other publishers that do the same job: Arxiv MCP server, Pubmed MCP server and Misakanet MCP server.
How does Bill Commons compare with other Web search MCP servers?
safety score 87/100 (higher than 78% of 3,470 Web search servers); tools 11 (the typical Web search server has 5); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Bill Commons

Same job from other publishers: the closest match first, then the best rated.

  • Arxiv
    Search arXiv papers, download full text, semantic search, citation graphs, and alerts via MCP.
    A
  • Pubmed
    Search PubMed/Europe PMC, fetch articles and full text (PMC/EPMC/Unpaywall), citations, MeSH terms.
    A
  • Misakanet
    Failure-memory layer for coding agents: search evidence-rated failure lessons by error text.
    A
  • Zotero MCP
    Search your Zotero library, retrieve item metadata, and read full text from AI assistants.
    B
  • PubMed Search
    Multi-source biomedical literature search: PubMed, Europe PMC, OpenAlex, full text, citations
    B