# org.billcommons/bill-commons (remote · mcp.billcommons.org)

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

- Trust score: 62/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `mcp.billcommons.org`: 62/100 (this document), [markdown](https://verifymcp.io/servers/org-billcommons-bill-commons/mcp.md), [page](https://verifymcp.io/servers/org-billcommons-bill-commons/mcp)

## Channel facts

- Endpoint: `https://mcp.billcommons.org/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 57/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 10 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 71/100
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 872 tokens (~87/item across 10 items; 10 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 20/100
  - Stability observed for 6 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 67/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 0% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

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

### Codex

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

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "org-billcommons-bill-commons": {
      "type": "remote",
      "url": "https://mcp.billcommons.org/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add org-billcommons-bill-commons --url https://mcp.billcommons.org/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  org-billcommons-bill-commons:
    url: "https://mcp.billcommons.org/mcp"
```

### Other

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

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 62, +1)

- [security] Tool “build_legislative_evidence_packet” rewrote its description, which is the text the model reads
- [functional regression] Schema quality: 74 → 87
- [cosmetic] “build_legislative_evidence_packet” added an optional parameter “question”

### 2026-08-01 (score 61, +1)

No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 60, +2)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 58, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 58, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-07-28 (score 57)

First indexed and scored.

## MCP tools (10)

### `search_legislation` (~95 tokens)

Search bills by keyword/phrase (full-text) or normalized bill number
    (e.g. "HB 123", "H.B. 123", "hb123" all match). Optionally filter by
    jurisdiction (two-letter state code or name), chamber, and status.

Input parameters:

- `chamber`
- `jurisdiction`
- `limit`
- `q` (string, required)
- `status`

### `get_bill_record` (~89 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).

Input parameters:

- `bill_id`
- `identifier`
- `include_full_text` (boolean)
- `jurisdiction`
- `session`

### `compare_bill_versions` (~102 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
    official document).

Input parameters:

- `bill_id` (string, required)
- `version_id_a`
- `version_id_b`

### `find_similar_bills` (~58 tokens)

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

Input parameters:

- `bill_id` (string, required)
- `limit`

### `get_vote_details` (~65 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.

Input parameters:

- `bill_id`
- `vote_event_id`

### `get_upcoming_hearings` (~49 tokens)

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

Input parameters:

- `bill_id`
- `jurisdiction`
- `limit`

### `trace_legislative_history` (~46 tokens)

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

Input parameters:

- `bill_id` (string, required)

### `build_legislative_evidence_packet` (~203 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 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.

Input parameters:

- `bill_id` (string, required)
- `include_full_text` (boolean)
- `question`

### `get_jurisdiction_coverage` (~53 tokens)

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

Input parameters:

- `state`

### `get_active_sessions` (~35 tokens)

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

Input parameters:

- `jurisdiction`

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/org-billcommons-bill-commons/mcp#diagnostics

## Score history

- 2026-08-03: 62
- 2026-08-02: 61
- 2026-08-01: 61
- 2026-07-31: 60
- 2026-07-30: 58
- 2026-07-29: 58
- 2026-07-28: 57

## Links

- Remote endpoint: https://mcp.billcommons.org/mcp
- Repository: https://github.com/GDACS-droid/billcommons
- Website: https://billcommons.org/
- Changelog RSS feed: https://verifymcp.io/servers/org-billcommons-bill-commons/mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/org-billcommons-bill-commons/mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/org-billcommons-bill-commons/mcp