Skip to main content
Glama
MCP OpenFEC Server

MCP OpenFEC Server

by psalzman

Servidor MCP OpenFEC

Un servidor de Protocolo de Contexto Modelo (MCP) que proporciona acceso a los datos de financiamiento de campañas de la Comisión Federal Electoral (FEC) a través de la API OpenFEC.

Características

  • Busque candidatos por nombre, estado o cargo

  • Obtenga información detallada del candidato y datos financieros

  • Información del comité de acceso

  • Ver contribuciones individuales

  • Seguimiento de gastos independientes

  • Acceda a los archivos de la FEC y a los casos de auditoría

  • Descargar datos masivos

Related MCP server: FireHydrant MCP Server

Requisitos

Instalación

  1. Clonar el repositorio:

git clone https://github.com/psalzman/mcp-openfec
cd mcp-openfec
  1. Instalar dependencias:

npm install
  1. Cree un archivo .env en el directorio raíz y agregue su clave API de OpenFEC:

OPENFEC_API_KEY=your_api_key_here
  1. Construir el servidor:

npm run build

Configuración

Para utilizar este servidor MCP con Claude Desktop:

  1. Localice el archivo de configuración de Claude Desktop:

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

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

    • Linux: ~/.config/Claude/claude_desktop_config.json

  2. Agregue la siguiente configuración al archivo:

{
  "mcpServers": {
    "openfec": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-openfec/build/server.js"],
      "env": {
        "OPENFEC_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Notas de configuración importantes:

  1. Reemplace /absolute/path/to/mcp-openfec con la ruta real donde clonó el repositorio

  2. Utilice rutas absolutas, no relativas

  3. Establezca disabled en false para habilitar el servidor

  4. Mantenga autoApprove como una matriz vacía por seguridad

  5. Agregue su clave API de OpenFEC en la sección env

Herramientas disponibles

  1. get_candidate : Obtener información detallada sobre un candidato

  2. get_candidate_financials : Obtener datos financieros de un candidato

  3. search_candidates : Busca candidatos por nombre u otros criterios

  4. get_committee : Obtener información detallada sobre un comité

  5. get_candidate_contributions : Obtener contribuciones individuales de un candidato

  6. get_filings : Recuperar archivos oficiales de la FEC

  7. get_independent_expenditures : Obtener gastos independientes

  8. get_electioneering : Obtener comunicaciones electorales

  9. get_party_coordinated_expenditures : Obtener los gastos coordinados del partido

  10. get_communication_costs : Obtener los costos de comunicación corporativos/sindicales

  11. get_audit_cases : Obtener casos de auditoría y hallazgos de la FEC

  12. get_bulk_downloads : Obtener enlaces a descargas masivas de datos

Limitación de velocidad

El servidor implementa la limitación de velocidad para cumplir con las pautas de la API de OpenFEC:

  • 1000 solicitudes por hora

  • Las solicitudes que excedan este límite recibirán una respuesta de error.

Desarrollo

Para modificar el servidor:

  1. Realizar cambios en los archivos TypeScript en el directorio src

  2. Reconstruir el servidor:

npm run build

Licencia

Este proyecto está licenciado bajo la Licencia BSD de 3 Cláusulas, una licencia permisiva de código abierto que garantiza la máxima libertad para los usuarios, manteniendo al mismo tiempo los requisitos de atribución. Esta licencia permite:

  • Utilice el código comercialmente

  • Modificar el código

  • Distribuir el código

  • Utilice el código de forma privada

Con tres condiciones principales:

  1. Debe incluir el aviso de derechos de autor original.

  2. Debes incluir el texto de la licencia en las distribuciones

  3. No se pueden utilizar los nombres de los colaboradores para respaldar productos derivados sin permiso.

La licencia BSD de 3 cláusulas se utiliza ampliamente en entornos académicos y comerciales y ofrece un buen equilibrio entre permisividad y protección de los colaboradores.

Contribuyendo

  1. Bifurcar el repositorio

  2. Crea tu rama de funciones ( git checkout -b feature/my-new-feature )

  3. Confirme sus cambios ( git commit -am 'Add some feature' )

  4. Empujar a la rama ( git push origin feature/my-new-feature )

  5. Crear una nueva solicitud de extracción

Derechos de autor

Copyright (c) 2025, Phillip Salzman & Foundry Peak, LLC. Todos los derechos reservados. Web: http://foundrypeak.com/

Para obtener detalles sobre la licencia, consulte el archivo LICENCIA .

Available Tools

12 tools
get_audit_casesC

Get FEC audit cases and findings

Inputs: committee_id, audit_id, audit_year, finding_types.

get_bulk_downloadsB

Get links to bulk data downloads

Inputs: data_type (required), election_year.

get_candidateC

Get detailed information about a candidate

Inputs: candidate_id (required), election_year.

get_candidate_contributionsC

Get individual contributions for a candidate

Inputs: candidate_id (required), election_year, sort.

get_candidate_financialsC

Get financial data for a candidate

Inputs: candidate_id (required), election_year (required).

get_committeeC

Get detailed information about a committee

Inputs: committee_id (required).

get_communication_costsC

Get corporate/union communication costs

Inputs: committee_id, candidate_id, min_date, max_date, +3 more.

get_electioneeringC

Get electioneering communications

Inputs: committee_id, candidate_id, min_date, max_date, +3 more.

get_filingsC

Retrieve official FEC filings with filters

Inputs: committee_id, candidate_id, form_type, min_receipt_date, +3 more.

get_independent_expendituresC

Get independent expenditures supporting or opposing candidates

Inputs: candidate_id, committee_id, support_oppose_indicator, min_date, +4 more.

get_party_coordinated_expendituresD

Get party coordinated expenditures

Inputs: committee_id, candidate_id, min_date, max_date, +3 more.

search_candidatesC

Search for candidates by name or other criteria

Inputs: name (required), state, office, election_year.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 12 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting specific FEC data types like candidates, committees, contributions, expenditures, filings, and downloads. There is no overlap in functionality—tools like get_candidate, get_committee, and get_filings serve separate resources, and even related tools like get_candidate_contributions and get_candidate_financials focus on different aspects of candidate data.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case, starting with 'get_' or 'search_' followed by a specific noun phrase (e.g., get_candidate, search_candidates, get_audit_cases). This uniformity makes the tool set predictable and easy to navigate, with no deviations in naming style.

    Tool Count5/5

    With 12 tools, the server is well-scoped for accessing U.S. Federal Election Commission data, covering key areas like candidates, committees, financials, expenditures, and filings. Each tool serves a distinct data retrieval function, avoiding bloat while providing comprehensive coverage for the domain.

    Completeness4/5

    The tool set offers strong coverage for retrieving FEC data, including candidates, committees, financials, expenditures, filings, and bulk downloads. A minor gap exists in update or management operations (e.g., no create or modify tools), but this is reasonable for a read-only data access server focused on public records, and agents can work effectively with the provided retrieval functions.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers