FEC Campaign Finance MCP Server
FEC-Wahlkampffinanzierungs-MCP-Server
Autor: Reinaldo Chaves (reichaves@gmail.com)
Lesen Sie dies auf Portugiesisch
Ein MCP-Server, der die OpenFEC-API mit KI-Assistenten verbindet und es Ihnen ermöglicht, die US-Bundeswahlkampffinanzierung durch natürliche Konversationen zu untersuchen.
Entwickelt für Datenjournalisten, Forscher und Bürger, die komplexe Daten der Federal Election Commission (FEC) erkunden müssen, ohne die API direkt zu kennen.
Inhaltsverzeichnis
Related MCP server: fec-mcp-server
Was ist MCP?
MCP (Model Context Protocol) ist ein offener Standard, der es KI-Assistenten ermöglicht, sicher und einheitlich mit externen Systemen – Datenbanken, APIs, Dateien, Diensten – zu kommunizieren.
Die drei Arten von MCP-Fähigkeiten
Typ | Was es ist | Beispiel in diesem Projekt |
Tools | Funktionen, die die KI aufrufen kann, um Daten abzurufen oder zu bearbeiten |
|
Resources | Statische oder kontextbezogene Daten, die immer verfügbar sind | FEC-Codetabellen, wichtige IDs, Glossar |
Prompts | Workflow-Vorlagen zur Anleitung komplexer Untersuchungen |
|
Was macht dieses Projekt?
Dieses Projekt stellt die OpenFEC-API als MCP-Server bereit. Das Ergebnis: Sie können politische Finanzierung untersuchen, indem Sie einfach mit einem LLM sprechen.
Hauptfunktionen
Kandidatensuche: Finden Sie jeden Bundeskandidaten nach Name, Bundesstaat, Partei oder Amt.
Finanzanalyse: Gesamteinnahmen, Ausgaben, Schulden und Kassenbestand (Cash on Hand).
Spenderverfolgung: Identifizieren Sie die wichtigsten Geldgeber einer Kampagne und deren Arbeitgeber.
Geo-Analyse: Sehen Sie, aus welchen Bundesstaaten das Geld eines Kandidaten stammt.
Super PACs und unabhängige Ausgaben: Überwachen Sie externe Gruppen, die Geld ausgeben, um Kandidaten zu unterstützen oder anzugreifen.
Offizielle Berichte: Greifen Sie auf Unterlagen zu, die von Kampagnen und Komitees bei der FEC eingereicht wurden.
Geführte Untersuchung: Gebrauchsfertige Workflows für journalistische Recherchen.
🔍 Methodischer Hinweis (OSINT und Datenarchitektur)
Die FEC-API trennt "Kandidatensummen" (den primären Endpunkt des offiziellen Komitees) von dem Geld, das in Political Action Committees (PACs) gehalten wird. Der fec_mcp wurde strikt nach dem Prinzip der "Null-Halluzination" entwickelt. Er stellt Daten genau so dar, wie die Regierungsbürokratie sie klassifiziert. Bei OSINT-Untersuchungen liegt es am KI-Agenten oder Journalisten, search_candidates zu verwenden, um alle Principal Authorized Committees und PACs aufzulisten, die mit einem Politiker verbunden sind, und deren Finanzen einzeln abzufragen.
Mehrsprachige Unterstützung (i18n)
Der Server unterstützt Internationalisierung. Die Standardsprache für Antworten und Tipps ist Englisch. Sie können dies ändern, indem Sie die Umgebungsvariable FEC_MCP_LANG setzen (z. B. FEC_MCP_LANG=pt-br).
Verfügbare Tools
Tools
search_candidates: Suche nach Bundeskandidaten.get_candidate_finances: Abrufen der Finanzsummen für einen Kandidaten.search_contributions: Suche nach individuellen Spenden (Schedule A).get_top_donors: Auflistung der Top-Spender eines Komitees.get_contributions_by_state: Aggregation von Spenden nach Bundesstaat.get_campaign_expenditures: Auflistung der Ausgaben einer Kampagne (Schedule B).get_independent_expenditures: Suche nach unabhängigen Ausgaben durch Super PACs.get_candidate_filings/get_committee_filings: Auflistung der bei der FEC eingereichten Finanzberichte.search_pacs: Suche nach PACs und Super PACs nach Namen.fec_help: Interne Dokumentation für die Tools.suggest_investigation: Vorschläge für journalistische Themen basierend auf FEC-Daten.
Ressourcen
URI | Inhalt |
| Parteicodes, Ämter, Komitee-Typen, Einreichungstypen, Spendenlimits |
| IDs von Präsidentschaftskandidaten, nationalen Komitees, relevanten Super PACs |
| Datenabdeckung, Ratenbegrenzungen, Nutzungstipps |
| Glossar der FEC-Terminologie (z. B. PAC, Schedule A, Cash on Hand) |
Prompts
investigate_candidate(candidate_name): Schritt-für-Schritt-Workflow für eine vollständige Finanzuntersuchung eines Kandidaten.follow_the_money(company_name): Verfolgt den politischen Einfluss eines Unternehmens.compare_candidates(candidate1, candidate2): Direkter Vergleich zweier Kandidaten.
Installation
Voraussetzungen
Python 3.10+
FEC-API-Schlüssel: Kostenlos unter api.data.gov/signup
Schritte
git clone https://github.com/your-username/fec-mcp-server.git
cd fec-mcp-server
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt
echo "FEC_API_KEY=your_key_here" > .envAnwendungsbeispiele
Untersuchung eines Kandidaten
"Untersuche die Wahlkampffinanzen von Kamala Harris im Jahr 2024"
Das LLM führt automatisch Folgendes aus:
search_candidates(name="Kamala Harris", election_year=2024)get_candidate_finances(candidate_id="P00009423")get_top_donors(committee_id="C00703975")
Vergleich von Kandidaten
"Vergleiche die Finanzen von Trump und Biden für 2024"
Der Prompt compare_candidates generiert eine vollständige Tabelle mit allen Metriken im direkten Vergleich.
Bekannte Einschränkungen
Nur Bundesdaten: Staats- und Kommunalwahlen sind nicht in der FEC enthalten.
Dunkles Geld: Spenden an 501(c)(4)-Organisationen werden der FEC nicht offengelegt.
Latenz: Endpunkte für individuelle Spenden (
schedule_a) können langsam sein.Ratenbegrenzung: 1.000 Anfragen/Stunde mit dem kostenlosen API-Schlüssel.
Externe Ressourcen
This server cannot be deployed
Maintenance
Related MCP Connectors
Access FEC campaign finance data. Query data about candidates, money trails, and election filings.
FEC campaign finance data: candidate fundraising, donors, and spending
U.S. civic data for AI agents: reps, votes, bills, finance, lobbying, cited gov sources. 47 tools.
OpenFEC MCP — Federal Election Commission campaign finance data
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables interaction with Federal Election Commission data via the OpenFEC API, providing access to campaign finance information such as candidates, committees, contributions, and expenditures through the Model Context Protocol.122BSD 3-Clause
- AlicenseAqualityBmaintenanceQuery FEC campaign finance data — search candidates, track donations, analyze spending, and monitor Super PAC activity via the OpenFEC API.89 npm4MIT
- AlicenseBqualityDmaintenanceMCP server giving AI agents access to US political finance data: campaign contributions, PAC spending, lobbying records, and voting behavior.61MIT
- AlicenseNot gradedqualityDmaintenanceEnables searching political donations, donors, and lobbying data from any AI assistant using Federal Election Commission data.7 npmMIT