此 MCP 可以做什么
Provides searchable U.S. federal and state legislative data, including bills, texts, votes, legislators, committees, elections and ballot measures.
功能
工具
36
工具
get_ballot_measure
Statewide ballot measures
Ballot measures (GET /v1/measures): the list for a state, or one measure by its number (e.g. 'Amendment 1') with full text, summary and official source URL. Use for 'what's on the ballot in X' and 'what does Amendment N do'.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['state'], 'properties': {'q': {'type': 'string', 'description': 'Title search.'}, 'type': {'type': 'string', 'description': 'Measure type filter.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1}, 'state': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'Postal code.'}, 'number': {'type': 'string', 'description': "Exact measure number (e.g. 'Amendment 1') to fetch one measure."}, 'offset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}
get_bill
Get one bill
Fetch a single bill by its numeric bill_id (GET /v1/bills/{bill_id}), optionally merging in sub-resources: votes (roll calls with tallies), sponsors, history (action timeline), texts (version metadata), amendments, subjects, analyses (staff analyses), calendar (scheduled events), citations (statutes the bill touches), referrals (committee referrals), sast (same-as / similar-to companion bills in the other chamber or other states), supplements (fiscal notes and summaries). analyses and citations are populated only for the deeper-coverage states. Each include is a separate API call, so ask only for what you need. Pass detail:true to get everything in one round trip instead. Get a bill_id from search_bills or semantic_search_bills. status_id values: 1=Introduced, 2=In Committee, 3=Passed One Chamber, 4=Passed Both Chambers, 5=Signed into Law, 6=Vetoed, 7=Failed/Dead, 8=Chaptered. Aggregate buckets: passed={4,5,8}, failed={6,7}, alive={1,2,3}.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['bill_id'], 'properties': {'detail': {'type': 'boolean', 'description': 'true = one request to /v1/bills/{id}/detail with every sub-resource merged (the cheapest way to get everything). Ignores include.'}, 'bill_id': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Numeric bill_id from a search result.'}, 'include': {'type': 'array', 'items': {'enum': ['votes', 'sponsors', 'history', 'texts', 'amendments', 'subjects', 'analyses', 'calendar', 'citations', 'referrals', 'sast', 'supplements'], 'type': 'string'}, 'description': 'Sub-resources to merge into the result: votes, sponsors, history, texts, amendments, subjects, analyses, calendar, citations, referrals, sast, supplements.'}, 'max_items': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Cap on items per included list (default 50).'}}, 'additionalProperties': False}
get_bill_diff
Diff two bill-text versions
Compare two versions of a bill's text (GET /v1/bills/{bill_id}/diff): a unified diff plus similarity, added/removed line and character counts, and changed-section highlights. Get the two version ids from get_bill with include:['texts'] — each text row's `text_id`. Pass them as `from` (the earlier version) and `to` (the later version). Diffs are precomputed, so only bills that have more than one text version return one.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['bill_id', 'from', 'to'], 'properties': {'to': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'Text-version id of the later version to compare against.'}, 'from': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'Text-version id of the earlier version (the baseline).'}, 'bill_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'bill_id the two texts belong to.'}}, 'additionalProperties': False}
get_bill_text
Get the text of one bill version
The cleaned plain text of one bill-text version (GET /v1/texts/{text_id}), entities decoded, ready to quote or summarize. Get text_id from get_bill with include:['texts'] (each version has a date and type). Texts longer than 40,000 characters are clipped with a '[truncated]' marker.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['text_id'], 'properties': {'text_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': "text_id from get_bill include:['texts']."}}, 'additionalProperties': False}
get_bill_text_history
Get every text diff for a bill
Timeline of all computed diffs between successive text versions of one bill (GET /v1/bills/{bill_id}/changes): what changed, when, and how much. Use get_bill_diff for one specific pair of versions. Get bill_id from search_bills or semantic_search_bills.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['bill_id'], 'properties': {'bill_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'bill_id from a search result.'}, 'include_whitespace': {'type': 'boolean', 'description': 'Include whitespace-only changes (default false).'}}, 'additionalProperties': False}
get_candidate
Get a candidate
Fetch one election candidate by id (GET /v1/candidates/{id}): their party, office, district and cycle, plus an FEC filer id where the campaign has filed and a Bioguide id for sitting members of Congress. When people_id is set, the candidate has a legislative voting record — pass it to get_legislator or get_legislator_scorecard to go from candidate to voting history in one hop. Get an id from list_candidates.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'Candidate id from list_candidates or get_midterms.'}}, 'additionalProperties': False}
get_candidate_photo
Candidate portrait URL
The URL of a candidate's official portrait (GET /v1/photos/{candidate_id} returns the image bytes). Sources are official state-legislature and congressional portraits, public-domain and licensed images only — never a third party's photo library — and each carries a license and attribution string that MUST be shown when the license requires it (Wikimedia CC BY). Returns null when the candidate has no accepted portrait — which is the COMMON case: only about a tenth of the 2026 field has one (11%), so design for an initials-avatar default. Candidate rows from list_candidates and get_midterms already include photo_url, so call this only when you have just an id.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['candidate_id'], 'properties': {'candidate_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'Candidate id.'}}, 'additionalProperties': False}
get_changes
Get the bill change feed
Near-real-time feed of what changed (GET /v1/changes). Poll with since=<ISO timestamp> to get everything newer than your cursor; with no since it defaults to the last hour. Reason types include NewBill, StatusChange, Text, Vote and Amendment. Use this for monitoring and incremental sync — 'what moved in Florida since yesterday' — rather than re-scanning search_bills.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Max rows to return (default 50).'}, 'since': {'type': 'string', 'description': 'ISO-8601 cursor. Omit for the last hour. Pass the newest timestamp you have already seen.'}, 'state': {'type': 'string', 'description': '2-letter postal code (e.g. FL), DC, or US for Congress.'}, 'reason': {'type': 'string', 'description': 'Restrict to one change type, e.g. NewBill, StatusChange, Text, Vote, Amendment.'}}, 'additionalProperties': False}
get_committee
Get one committee
Fetch a committee by committee_id (GET /v1/committees/{committee_id}), optionally merging in members (its roster, with roles) and hearings (its scheduled meetings). Find a committee_id with list_committees.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['committee_id'], 'properties': {'include': {'type': 'array', 'items': {'enum': ['members', 'hearings'], 'type': 'string'}, 'description': 'Sub-resources to merge in: members, hearings.'}, 'max_items': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Cap on items per included list (default 50).'}, 'committee_id': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Numeric committee_id.'}}, 'additionalProperties': False}
get_coverage
Get per-state data coverage
Per-state depth snapshot (GET /v1/coverage): how COMPLETE each jurisdiction's data is — bill counts, the share of bills holding at least one vote, text or sponsor, and whether the legislature is currently in session. Use it before drawing conclusions from a thin result set, to tell 'no such bills' apart from 'this state is thinly covered'. Read the completeness ratios rather than the raw percentages: most bills die in committee without ever getting a roll call, so a low pct_with_votes usually reflects the legislature, not a gap in the data. Served from a materialised snapshot; `computed_at` gives its age.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'max_items': {'type': 'integer', 'maximum': 60, 'minimum': 1, 'description': 'Cap on rows returned (default 60 — all jurisdictions).'}}, 'additionalProperties': False}
get_legislator
Get one legislator
Fetch a legislator's profile by people_id (GET /v1/legislators/{people_id}), optionally merging in votes (every roll call they are recorded on, newest first, with their individual position: 1=Yea, 2=Nay, 3=Not Voting, 4=Absent) and bills (legislation they sponsor, with sponsor_type_id 1=primary, 2=cosponsor). Find a people_id with list_legislators or from a bill's sponsors. Corpus is 2026-forward only.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['people_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Rows per included sub-resource (default 25).'}, 'include': {'type': 'array', 'items': {'enum': ['votes', 'bills'], 'type': 'string'}, 'description': 'Sub-resources to merge in: votes, bills.'}, 'people_id': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Numeric people_id (int64 — many exceed int32).'}}, 'additionalProperties': False}
get_legislator_scorecard
Get a legislator's scorecard
One-call voting and sponsorship profile for a legislator (GET /v1/legislators/{people_id}/scorecard): participation, party-line alignment, bills sponsored and passed, notable votes. This is the tool for 'how does X vote' or 'is X effective'. Get people_id from list_legislators (q=name).
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['people_id'], 'properties': {'people_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'people_id from list_legislators.'}}, 'additionalProperties': False}
get_midterms
2026 midterm election slate
The election slate for 2026-11-03 (GET /v1/midterms): races, candidates and ballot measures per state, with official results where available. All data is official state election-office and FEC content collected by Delilah — no third-party attribution is required. live_results carries ONE ENTRY PER CONTEST, each with `contest` (e.g. primary:DEM, runoff:REP) and `party`: a closed primary returns each party separately and vote_pct is the share of THAT party's ballot, so never compare or rank candidates across two contests. Use for 'who is running for X' and results questions. Never call or project a race; report counts exactly as reported.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Candidate or race name search.'}, 'year': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Election year (default 2026).'}, 'level': {'enum': ['federal', 'governor', 'state_executive', 'state_legislative'], 'type': 'string', 'description': 'federal | governor | state_executive | state_legislative'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Max rows (default 50).'}, 'state': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'Postal code. Omit for all states.'}, 'offset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset.'}, 'chamber': {'type': 'string', 'description': 'House | Senate'}}, 'additionalProperties': False}
get_roll_call
Get one roll-call vote
Fetch a roll call by roll_call_id (GET /v1/votes/{roll_call_id}): the motion, chamber, date and yea/nay/absent tallies. Add include:['details'] to also pull how every individual member voted (vote_id 1=Yea, 2=Nay, 3=Not Voting, 4=Absent) — this is the tool for 'how did each legislator vote on this'. Get a roll_call_id from get_bill with include:['votes'].
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['roll_call_id'], 'properties': {'include': {'type': 'array', 'items': {'enum': ['details'], 'type': 'string'}, 'description': "Add 'details' for individual member positions."}, 'max_items': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Cap on member rows returned (default 200 — enough for any single chamber).'}, 'roll_call_id': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Numeric roll_call_id (int64 — may exceed int32).'}}, 'additionalProperties': False}
get_session_breakdown
Bill counts by status or subject
Bill count per status (by:'status', on the status_id ladder) or per subject (by:'subject') for one session (GET /v1/sessions/{id}/status-counts or /subject-counts). Get session_id from list_sessions. status_id values: 1=Introduced, 2=In Committee, 3=Passed One Chamber, 4=Passed Both Chambers, 5=Signed into Law, 6=Vetoed, 7=Failed/Dead, 8=Chaptered. Aggregate buckets: passed={4,5,8}, failed={6,7}, alive={1,2,3}.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['session_id', 'by'], 'properties': {'by': {'enum': ['status', 'subject'], 'type': 'string', 'description': 'Group by status or by subject.'}, 'session_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'session_id from list_sessions (filter by state).'}}, 'additionalProperties': False}
get_session_dashboard
Session dashboard
Headline counts for one legislative session (GET /v1/sessions/{id}/dashboard): bills filed, passed, signed, vetoed, roll calls, active legislators. Start here for 'how is the 2026 Florida session going'. Get session_id from list_sessions.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['session_id'], 'properties': {'session_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'session_id from list_sessions (filter by state).'}}, 'additionalProperties': False}
get_session_sponsor_stats
Top sponsors in a session
Legislators ranked by bills sponsored and passed in one session (GET /v1/sessions/{id}/sponsor-stats). Each row has bills_sponsored, bills_primary, bills_passed, bills_primary_passed and pass_rate (passed = status 4, 5 or 8). This is the one call for 'who is most active or effective this session' and 'which senator passed the most bills': set chamber and sort:'passed' (or 'primary_passed' to count only bills they carried). Committees filed as sponsors are excluded by default. Get session_id from list_sessions.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['session_id'], 'properties': {'sort': {'enum': ['sponsored', 'passed', 'primary_passed', 'pass_rate'], 'type': 'string', 'description': 'Ranking key (default sponsored).'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Max rows (default 40).'}, 'party': {'enum': ['D', 'R'], 'type': 'string', 'description': 'Restrict to one party.'}, 'chamber': {'enum': ['senate', 'house'], 'type': 'string', 'description': 'Restrict to one chamber.'}, 'session_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'session_id from list_sessions (filter by state).'}, 'include_committees': {'type': 'boolean', 'description': 'Include committee sponsor rows (default false).'}}, 'additionalProperties': False}
get_session_vote_participation
Roll-call participation per legislator
How many roll calls each legislator voted in versus missed during one session (GET /v1/sessions/{id}/vote-participation). Use for attendance questions. Get session_id from list_sessions.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['session_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Max rows (default 50).'}, 'session_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'session_id from list_sessions (filter by state).'}}, 'additionalProperties': False}
get_trending_bills
Bills trending in the news
Bills with the most news coverage in the window (GET /v1/trending), optionally for one state. Use for 'what's in the news' or 'hot bills right now'. Returns bill summaries with mention counts; call get_bill for detail.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Look-back window in days (default 7).'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max rows (default 20).'}, 'state': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'Postal code, DC, or US. Omit for all.'}}, 'additionalProperties': False}
get_usage
Your API usage this month
The current key's tier, monthly cap, requests used and remaining, and when the period resets (GET /v1/_meta/usage). Call this when a request is rate-limited (HTTP 429) or the user asks about their plan.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}, 'additionalProperties': False}
get_weekly_stage_breakdown
Fleet-wide counts per stage
One row per stage with the number of bills whose latest action landed there in the window (GET /v1/bills-weekly-breakdown). All jurisdictions combined. Use for a national 'how much moved this week' number; use get_session_dashboard for one state.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Look-back window in days (default 7).'}}, 'additionalProperties': False}
keyword_search_bills
Search bills by exact keywords (all must match)
Keyword search where EVERY term must appear (GET /v1/search/bills). Use when the user gives specific words that all have to be present, e.g. ['short-term rental', 'tax']. Prefer semantic_search_bills for questions and search_bills for structured filters. Up to 10 terms. Returns bill summaries plus pagination. Corpus is 2026-forward only.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['keywords'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max rows (default 25).'}, 'state': {'type': 'array', 'items': {'type': 'string', 'maxLength': 2, 'minLength': 2}, 'description': 'Jurisdictions (postal codes, DC, US). Omit for all.'}, 'offset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset.'}, 'keywords': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 10, 'minItems': 1, 'description': 'Terms that must all match.'}}, 'additionalProperties': False}
list_bills_by_stage
Bills that moved to a stage recently
Bills whose LATEST action in the window falls in a stage (GET /v1/bills-by-stage): introduced, committee, passed, executive (with the governor, signed, or vetoed), amendments, other. Fleet-wide across all jurisdictions — there is no state filter, so filter the rows by state_id or state_name yourself. Classified from the action text, not status_id. Use for 'what passed this week' or 'what reached the governor'. Stage values are lowercase.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['stage'], 'properties': {'days': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Look-back window in days (default 7).'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Max rows (default 100).'}, 'stage': {'enum': ['introduced', 'committee', 'passed', 'executive', 'amendments', 'other'], 'type': 'string', 'description': 'Lowercase stage name.'}}, 'additionalProperties': False}
list_candidates
Search election candidates
Search the election-candidate directory (GET /v1/candidates): people running for office. Filters combine with AND. Roughly a third carry an FEC filer id and sitting members of Congress carry a Bioguide id; both are null otherwise. Rows also carry people_id where the person has a legislative voting record — pass it to get_legislator / get_legislator_scorecard to go from candidate to voting history in one hop. Covers STATE and federal candidates. Pass a candidate id to get_candidate for the full record.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'cycle': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'Election cycle / year filter, e.g. 2026.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Max rows to return (default 50).'}, 'state': {'type': 'string', 'description': '2-letter postal code filter.'}, 'fec_id': {'type': 'string', 'description': 'Filter by FEC filer id.'}, 'office': {'type': 'string', 'description': 'Office filter: H, S, P, House, Senate, President, or a whole word from a state office name (min 3 chars; unknown short values are rejected).'}, 'offset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset.'}, 'bioguide': {'type': 'string', 'description': 'Filter by federal Bioguide id.'}}, 'additionalProperties': False}
list_committees
List committees
List legislative committees (GET /v1/committees), filterable by jurisdiction, chamber, or name search. Returns the committee_id values that get_committee needs.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Name search.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Max rows to return (default 50).'}, 'state': {'type': 'string', 'description': '2-letter postal code (e.g. FL), DC, or US for Congress.'}, 'chamber': {'type': 'string', 'description': 'Chamber filter, e.g. House or Senate.'}}, 'additionalProperties': False}
list_districts
Electoral districts (and boundaries)
District metadata by state and type (GET /v1/districts): congressional, state senate, state house. Pass district_id with boundary:true to get the polygon as GeoJSON (GET /v1/districts/{id}/boundary) — it is large, so set simplify (degrees, e.g. 0.01) to shrink it. Match districts NUMERICALLY (district_number), never by label text.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'type': {'enum': ['congressional', 'sldu', 'sldl'], 'type': 'string', 'description': 'congressional | sldu (state senate/upper) | sldl (state house/lower)'}, 'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1}, 'state': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'Postal code.'}, 'offset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'boundary': {'type': 'boolean', 'description': 'true = return the GeoJSON polygon for district_id.'}, 'simplify': {'type': 'number', 'minimum': 0, 'description': 'Simplification tolerance in degrees.'}, 'district_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'A district id from a previous list call (for boundary:true).'}}, 'additionalProperties': False}
list_hearings
List hearings
Scheduled committee hearings across committees (GET /v1/hearings), filterable by jurisdiction and start date. Use this to answer 'what is being heard this week' or to track when a committee next meets. For hearings on one specific committee use get_committee with include:['hearings']; for one specific bill use get_bill with include:['calendar'].
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Max rows to return (default 50).'}, 'since': {'type': 'string', 'description': 'ISO-8601 date or timestamp; only hearings on or after it.'}, 'state': {'type': 'string', 'description': '2-letter postal code (e.g. FL), DC, or US for Congress.'}}, 'additionalProperties': False}
list_legislators
Search legislators
Search or list legislators (GET /v1/legislators) by jurisdiction, chamber, party, district, or name. This is how you turn a name into the people_id that get_legislator needs. Filters combine with AND.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Name search.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Max rows to return (default 50).'}, 'party': {'type': 'string', 'description': 'Party filter.'}, 'state': {'type': 'string', 'description': '2-letter postal code (e.g. FL), DC, or US for Congress.'}, 'offset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset.'}, 'chamber': {'type': 'string', 'description': 'Chamber filter, e.g. House or Senate.'}, 'district': {'type': 'string', 'description': 'District identifier.'}}, 'additionalProperties': False}
list_session_legislators
Legislators active in a session
Every legislator who served in one session (GET /v1/sessions/{id}/legislators), with people_id. Use list_legislators for the current roster by state; use this for a specific past or special session. Get session_id from list_sessions.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['session_id'], 'properties': {'session_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'session_id from list_sessions (filter by state).'}}, 'additionalProperties': False}
list_sessions
List legislative sessions
Legislative sessions (GET /v1/sessions): regular and special sessions with their years, start/sine-die dates and a session_id. Use this to resolve which session a bill belongs to, to find the current session for a state, or to pass session_id as a filter to search_bills. Omit `state` to list every jurisdiction's sessions. Corpus is 2026-forward only.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'state': {'type': 'string', 'description': '2-letter postal code (e.g. FL), DC, or US for Congress.'}, 'max_items': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Cap on rows returned (default 200).'}}, 'additionalProperties': False}
list_states
List states & jurisdictions
The jurisdiction directory (GET /v1/states): the 50 states, D.C. and the U.S. Congress with their state_id, 2-letter code and full name. Returns the full list (52 rows) so you can resolve a name to a code or enumerate everything the corpus covers. For how COMPLETE each jurisdiction's data is, use get_coverage instead.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}, 'additionalProperties': False}
list_subjects
List subjects
The raw subject taxonomy with per-subject bill counts (GET /v1/subjects). Subjects are the fine-grained categories the legislatures themselves assign to bills — narrower and more numerous than the curated topic slugs from list_topics. Use this to find a subject_id to filter search_bills by, or to gauge what a jurisdiction is legislating on. Scope with `state` and narrow with `q`.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Case-insensitive subject-name search.'}, 'state': {'type': 'string', 'description': '2-letter postal code (e.g. FL), DC, or US for Congress.'}, 'max_items': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Cap on rows returned (default 200).'}}, 'additionalProperties': False}
list_topics
List topics
The canonical topic taxonomy with per-topic bill counts (GET /v1/topics). Call this first to find the right slug for the topic filter on search_bills, instead of guessing one. Pass a slug to get that topic's detail and a sample of the raw subject names folded into it (GET /v1/topics/{slug}); to get the topic's actual bills, use search_bills with topic=<slug>.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'slug': {'type': 'string', 'description': "Optional topic slug, e.g. 'healthcare'. Omit to list the whole taxonomy."}, 'max_items': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Cap on rows returned (default 200).'}}, 'additionalProperties': False}
manage_webhooks
List, create, test or delete webhooks
Manage the key's webhook subscriptions (/v1/webhooks). action:'list' is read-only. 'create' REGISTERS a URL that Delilah will POST to on the chosen events — it changes the account, so it requires confirm:true and the user's explicit go-ahead. 'test' queues a sample delivery to an existing subscription. 'delete' removes one (confirm:true). Events: bill_introduced, status_change, vote_recorded, text_updated, passed, vetoed, signed, amendment_added. Optional filters: states (postal codes), subjects.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action'], 'properties': {'action': {'enum': ['list', 'create', 'test', 'delete'], 'type': 'string'}, 'events': {'type': 'array', 'items': {'enum': ['bill_introduced', 'status_change', 'vote_recorded', 'text_updated', 'passed', 'vetoed', 'signed', 'amendment_added'], 'type': 'string'}, 'description': 'create: at least one event type.'}, 'states': {'type': 'array', 'items': {'type': 'string', 'maxLength': 2, 'minLength': 2}, 'description': 'create: only fire for these jurisdictions.'}, 'confirm': {'type': 'boolean', 'description': 'Required true for create and delete.'}, 'subjects': {'type': 'array', 'items': {'type': 'string'}, 'description': 'create: only fire for these subjects.'}, 'webhook_id': {'type': 'string', 'description': 'test/delete: the subscription id from list.'}, 'webhook_url': {'type': 'string', 'format': 'uri', 'description': 'create: HTTPS URL to deliver to.'}}, 'additionalProperties': False}
search_bills
Search bills
Search or list legislation with structured filters (GET /v1/bills). Use this when you know the jurisdiction, sponsor, topic, or status you want. Every filter is optional and they combine with AND. A bill number typed into q (e.g. 'HB 1', 'SB0002') matches that bill directly. Returns bill summaries plus pagination; call get_bill for the full record. Corpus is 2026-forward only. status_id values: 1=Introduced, 2=In Committee, 3=Passed One Chamber, 4=Passed Both Chambers, 5=Signed into Law, 6=Vetoed, 7=Failed/Dead, 8=Chaptered. Aggregate buckets: passed={4,5,8}, failed={6,7}, alive={1,2,3}.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Free-text search across title, description, and subject names.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max rows to return (default 25).'}, 'state': {'type': 'string', 'description': '2-letter postal code (e.g. FL), DC, or US for Congress.'}, 'topic': {'type': 'string', 'description': "Canonical topic slug, e.g. 'healthcare'. See list_topics."}, 'offset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset.'}, 'subject': {'type': 'string', 'description': 'Raw subject name (ILIKE match).'}, 'status_id': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Filter by status. status_id values: 1=Introduced, 2=In Committee, 3=Passed One Chamber, 4=Passed Both Chambers, 5=Signed into Law, 6=Vetoed, 7=Failed/Dead, 8=Chaptered. Aggregate buckets: passed={4,5,8}, failed={6,7}, alive={1,2,3}.'}, 'session_id': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Narrow to one session.'}, 'bill_number': {'type': 'string', 'description': 'Bill number, compact (HB1) or padded (HB0001).'}, 'updated_since': {'type': 'string', 'description': 'ISO-8601 date or timestamp; only bills changed since then.'}, 'title_contains': {'type': 'string', 'description': 'Substring match against the bill title only.'}, 'include_sponsors': {'type': 'boolean', 'description': 'Attach a sponsors array (people_id, name, party, district, sponsor_type) to every bill. Use this whenever the answer needs to name who sponsored the bills.'}, 'sponsor_last_name': {'type': 'string', 'description': 'Last name of a bill sponsor.'}}, 'additionalProperties': False}
semantic_search_bills
Search bills by meaning
Vector search over the full text of every bill (GET /v1/search/semantic): describe what you want in plain English — 'protecting kids from social media', 'limits on rent increases' — and get the closest bills with a match_score. Prefer this over search_bills for questions and topics; prefer search_bills for a known bill number, sponsor, or status filter, and keyword_search_bills for exact terms that must all appear. Returns bill_id, bill_number, title, description, state_abbr, status_id. Corpus is 2026-forward only. status_id values: 1=Introduced, 2=In Committee, 3=Passed One Chamber, 4=Passed Both Chambers, 5=Signed into Law, 6=Vetoed, 7=Failed/Dead, 8=Chaptered. Aggregate buckets: passed={4,5,8}, failed={6,7}, alive={1,2,3}.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max rows (default 25).'}, 'query': {'type': 'string', 'maxLength': 1000, 'minLength': 1, 'description': 'The question or description, in plain English.'}, 'state': {'type': 'array', 'items': {'type': 'string', 'maxLength': 2, 'minLength': 2}, 'description': 'Restrict to these jurisdictions (postal codes, DC, US). Omit for all.'}, 'threshold': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Minimum similarity 0-1 (default 0.3). Lower it to widen the net.'}}, 'additionalProperties': False}
历史
近期工具变更
已添加
manage_webhooks
2026年9月26日 02:40
已添加
get_usage
2026年9月26日 02:40
已添加
get_candidate_photo
2026年9月26日 02:40
已添加
list_districts
2026年9月26日 02:40
已添加
get_ballot_measure
2026年9月26日 02:40
已添加
get_midterms
2026年9月26日 02:40
已添加
get_candidate
2026年9月26日 02:40
已添加
list_candidates
2026年9月26日 02:40
已添加
get_weekly_stage_breakdown
2026年9月26日 02:40
已添加
list_bills_by_stage
2026年9月26日 02:40
已添加
get_trending_bills
2026年9月26日 02:40
已添加
get_coverage
2026年9月26日 02:40
已添加
list_states
2026年9月26日 02:40
已添加
get_session_breakdown
2026年9月26日 02:40
已添加
list_session_legislators
2026年9月26日 02:40
已添加
get_session_vote_participation
2026年9月26日 02:40
已添加
get_session_sponsor_stats
2026年9月26日 02:40
已添加
get_session_dashboard
2026年9月26日 02:40
已添加
list_sessions
2026年9月26日 02:40
已添加
list_subjects
2026年9月26日 02:40
已添加
list_topics
2026年9月26日 02:40
已添加
get_changes
2026年9月26日 02:40
已添加
list_hearings
2026年9月26日 02:40
已添加
get_committee
2026年9月26日 02:40
已添加
list_committees
2026年9月26日 02:40
已添加
get_legislator_scorecard
2026年9月26日 02:40
已添加
get_roll_call
2026年9月26日 02:40
已添加
get_legislator
2026年9月26日 02:40
已添加
list_legislators
2026年9月26日 02:40
已添加
get_bill_text_history
2026年9月26日 02:40
发现
类似的 MCP 服务器
BNM Data Shop
io.github.bnmbnmai/bnm-data-shop
Sells access to cached official reports, enforcement orders, regulatory documents, inspection records, and other public-source te…
Dados Abertos Senado BR MCP
io.github.SidneyBissoli/senado-br-mcp-cloudflare
Searches and retrieves Brazilian Federal Senate legislative, administrative, budgetary, contracting, speech, committee, and e-Cid…
OpenHelvetia Gateway
swiss.openhelvetia/gateway
Provides sourced access to Swiss federal legislation and political data, including law metadata, versions, amendments, citations,…
GleanMark Trademark Search
com.gleanmark/trademark-search
Searches and analyzes USPTO trademark records, including conflicts, prosecution histories, TTAB proceedings, ownership chains, de…
editalmd
com.editalmd/editalmd
Searches Brazilian public procurement opportunities and documents, tracks deadlines and alerts, and supports tender document acce…
DataNexus MCP
com.datanexusmcp/mcp-server
Enables public-data research across domains, patents, government contracts, nonprofits, compliance registries, and software secur…
agentdata-nl
io.github.DarthSander/agentdata-nl
Provides paid company, insolvency, sanctions, regulatory, crypto-market, news, payment-counterparty, and structured web research …
FDA Data MCP
io.github.medley/fda-data
Searches and analyzes FDA data covering drugs, devices, facilities, inspections, recalls, approvals, shortages, enforcement, and …