LegiScan MCP Server
LegiScan MCP-Server
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-serverAus dem Quellcode
git clone https://github.com/sh-patterson/legiscan-mcp.git
cd legiscan-mcp
npm install
npm run buildEinrichtung
1. LegiScan-API-Schlüssel abrufen
Erstellen Sie ein kostenloses Konto bei LegiScan
Registrieren Sie sich für den API-Zugriff unter https://legiscan.com/legiscan
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.jsonWindows:
%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 |
| Findet die |
| Ruft in einem Aufruf ab, wie ein Abgeordneter bei mehreren Gesetzesentwürfen abgestimmt hat. |
| Ruft nur Gesetzesentwürfe ab, bei denen der Abgeordnete Hauptautor ist (kein Co-Sponsor). |
Gesetzesentwürfe (Bills)
Tool | Beschreibung |
| Ruft detaillierte Informationen zu Gesetzesentwürfen ab (Sponsoren, Verlauf, Abstimmungen, Texte) |
| Findet einen Gesetzesentwurf anhand der Nummer (unterstützt AB 858, AB858, AB-858, A.B. 858). Am besten für die exakte Suche. |
| Ruft Abstimmungsdetails mit den Stimmen einzelner Abgeordneter ab |
Personen
Tool | Beschreibung |
| Ruft Informationen zu Abgeordneten mit Drittanbieter-IDs ab (VoteSmart, OpenSecrets usw.) |
| Ruft alle in einer Legislaturperiode aktiven Abgeordneten ab |
Suche
Tool | Beschreibung |
| Volltextsuche in der Gesetzgebung. Akzeptiert Varianten von Gesetzesnummern wie AB858, verwenden Sie jedoch |
Legislaturperioden (Sessions)
Tool | Beschreibung |
| 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:
legiscan_get_session_list, um die korrekte Legislaturperiode zu identifizieren.legiscan_searchoderlegiscan_find_bill_by_number, um Ziel-Gesetzesentwürfe zu finden.legiscan_get_billfür Referenzen zu Sponsoren/Verlauf/Abstimmungen.legiscan_get_roll_callfür Details zu einzelnen Abstimmungen.legiscan_get_personnur, 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_idaus 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 |
Hauptautoren von 150 gesponserten Entwürfen filtern | Sponsorenliste → jeden Entwurf abrufen → Sponsoren prüfen | 1 Tool-Aufruf, optional nach |
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 wieZZbestehen 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_idundpeople_idin 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_authoredkann alle verfügbaren Sitzungen zurückgeben, aber die Angabe vonstateodersession_idhält die Ergebnisse auf die beabsichtigte Legislative und den Zeitrahmen ausgerichtet.legiscan_get_legislator_votesakzeptiert bis zu 100bill_idspro Anfrage; teilen Sie größere Aufträge in Blöcke auf.legiscan_searchwiederholt kompakte Abfragen von Gesetzesnummern wieAB858unter Verwendung eines kanonischen Formats mit Leerzeichen. Für die exakte Auflösung von Gesetzesentwürfen bevorzugen Sielegiscan_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 PrettierTestmodi
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, wennLEGISCAN_API_KEYnicht verfügbar ist.npm run test:live: Echte LegiScan-API-Integrationstests. ErfordertLEGISCAN_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-mcpReleases
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.0Docker
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-mcpReleases
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 toolslegiscan_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).
legiscan_searchA
Full-text search across bill texts. Returns 50 results per page with relevance scores, bill summaries, and URLs. Use for interactive searches.
Inputs: query (required), page, year, state, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
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).
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.
10 tools is well-scoped for a legislative tracking server. Each tool addresses a core need without unnecessary duplication or omission.
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
Related MCP Connectors
Federal and 50-state legislative data for AI: bills, text, votes, members, and committees.
Unofficial LegiScan MCP — wraps the LegiScan API (api.legiscan.com)
Search bills and speaker-attributed hearing transcripts across all 50 US state legislatures.
Bills, hearings, votes and legislators for all 50 US states, DC and Congress, from official sources.
Related MCP Servers
- AlicenseAqualityCmaintenanceSearch bills and speaker-attributed hearing transcripts across all 50 US state legislatures.71MIT
- 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
- AlicenseNot gradedqualityCmaintenanceEnables querying legislative data from the LegiScan API, including bills and votes, via natural language through an MCP gateway.260 npmMIT