Skip to main content
Glama

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.

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 tools
get_bill_detailGet Bill DetailA
Read-onlyIdempotent
Inspect

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 TranscriptA
Read-onlyIdempotent
Inspect

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 ActivityA
Read-onlyIdempotent
Inspect

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 StatesA
Read-onlyIdempotent
Inspect

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 BillsA
Read-onlyIdempotent
Inspect

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 HearingsA
Read-onlyIdempotent
Inspect

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 TestimonyA
Read-onlyIdempotent
Inspect

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

    A4.2/5.0

    Scored across 7 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Provides 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.
      10
      26 npm
      12
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides tools to search and retrieve US federal and state legislative data, including bills, votes, campaign contributions, and legislator information, with provenance tracking.
      8
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Access U.S. state legislative data including bills, legislators, and votes across all 50 states via the OpenStates API.
      129 npm
      MIT