billcommons

endpoint

https://mcp.billcommons.org/mcp

protocol

http-sse ·2025-06-18

authentication

none observed

public key

none — nobody has proven they own this listing · is it yours? claim it

karma

0 · newcomer

Is billcommons live?

Yes — it answered the hub's last check (checked 1h ago). It answered 100% of checks over the last 30 days.

Is billcommons free to use?

Yes — the hub reached it with no key and no payment.

What tools does billcommons have?

10 tools: find_similar_bills, search_legislation, build_legislative_evidence_packet, compare_bill_versions, trace_legislative_history, get_bill_record, get_jurisdiction_coverage, get_active_sessions, ….

Is billcommons safe to connect?

The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

• get_bill_record reads open 1h ago

  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.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859

  {
    "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
      }
    }
  }

  arguments 59 lines copy
• get_jurisdiction_coverage reads open 1h ago

  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.

  mcp-tool

  123456789101112131415161718

  {
    "type": "object",
    "title": "get_jurisdiction_coverageArguments",
    "properties": {
      "state": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "State",
        "default": null
      }
    }
  }

  arguments 18 lines copy
• get_active_sessions reads open 11h ago

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

  mcp-tool

  123456789101112131415161718

  {
    "type": "object",
    "title": "get_active_sessionsArguments",
    "properties": {
      "jurisdiction": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Jurisdiction",
        "default": null
      }
    }
  }

  arguments 18 lines copy
• get_vote_details reads open 11h ago

  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.

  mcp-tool

  123456789101112131415161718192021222324252627282930

  {
    "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
      }
    }
  }

  arguments 30 lines copy
• list_topics reads open 11h ago

  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.

  mcp-tool

  12345

  {
    "type": "object",
    "title": "list_topicsArguments",
    "properties": {}
  }

  arguments 5 lines copy
• find_similar_bills reads unknown 1h ago

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

  mcp-tool

  12345678910111213141516171819202122232425

  {
    "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"
      }
    }
  }

  arguments 25 lines copy
• search_legislation reads unknown 15h ago

  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.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061

  {
    "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
      }
    }
  }

  arguments 61 lines copy
• build_legislative_evidence_packet reads unknown 15h ago

  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.

  mcp-tool

  123456789101112131415161718192021222324252627282930

  {
    "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
      }
    }
  }

  arguments 30 lines copy
• compare_bill_versions reads unknown 15h ago

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

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637

  {
    "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
      }
    }
  }

  arguments 37 lines copy
• trace_legislative_history reads unknown 8h ago

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

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "title": "trace_legislative_historyArguments",
    "required": [
      "bill_id"
    ],
    "properties": {
      "bill_id": {
        "type": "string",
        "title": "Bill Id"
      }
    }
  }

  arguments 13 lines copy

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.