bill-commons

Tools

Token cost is the o200k count of the tools list JSON, including schemas, before any tool is called.

• search_legislation

  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"

• get_bill_record

  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

• compare_bill_versions

  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 ver

• find_similar_bills

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

• get_vote_details

  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.

• trace_legislative_history

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

• build_legislative_evidence_packet

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

• get_jurisdiction_coverage

  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

• get_active_sessions

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

• list_topics

  List Bill Commons' curated cross-state topic trackers (e.g. artificial intelligence, youth online safety, platform accountability, cybersecurity, cryptocurrency, data privacy, local government