org.billcommons/bill-commons is an MCP server published by org.billcommons, hosted at mcp.billcommons.org. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 13 tools, including search_legislation, get_bill_record, compare_bill_versions, find_similar_bills, get_vote_details.
Search 209k+ US state bills, all 50 states + DC: full text, sponsors, votes, status. Free.
11 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| q * | string | |
| limit | any | |
| status |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| any |
| chamber | any |
| jurisdiction | any |
{
"name": "search_legislation",
"description": "Search FULL BILL TEXT -- not just known-bill-number lookup. `q` is\n matched against titles, descriptions, AND ingested document text via\n Postgres websearch_to_tsquery (supports \"quoted phrases\", OR, and\n -exclusion, same syntax as a search engine), with a fuzzy pg_trgm\n title-similarity fallback when the exact query has no hits. `q` can\n ALSO be a bill number (\"HB 123\", \"H.B. 123\", \"hb123\" all match) and\n that fast path is tried first. Optionally filter by jurisdiction\n (two-letter state code or name), chamber, and status.\n\n For a curated cross-state slice of a subject (e.g. \"every AI bill in the\n country\") rather than an ad-hoc keyword search, call list_topics first --\n its membership rules also match on structured subject tags this\n full-text search does not see.",
"inputSchema": {
"type": "object",
"title": "search_legislationArguments",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"title": "Q"
},
"limit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Limit",
"default": null
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Status",
"default": null
},
"chamber": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Chamber",
"default": null
},
"jurisdiction": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Jurisdiction",
"default": null
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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", identifier="HB 123"; bill_id is for UUIDs.
| Parameter | Type | Description |
|---|---|---|
| bill_id | any | |
| session | any | |
| identifier | any | |
| jurisdiction | any | |
| include_full_text | boolean |
{
"name": "get_bill_record",
"description": "Fetch the full record for one bill: metadata, sponsors, subjects,\n actions, versions, and vote-event summaries. Look up by canonical\n bill_id (UUID), or by jurisdiction + identifier (+ optional session to\n disambiguate). For a human bill number like HB 123, use\n jurisdiction=\"NC\", identifier=\"HB 123\"; bill_id is for UUIDs.",
"inputSchema": {
"type": "object",
"title": "get_bill_recordArguments",
"properties": {
"bill_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Bill Id",
"default": null
},
"session": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Session",
"default": null
},
"identifier": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Identifier",
"default": null
},
"jurisdiction": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Jurisdiction",
"default": null
},
"include_full_text": {
"type": "boolean",
"title": "Include Full Text",
"default": false
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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).
| Parameter | Type | Description |
|---|---|---|
| bill_id * | string | |
| version_id_a | any | |
| version_id_b | any |
{
"name": "compare_bill_versions",
"description": "Deterministic diff (unified + structured) between two versions of a\n bill's extracted text. Defaults to earliest vs. latest texted version if\n version ids are omitted. Errors if fewer than 2 versions have extracted\n text. Result is labeled 'derived' (computed by Bill Commons, not an\n official document).",
"inputSchema": {
"type": "object",
"title": "compare_bill_versionsArguments",
"required": [
"bill_id"
],
"properties": {
"bill_id": {
"type": "string",
"title": "Bill Id"
},
"version_id_a": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Version Id A",
"default": null
},
"version_id_b": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Version Id B",
"default": null
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Find bills with similar titles via deterministic trigram similarity, across jurisdictions. Labeled 'derived' -- not an official cross-reference or companion-bill designation.
| Parameter | Type | Description |
|---|---|---|
| limit | any | |
| bill_id * | string |
{
"name": "find_similar_bills",
"description": "Find bills with similar titles via deterministic trigram similarity,\n across jurisdictions. Labeled 'derived' -- not an official\n cross-reference or companion-bill designation.",
"inputSchema": {
"type": "object",
"title": "find_similar_billsArguments",
"required": [
"bill_id"
],
"properties": {
"limit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Limit",
"default": null
},
"bill_id": {
"type": "string",
"title": "Bill Id"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| bill_id | any | |
| vote_event_id | any |
{
"name": "get_vote_details",
"description": "Fetch vote event(s) with member-level (yes/no/other/absent) vote\n records. Provide vote_event_id for one vote, or bill_id for all recorded\n votes on that bill.",
"inputSchema": {
"type": "object",
"title": "get_vote_detailsArguments",
"properties": {
"bill_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Bill Id",
"default": null
},
"vote_event_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Vote Event Id",
"default": null
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Full chronological legislative history for a bill: merged timeline of actions, version publications, and votes, plus related-bill links.
| Parameter | Type | Description |
|---|---|---|
| bill_id * | string |
{
"name": "trace_legislative_history",
"description": "Full chronological legislative history for a bill: merged timeline of\n actions, version publications, and votes, plus related-bill links.",
"inputSchema": {
"type": "object",
"title": "trace_legislative_historyArguments",
"required": [
"bill_id"
],
"properties": {
"bill_id": {
"type": "string",
"title": "Bill Id"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| bill_id * | string | |
| question | any | |
| include_full_text | boolean |
{
"name": "build_legislative_evidence_packet",
"description": "Compile a citation-ready evidence packet for a bill: full official\n record, legislative history timeline, votes with member-level detail, and\n hearings -- each explicitly labeled official vs. derived with source URLs.\n\n Returns a `how_to_cite` block with a one-line `cite_as` sentence, a human\n `permalink`, a JSON `download_url`, and a `snapshot_id` that changes if and\n only if a cited fact about the bill changes -- so a reader can check later\n whether the citation still holds. Snapshots are NOT archived; the id is a\n change detector, not a way to retrieve an older packet.\n\n Pass `question` to record what the packet was assembled to answer; it is\n echoed into the artifact so a filed packet carries its own scope.",
"inputSchema": {
"type": "object",
"title": "build_legislative_evidence_packetArguments",
"required": [
"bill_id"
],
"properties": {
"bill_id": {
"type": "string",
"title": "Bill Id"
},
"question": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Question",
"default": null
},
"include_full_text": {
"type": "boolean",
"title": "Include Full Text",
"default": false
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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. Coverage status measures stored bill/text availability; local coverage timestamps can advance on count recomputation. Statewide semantic freshness remains unverified, including for GREEN coverage.
| Parameter | Type | Description |
|---|---|---|
| state | any |
{
"name": "get_jurisdiction_coverage",
"description": "Return the jurisdiction_coverage state-machine status for one state\n (abbreviation or name), or the full stored coverage matrix if\n state is omitted. Public-registry and unlisted row counts are explicit. Includes bounded retained official-source observation health\n and evidence links. Coverage status measures stored bill/text availability;\n local coverage timestamps can advance on count recomputation. Statewide\n semantic freshness remains unverified, including for GREEN coverage.",
"inputSchema": {
"type": "object",
"title": "get_jurisdiction_coverageArguments",
"properties": {
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "State",
"default": null
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List legislative sessions currently flagged active, optionally filtered by jurisdiction (two-letter state code or name).
| Parameter | Type | Description |
|---|---|---|
| jurisdiction | any |
{
"name": "get_active_sessions",
"description": "List legislative sessions currently flagged active, optionally\n filtered by jurisdiction (two-letter state code or name).",
"inputSchema": {
"type": "object",
"title": "get_active_sessionsArguments",
"properties": {
"jurisdiction": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Jurisdiction",
"default": null
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
No parameters.
{
"name": "list_topics",
"description": "List Bill Commons' curated cross-state topic trackers (e.g. artificial\n intelligence, youth online safety, platform accountability,\n cybersecurity, cryptocurrency, data privacy, local government &\n preemption) -- the entry point for \"what subjects does Bill Commons\n track across all 50 states + DC\" and \"how do I get every bill in one\".\n Each topic is a title/subject membership rule tuned for precision over\n recall, with a live bill_count and how_to_fetch_bills. This tool does\n not itself return bill rows -- pair it with search_legislation or the\n REST API's /topics/{slug} for the bills.",
"inputSchema": {
"type": "object",
"title": "list_topicsArguments",
"properties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Search Bill Commons' bounded, source-labelled frontier-AI policy registry. This is not a comprehensive global or federal legislative database. It returns only the curated records currently held by the registry, including its coverage statement and retrieval timestamps. Use `jurisdiction`, `instrument_type`, `status`, or an exact topic; use `q` for a title, summary, or topic substring. `since` filters source publication dates and `changed_since` filters source-check activity on or after an ISO date; a retrieval or changed source body does not establish a policy change.
| Parameter | Type | Description |
|---|---|---|
| q | any | |
| since | any | |
| topic | any | |
| status | any | |
| jurisdiction | any | |
| changed_since | any | |
| instrument_type | any |
{
"name": "search_policy_developments",
"description": "Search Bill Commons' bounded, source-labelled frontier-AI policy registry.\n\n This is not a comprehensive global or federal legislative database. It\n returns only the curated records currently held by the registry, including\n its coverage statement and retrieval timestamps. Use `jurisdiction`,\n `instrument_type`, `status`, or an exact topic; use `q` for a title,\n summary, or topic substring. `since` filters source publication dates and\n `changed_since` filters source-check activity on or after an ISO date;\n a retrieval or changed source body does not establish a policy change.\n ",
"inputSchema": {
"type": "object",
"title": "search_policy_developmentsArguments",
"properties": {
"q": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Q",
"default": null
},
"since": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Since",
"default": null
},
"topic": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Topic",
"default": null
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Status",
"default": null
},
"jurisdiction": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Jurisdiction",
"default": null
},
"changed_since": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Changed Since",
"default": null
},
"instrument_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Instrument Type",
"default": null
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Retrieve one full, source-labelled policy development by its stable slug. The response can include cited sources, normalized obligations, explicit analysis-only verification mappings, and recorded change history. A null response means only that the slug is absent from this bounded registry; it does not establish that the underlying policy development is absent.
| Parameter | Type | Description |
|---|---|---|
| slug * | string |
{
"name": "get_policy_development",
"description": "Retrieve one full, source-labelled policy development by its stable slug.\n\n The response can include cited sources, normalized obligations, explicit\n analysis-only verification mappings, and recorded change history. A null\n response means only that the slug is absent from this bounded registry; it\n does not establish that the underlying policy development is absent.\n ",
"inputSchema": {
"type": "object",
"title": "get_policy_developmentArguments",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"title": "Slug"
}
}
},
"outputSchema": {
"type": "object",
"title": "get_policy_developmentOutput",
"required": [
"result"
],
"properties": {
"result": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Result"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Build a citation-first comparison of one to twelve registry records. The brief preserves the registry's methodology and limitations and does not produce legal advice, compliance determinations, or a claim that the selected set is exhaustive. Supply stable slugs returned by `search_policy_developments`.
| Parameter | Type | Description |
|---|---|---|
| slugs * | array |
{
"name": "build_policy_brief",
"description": "Build a citation-first comparison of one to twelve registry records.\n\n The brief preserves the registry's methodology and limitations and does\n not produce legal advice, compliance determinations, or a claim that the\n selected set is exhaustive. Supply stable slugs returned by\n `search_policy_developments`.\n ",
"inputSchema": {
"type": "object",
"title": "build_policy_briefArguments",
"required": [
"slugs"
],
"properties": {
"slugs": {
"type": "array",
"items": {
"type": "string"
},
"title": "Slugs"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Bill Commons: public, open-source legislative search for all 50 US states + DC. Tools return structured JSON with canonical ids, official source_url fields, retrieved_at freshness timestamps, and explicit official-vs-derived labeling. Coverage is uneven while ingestion is in progress -- call get_jurisdiction_coverage before relying on an empty result to mean 'no such legislation exists'. LEGACY STATE-LEGISLATION SCOPE -- the state-legislation tools below do not answer these from Bill Commons, and do not report an empty result as evidence that the legislation does not exist: - US CONGRESS. State legislatures only. No federal bills, no H.R./S. numbers, no Congressional committees. - CITY AND COUNTY ORDINANCES. Nothing below the state legislature. A question about a municipal code, city commission, or county board is out of scope even for a state we cover well. (State bills that REGULATE cities -- preemption, home rule, municipal finance -- are in scope and are searchable.) - CURRENT SESSION ONLY. Not an archive; no prior-year sessions. - HEARINGS AND COMMITTEE CALENDARS. Not collected for any state. - LEGISLATOR AND COMMITTEE RECORDS. Not collected. Bill sponsors are available per bill, as bare names without party or district. Bill status is DERIVED by Bill Commons from the action record, not reported by the state. Attribute it accordingly. POLICY-REGISTRY SCOPE -- search_policy_developments, get_policy_development, and build_policy_brief are separate from the state-legislation corpus. They expose only a small, curated, source-labelled set of state, federal, and international frontier-AI policy developments. It is non-exhaustive and may be stale; never treat an empty result as proof that no rule, proposal, agreement, or official update exists. Use the returned source URLs for time-sensitive or legal conclusions.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.