Skip to main content
Glama
LegiScan MCP Server

LegiScan MCP Server

by sh-patterson

LegiScan MCP-Server

CI License: MIT Node TypeScript

Ein Model Context Protocol (MCP)-Server, der Terminal-Agenten strukturierten Zugriff auf die LegiScan-API für Gesetzgebungsdaten aus allen 50 US-Bundesstaaten und dem Kongress bietet.

Entwickelt für Recherche-Workflows, bei denen Sie einen Agenten (Codex, Claude Code, Claude Desktop usw.) anweisen, schnell Gesetzesverläufe, Informationen zu Sponsoren und Abstimmungsergebnisse zu sammeln.

Funktionen

  • 10 optimierte MCP-Tools für Workflows in der gesetzgeberischen Recherche

  • Zusammengesetzte Tools, die mehrstufige Recherche-Workflows in einzelne MCP-Tool-Aufrufe zusammenfassen

  • Batch-Verarbeitung pro Anfrage und Caching für wiederholte Abfragen von Gesetzesentwürfen und namentlichen Abstimmungen

  • Vollständige TypeScript-Typdefinitionen für alle API-Antworten

  • Normalisierung von Gesetzesnummern (unterstützt Formate wie AB 858, AB858, AB-858)

  • Eingabevalidierung für Bundesstaat-Codes, Abgeordnetennamen-Abfragen und große Batches von Gesetzesentwürfen

Related MCP server: civic-awareness-mcp

Installation

Über npm (Empfohlen)

npm install -g legiscan-mcp-server

Aus dem Quellcode

git clone https://github.com/sh-patterson/legiscan-mcp.git
cd legiscan-mcp
npm install
npm run build

Einrichtung

1. LegiScan-API-Schlüssel abrufen

  1. Erstellen Sie ein kostenloses Konto bei LegiScan

  2. Registrieren Sie sich für den API-Zugriff unter https://legiscan.com/legiscan

  3. Kopieren Sie Ihren API-Schlüssel

2. Zu Ihrem MCP-fähigen Agenten hinzufügen

Fügen Sie diesen Server dem MCP-Host hinzu, den Ihr Terminal-Agent verwendet.

Konfigurationspfade für Claude Desktop:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Für andere MCP-Clients (Codex CLI, Claude Code usw.) fügen Sie denselben mcpServers.legiscan-Eintrag in die MCP-Konfigurationsdatei des Clients ein.

Verwendung von npx (Empfohlen)

{
  "mcpServers": {
    "legiscan": {
      "command": "npx",
      "args": ["-y", "legiscan-mcp-server"],
      "env": {
        "LEGISCAN_API_KEY": "your_api_key_here"
      }
    }
  }
}

Verwendung einer lokalen Installation

{
  "mcpServers": {
    "legiscan": {
      "command": "node",
      "args": ["/path/to/legiscan-mcp-server/dist/index.js"],
      "env": {
        "LEGISCAN_API_KEY": "your_api_key_here"
      }
    }
  }
}

Verfügbare Tools

Zusammengesetzte Tools (Recherche auf hoher Ebene)

Tool

Beschreibung

legiscan_find_legislator

Findet die people_id eines Abgeordneten anhand des Namens. Unterstützt Teilübereinstimmungen.

legiscan_get_legislator_votes

Ruft in einem Aufruf ab, wie ein Abgeordneter bei mehreren Gesetzesentwürfen abgestimmt hat.

legiscan_get_primary_authored

Ruft nur Gesetzesentwürfe ab, bei denen der Abgeordnete Hauptautor ist (kein Co-Sponsor).

Gesetzesentwürfe (Bills)

Tool

Beschreibung

legiscan_get_bill

Ruft detaillierte Informationen zu Gesetzesentwürfen ab (Sponsoren, Verlauf, Abstimmungen, Texte)

legiscan_find_bill_by_number

Findet einen Gesetzesentwurf anhand der Nummer (unterstützt AB 858, AB858, AB-858, A.B. 858). Am besten für die exakte Suche.

legiscan_get_roll_call

Ruft Abstimmungsdetails mit den Stimmen einzelner Abgeordneter ab

Personen

Tool

Beschreibung

legiscan_get_person

Ruft Informationen zu Abgeordneten mit Drittanbieter-IDs ab (VoteSmart, OpenSecrets usw.)

legiscan_get_session_people

Ruft alle in einer Legislaturperiode aktiven Abgeordneten ab

Suche

Tool

Beschreibung

legiscan_search

Volltextsuche in der Gesetzgebung. Akzeptiert Varianten von Gesetzesnummern wie AB858, verwenden Sie jedoch legiscan_find_bill_by_number für exakte Übereinstimmungen.

Legislaturperioden (Sessions)

Tool

Beschreibung

legiscan_get_session_list

Listet verfügbare Legislaturperioden nach Bundesstaat auf

Recherche-Workflow (Terminal-Agent)

1. Mit einer begrenzten Anfrage beginnen

Geben Sie Ihrem Agenten ein Ziel, einen Bundesstaat, einen Zeitrahmen und ein Ausgabeformat vor.

Beispiel-Prompt:

Use the LegiScan MCP tools to find major California housing bills in the current session.
Return: bill number, title, latest action date, top sponsors, and whether there was a close roll-call vote (margin <= 5).

2. Den Agenten anweisen, eine Tool-Sequenz zu befolgen

Für qualitativ hochwertige Ergebnisse weisen Sie den Agenten an, diese Reihenfolge einzuhalten:

  1. legiscan_get_session_list, um die korrekte Legislaturperiode zu identifizieren.

  2. legiscan_search oder legiscan_find_bill_by_number, um Ziel-Gesetzesentwürfe zu finden.

  3. legiscan_get_bill für Referenzen zu Sponsoren/Verlauf/Abstimmungen.

  4. legiscan_get_roll_call für Details zu einzelnen Abstimmungen.

  5. legiscan_get_person nur, wenn eine Anreicherung der Abgeordnetendaten erforderlich ist.

Wenn Sie mit legiscan_find_legislator beginnen, geben Sie die zurückgegebene session.session_id oder denselben state an nachfolgende Workflows weiter, damit die Ergebnisse in der beabsichtigten Legislative und im Zeitrahmen bleiben.

3. Zusammengesetzte Tools für Analysten-Workflows wiederverwenden

Diese reduzieren das Volumen der Tool-Aufrufe und vereinfachen die Anweisungen an Ihren Agenten:

  • legiscan_find_legislator: people_id aus einer Namensabfrage abrufen.

  • legiscan_get_primary_authored: Hauptautoren von Co-Sponsoren bei Gesetzesentwürfen trennen.

  • legiscan_get_legislator_votes: Abstimmungspositionen zu vielen Gesetzesentwürfen in einer Anfrage abrufen.

Prompt-Vorlagen

A) Oppositionsrecherche zu einem Abgeordneten

Use LegiScan MCP for Texas.
1) Find legislator "Jane Smith".
2) List all primary-authored bills in the current session.
3) For these bills, summarize topic area and latest status.
4) Then check votes on SB 12, HB 301, and SB 455, and show how the legislator voted.

B) Zusammenfassung der Verfolgung von Gesetzesentwürfen für ein Themengebiet

Use LegiScan MCP to track "climate resilience" bills in New York.
Focus on current session only.
Return top 15 bills by relevance with bill number, title, last action, sponsor party, and any recorded roll calls.

C) Workflow zur Unterstützung von Scorecards

For California session 2172, resolve bill numbers AB 858, SB 525, SB 616, SB 399.
For each bill, fetch details and any roll calls.
Then report vote positions for people_id values 21719, 23214, and 25359.
Output as a table suitable for CSV export.

Workflow-Vereinfachung

Die zusammengesetzten Tools reduzieren die Roundtrips zwischen Agent und Tool für gängige Workflows drastisch:

Workflow

Manuelle MCP-Schritte

Mit zusammengesetzten Tools

Stimmen für 1 Abgeordneten zu 10 Entwürfen

Abgeordneten finden → Entwürfe suchen/auflösen → jeden Entwurf prüfen → jede Abstimmung prüfen

1 Tool-Aufruf, sobald Sie bill_ids haben

Hauptautoren von 150 gesponserten Entwürfen filtern

Sponsorenliste → jeden Entwurf abrufen → Sponsoren prüfen

1 Tool-Aufruf, optional nach state oder session_id gefiltert

Abgeordneten nach Namen finden

Sitzungsermittlung → Suche nach Personen in der Sitzung → manueller Abgleich

1 Tool-Aufruf

Recherche-Tipps

  • Bundesstaat-Codes werden als zwei-Buchstaben-Strings validiert und automatisch in Großbuchstaben umgewandelt (ca → CA). Ungültige Codes wie ZZ bestehen die lokale Validierung, führen aber zu einem API-Fehler von LegiScan.

  • Fixieren Sie immer Bundesstaat und Legislaturperiode in Ihrem Prompt, um mehrdeutige Ergebnisse zu reduzieren.

  • Bitten Sie den Agenten, bill_id, roll_call_id und people_id in der Zwischenausgabe anzuzeigen, damit Sie die Rückverfolgbarkeit prüfen können.

  • Geben Sie für die Suche nach Abgeordneten mindestens einen Vor- und Nachnamen an (die Namenseingabe muss mindestens 2 Zeichen lang sein).

  • legiscan_get_primary_authored kann alle verfügbaren Sitzungen zurückgeben, aber die Angabe von state oder session_id hält die Ergebnisse auf die beabsichtigte Legislative und den Zeitrahmen ausgerichtet.

  • legiscan_get_legislator_votes akzeptiert bis zu 100 bill_ids pro Anfrage; teilen Sie größere Aufträge in Blöcke auf.

  • legiscan_search wiederholt kompakte Abfragen von Gesetzesnummern wie AB858 unter Verwendung eines kanonischen Formats mit Leerzeichen. Für die exakte Auflösung von Gesetzesentwürfen bevorzugen Sie legiscan_find_bill_by_number.

  • Fragen Sie nach Endergebnissen in einer für Tabellen/CSV geeigneten Form, wenn Sie eine nachgelagerte Analyse planen.

Entwicklung

npm run build        # Compile TypeScript
npm run typecheck    # Type-check src + tests
npm test             # Run deterministic unit tests (no API key)
npm run test:e2e     # Run real-world workflow tests (skips cleanly without API key)
npm run test:live    # Run live API integration tests (requires API key)
npm run test:coverage # Run unit tests with coverage
npm run lint         # Check for lint errors
npm run format       # Format code with Prettier

Testmodi

  • npm test / npm run test:unit: Schnelle deterministische Tests mit gemockten Netzwerkaufrufen.

  • npm run test:e2e: Recherche-Workflow-Tests basierend auf echten gesetzgeberischen Analyseaufgaben. Wird übersprungen, wenn LEGISCAN_API_KEY nicht verfügbar ist.

  • npm run test:live: Echte LegiScan-API-Integrationstests. Erfordert LEGISCAN_API_KEY.

API-Limits

  • Kostenlose öffentliche API-Schlüssel haben ein Limit von 30.000 Abfragen pro Monat.

  • Zusammengesetzte Tools führen Batch-Anfragen durch (maximal 10 gleichzeitig) und cachen wiederholte Abfragen innerhalb einer einzigen Anfrage, um unnötige Duplikate zu vermeiden.

  • Zusammengesetzte Tools reduzieren die Reibung im MCP-Workflow, aber die Nutzung der LegiScan-API skaliert weiterhin mit der Anzahl der verschiedenen Gesetzesentwürfe und Abstimmungen, die Sie untersuchen.

Docker

Bauen Sie das Container-Image lokal:

docker build -t legiscan-mcp .

Führen Sie es mit Ihrem zur Laufzeit bereitgestellten API-Schlüssel aus:

docker run --rm -i \
  -e LEGISCAN_API_KEY=your-api-key-here \
  legiscan-mcp

Releases

Glama-Prüfungen erwarten ein GitHub-Release. Erstellen und veröffentlichen Sie nach dem Zusammenführen Ihrer nächsten Repo-Änderungen ein Tag wie v1.0.0 von GitHub oder mit:

git tag v1.0.0
git push origin v1.0.0

Docker

Bauen Sie das Container-Image lokal:

docker build -t legiscan-mcp .

Führen Sie es mit Ihrem zur Laufzeit bereitgestellten API-Schlüssel aus:

docker run --rm -i \
  -e LEGISCAN_API_KEY=your-api-key-here \
  legiscan-mcp

Releases

Glama-Prüfungen erwarten ein GitHub-Release. Erstellen und veröffentlichen Sie ein Tag wie v1.0.0, nachdem Sie Änderungen gepusht haben.

Lizenz

MIT - siehe LICENSE für Details.

Available Tools

10 tools
legiscan_find_bill_by_numberA

Find a bill by its number within a state's current session or specific session. Handles format variations (AB 858, AB858, AB-858). Returns bill summary if found, null if not.

Inputs: bill_number (required), state, session_id.

legiscan_find_legislatorA

Find a legislator's people_id by searching their name. Useful as a first step before other queries. Supports partial name matching.

Inputs: name (required), state (required), session_id.

legiscan_get_billA

Get detailed bill information including sponsors, full history, votes, texts, amendments, and supplements. This is the primary tool for bill research.

Inputs: bill_id (required).

legiscan_get_legislator_votesA

Get how a legislator voted on specific bills. Use find_legislator first to get people_id from a name. Returns vote positions (Yea/Nay/NV/Absent) for each bill with roll call details.

Inputs: bill_ids (required), people_id (required), chamber.

legiscan_get_personA

Get legislator information including party, role, district, and third-party IDs (VoteSmart, OpenSecrets, Ballotpedia, FollowTheMoney).

Inputs: people_id (required).

legiscan_get_primary_authoredA

Get only bills where a legislator is the PRIMARY author, not co-sponsor. Use find_legislator first to get people_id from a name. Filters out co-sponsored bills automatically.

Inputs: people_id (required), state, session_id.

legiscan_get_roll_callA

Get roll call vote details including individual legislator votes. Get roll_call_id by calling get_bill first.

Inputs: roll_call_id (required).

legiscan_get_session_listA

Get list of available legislative sessions. Returns sessions with session_id, years, and state info. Use session_id for subsequent bill lookups.

Inputs: state.

legiscan_get_session_peopleA

Get all legislators active in a legislative session. Returns list of people with their roles, parties, and districts.

Inputs: session_id (required).

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 10 tools

    Disambiguation5/5

    Each tool targets a distinct resource or action (bills, legislators, sessions, votes, search) with clear boundaries. Even related tools like get_legislator_votes and get_roll_call serve different purposes (individual legislator vs. specific roll call).

    Naming Consistency5/5

    All tool names follow a consistent 'legiscan_verb_noun' pattern using lowercase with underscores. Verbs are limited to 'find', 'get', and 'search', making the set predictable.

    Tool Count5/5

    10 tools is well-scoped for a legislative tracking server. Each tool addresses a core need without unnecessary duplication or omission.

    Completeness5/5

    The tool surface covers the primary lifecycle for legislative data: discovering sessions, searching bills, retrieving details, and accessing legislator info and votes. No obvious gaps for a read-only MCP server.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • 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
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables querying legislative data from the LegiScan API, including bills and votes, via natural language through an MCP gateway.
      260 npm
      MIT