Gavelin
Gavelin is a hosted MCP server that gives AI tools access to US state legislative records — bill data from all 50 states + DC and speaker-attributed hearing transcripts — through 7 read-only search and retrieval tools.
Search bills across all 50 states + DC (keyword, state, sponsor, committee, chamber, status, with session history).
Search hearing testimony by topic, speaker, committee, chamber, or date range, returning speaker name, role, and context.
Get full bill detail — sponsor, subjects, committee, legislative history, and hearing mentions.
Get speaker activity — everything a given legislator or witness has said, optionally filtered by topic or dates.
Browse committee hearings by topic, committee, chamber, or date range.
Retrieve full hearing transcripts with all speakers labeled by name.
List available states to see which states have bill data, transcripts, or both.
All tools are read-only and non-destructive, and require a free API key (bearer token) over Streamable HTTP.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
Gavelin MCP Server
State legislative records for AI tools. Speaker-attributed hearing transcripts from US state legislatures, alongside bill records from all 50 states.
Search bills across all 50 states, find what legislators said in hearings, get full committee hearing transcripts with speaker attribution — all via the Model Context Protocol.
Connect
Server URL: https://mcp.gavelin.ai/mcp
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"gavelin": {
"url": "https://mcp.gavelin.ai/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Claude Code
{
"mcpServers": {
"gavelin": {
"type": "url",
"url": "https://mcp.gavelin.ai/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Any MCP Client
The server uses Streamable HTTP transport. Any MCP-compatible client (Cursor, Windsurf, custom agents) can connect with the URL and a bearer token.
Related MCP server: civic-awareness-mcp
Get an API Key
Sign up for a free account at gavelin.ai and generate an API key from your Account page under "Developer API."
Available Tools
search_bills
Search bills across all 50 US states + DC by keyword, sponsor, committee, status, or chamber. Covers multiple legislative sessions with full detail including sponsors, subjects, and legislative history.
Example queries an agent might make:
"What housing bills are pending in California?"
"Find bills sponsored by Rivera in New York"
"Search for cannabis legislation that passed in 2025"
search_hearing_testimony
Search speaker-attributed hearing and floor session segments. Find what specific legislators or witnesses said about any topic. Returns speaker name, role, committee, date, and surrounding context.
Example queries:
"What has Senator Krueger said about affordable housing?"
"Find testimony about SNAP benefits in Finance committee hearings"
get_bill_detail
Get full details on a specific bill including sponsor, subjects, committee, legislative history, and any hearing mentions.
get_speaker_activity
Get everything a specific legislator or witness has said in hearings and floor sessions.
search_committee_hearings
Browse committee and public hearings by topic, committee, chamber, or date range.
get_hearing_transcript
Get the full transcript of a specific hearing with all speakers labeled by name.
list_available_states
See which states have data and what type (bills, transcripts, or both).
Rate Limits
API keys are free and rate-limited. Email hello@gavelin.ai if you need higher limits.
What's in it
Speaker attribution — real names on hearing testimony, not "Speaker A/B"
All 50 states — bill records for every state, with hearing transcripts for a growing number of states
Historical depth — multiple years of legislative sessions
About
Gavelin is a searchable archive of state legislative proceedings. Search is free at gavelin.ai.
Web app: gavelin.ai
Contact: hello@gavelin.ai
License
The MIT License in this repository applies only to the documentation contained here (README, server configuration files, logos). The Gavelin MCP server itself is a proprietary hosted service operated by Gavelin (gavelin.ai) and is not covered by the MIT License. Access to the server requires an API key issued under Gavelin's terms of service.
Available Tools
7 toolsget_bill_detailGet Bill DetailARead-onlyIdempotentInspect
Get full details on a specific bill including sponsor, subjects, history, and hearing mentions.
Args: bill_number: The bill print number (e.g., "S1234", "HB1001", "SB250") state: 2-letter state code (e.g., "NY", "CA") session_year: Session year (default 2025). Use 0 to search all sessions.
Inputs: bill_number (required), state, session_year. Returns: result
get_hearing_transcriptGet Hearing TranscriptARead-onlyIdempotentInspect
Get the full transcript of a specific hearing with all speakers.
Use search_committee_hearings first to find the source_id.
Args: source_id: The hearing source ID (UUID from search_committee_hearings results) limit: Max segments to return (default 50, max 200)
Inputs: source_id (required), limit. Returns: result
get_speaker_activityGet Speaker ActivityARead-onlyIdempotentInspect
Get everything a specific legislator or witness has said in hearings and floor sessions.
Use this for opposition research, coalition mapping, and pre-meeting preparation.
Args: speaker_name: Name to search for (e.g., "Krueger", "Rivera"). Partial match. state: 2-letter state code (default "NY") topic: Optional keyword filter (e.g., "housing", "taxes") date_from: Start date (YYYY-MM-DD) date_to: End date (YYYY-MM-DD) limit: Max segments (default 30, max 100)
Inputs: speaker_name (required), state, topic, date_from, +2 more. Returns: result
list_available_statesList Available StatesARead-onlyIdempotentInspect
List all states with data in Gavelin, including whether transcript data is available.
Use this to understand what data is available before searching.
Inputs: no named parameters. Returns: result
search_billsSearch BillsARead-onlyIdempotentInspect
Search bills across all 50 US states + DC, spanning multiple legislative sessions.
Returns bill number, title, sponsor, status, committee, summary, and state.
Args: query: Search terms for bill title and summary (e.g., "rent stabilization", "cannabis", "gun safety") state: 2-letter state code to filter (e.g., "CA", "NY", "TX"). Leave empty for all states. sponsor: Filter by sponsor name (partial match, e.g., "Rivera") committee: Filter by committee (e.g., "Judiciary") chamber: Filter by chamber: "senate" or "house" (leave empty for both) status: Filter by status (e.g., "Introduced", "Passed", "Enrolled", "Vetoed") limit: Max results (default 20, max 50)
Inputs: query (required), state, sponsor, committee, +3 more. Returns: result
search_committee_hearingsSearch Committee HearingsARead-onlyIdempotentInspect
Search committee and public hearings. Returns titles, dates, committees, and speaker counts.
Args: query: Optional keyword to search hearing titles (e.g., "housing", "budget") state: 2-letter state code (default "NY") committee: Filter by committee name (partial match) chamber: Filter by chamber: "senate" or "assembly" date_from: Start date (YYYY-MM-DD) date_to: End date (YYYY-MM-DD) limit: Max results (default 20, max 50)
Inputs: query, state, committee, chamber, +3 more. Returns: result
search_hearing_testimonySearch Hearing TestimonyARead-onlyIdempotentInspect
Search speaker-attributed hearing and floor session segments.
Returns matching segments with speaker name, role, committee, hearing date, and context. This is the most powerful tool for finding what specific legislators or witnesses said about any topic.
Transcript coverage: NY, CA, PA, OH, CO, IL, NE, NJ, CT (use list_available_states for current list).
Args: query: Search terms (e.g., "housing affordability", "SNAP benefits", "renewable energy") state: 2-letter state code (e.g., "NY", "CA", "PA"). Default "NY". speaker_name: Filter by speaker name (e.g., "Krueger", "Pretlow"). Partial match. committee: Filter by committee name (e.g., "Finance", "Housing") chamber: Filter by chamber: "senate" or "assembly" (leave empty for both) date_from: Start date in YYYY-MM-DD format (e.g., "2025-01-01") date_to: End date in YYYY-MM-DD format limit: Max results (default 20, max 50)
Inputs: query (required), state, speaker_name, committee, +4 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose with no overlap: get_bill_detail retrieves specific bill information, get_hearing_transcript fetches full hearing transcripts, get_speaker_activity tracks individual speaker contributions, list_available_states provides metadata, search_bills searches bill databases, search_committee_hearings finds hearing records, and search_hearing_testimony searches testimony content. The descriptions explicitly differentiate their functions and use cases.
All tools follow a consistent verb_noun naming pattern: get_bill_detail, get_hearing_transcript, get_speaker_activity, list_available_states, search_bills, search_committee_hearings, and search_hearing_testimony. The verbs (get, list, search) are used logically and consistently throughout the set, making the tools predictable and easy to understand.
With 7 tools, this server is well-scoped for legislative data analysis. Each tool serves a distinct and necessary function in the domain, covering bill details, hearing transcripts, speaker activity, state availability, and various search capabilities. The count is neither too sparse nor bloated, fitting typical server ranges effectively.
The tool set provides comprehensive coverage for legislative research, including CRUD-like operations (get, search) for bills, hearings, and testimony. Minor gaps exist, such as no explicit tools for updating or deleting data (though likely not needed in this read-heavy domain) or for tracking bill amendments, but agents can work around these with the available search and retrieval tools.
Maintenance
Related MCP Connectors
Search bills, legislators, committees, and events across all 50 US states, DC, and 5 US territories.
Bills, hearings, votes and legislators for all 50 US states, DC and Congress, from official sources.
Federal and 50-state legislative data for AI: bills, text, votes, members, and committees.
Search 209k+ US state bills, all 50 states + DC: full text, sponsors, votes, status. Free.
Related MCP Servers
- AlicenseAqualityCmaintenanceProvides access to legislative data from all 50 US states through the LegiScan API, enabling comprehensive search and retrieval of bills, votes, legislators, and legislative session information.1026 npm12MIT
- AlicenseAqualityDmaintenanceProvides tools to search and retrieve US federal and state legislative data, including bills, votes, campaign contributions, and legislator information, with provenance tracking.81MIT
- AlicenseNot gradedqualityBmaintenanceAccess U.S. state legislative data including bills, legislators, and votes across all 50 states via the OpenStates API.129 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to query U.S. legislative data, including jurisdictions, legislators, and bills, via the OpenStates API.1-