Skip to main content
Glama
FEC Campaign Finance MCP Server

FEC Campaign Finance MCP Server

by reichaves

FEC-Wahlkampffinanzierungs-MCP-Server

Autor: Reinaldo Chaves (reichaves@gmail.com)

GitHub Python License FastMCP OpenFEC

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

search_candidates(), get_top_donors()

Resources

Statische oder kontextbezogene Daten, die immer verfügbar sind

FEC-Codetabellen, wichtige IDs, Glossar

Prompts

Workflow-Vorlagen zur Anleitung komplexer Untersuchungen

investigate_candidate(), follow_the_money()


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

fec://reference/codes

Parteicodes, Ämter, Komitee-Typen, Einreichungstypen, Spendenlimits

fec://reference/notable_ids

IDs von Präsidentschaftskandidaten, nationalen Komitees, relevanten Super PACs

fec://reference/api_info

Datenabdeckung, Ratenbegrenzungen, Nutzungstipps

fec://reference/glossary

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

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" > .env

Anwendungsbeispiele

Untersuchung eines Kandidaten

"Untersuche die Wahlkampffinanzen von Kamala Harris im Jahr 2024"

Das LLM führt automatisch Folgendes aus:

  1. search_candidates(name="Kamala Harris", election_year=2024)

  2. get_candidate_finances(candidate_id="P00009423")

  3. 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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables 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.
      12
      2
      BSD 3-Clause
    • A
      license
      A
      quality
      C
      maintenance
      Query FEC campaign finance data — search candidates, track donations, analyze spending, and monitor Super PAC activity via the OpenFEC API.
      8
      14 npm
      4
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Access Federal Election Commission campaign finance data through MCP tools. Enables querying OpenFEC data using natural language via ask_pipeworx or direct tool calls.
      81 npm
      MIT