Data Collection
billcommons.org
Provides API tools to search and retrieve legislative information including bills, versions, and vote details.
ENDPOINT 1
https://mcp.billcommons.org/mcp
MCP server metadata
- Name
- billcommons
- Version
- 1.28.1
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'. SCOPE -- what is NOT here. 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.
Known tools 11
get_bill_recordFetch the full record for one bill: metadata, sponsors, subjects, actions, versions, and vote-event summaries.
Inferred read-onlycompare_bill_versionsDeterministic diff (unified + structured) between two versions of a bill's extracted text.
Inferred read-onlyfind_similar_billsFind bills with similar titles via deterministic trigram similarity, across jurisdictions.
Inferred read-onlyget_vote_detailsFetch vote event(s) with member-level (yes/no/other/absent) vote records.
Inferred read-onlyget_upcoming_hearingsList upcoming (future-dated) legislative hearings/events, optionally filtered by jurisdiction and/or bill.
Inferred read-onlytrace_legislative_historyFull chronological legislative history for a bill: merged timeline of actions, version publications, and votes, plus related-bill links.
Inferred read-onlybuild_legislative_evidence_packetCompile 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.
Inferred read-onlyget_jurisdiction_coverageReturn the jurisdiction_coverage state-machine status for one state (abbreviation or name), or the full 51-jurisdiction coverage matrix if state is omitted.
Inferred read-onlyget_active_sessionsList legislative sessions currently flagged active, optionally filtered by jurisdiction (two-letter state code or name).
Inferred read-onlyCONNECT WITH APPROVAL
Client installation
Review this server and its permissions before adding it. Secret placeholders must be set locally.
Codex
~/.codex/config.toml
[mcp_servers.billcommons]
url = "https://mcp.billcommons.org/mcp"
enabled = true
Claude Code
.mcp.json
{
"mcpServers": {
"billcommons": {
"type": "http",
"url": "https://mcp.billcommons.org/mcp"
}
}
}
Claude Desktop
Settings → Connectors → Add custom connector
Name: billcommons
Remote MCP URL: https://mcp.billcommons.org/mcp
Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.
Cursor
.cursor/mcp.json
{
"mcpServers": {
"billcommons": {
"url": "https://mcp.billcommons.org/mcp"
}
}
}
Visual Studio Code
.vscode/mcp.json
Add to Visual Studio Code{
"servers": {
"billcommons": {
"type": "http",
"url": "https://mcp.billcommons.org/mcp"
}
}
}
Generic MCP
Client-specific MCP configuration
{
"name": "billcommons",
"transport": "streamable-http",
"url": "https://mcp.billcommons.org/mcp"
}
MCP Inspector
Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.
TRUST AND VERIFICATION EVIDENCE
Trust Data Available
BuiltWith Trust API v2 evidence for billcommons.org was fetched 2026-08-23T23:58:23.056Z.
billcommons.org is assessed as Neutral: No suspicious signals found, but no strong positive signal either
Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.