MCP OpenFEC Server
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
Node.js (v16 o superior)
Una clave API de OpenFEC ( obtenga una aquí )
Instalación
Clonar el repositorio:
git clone https://github.com/psalzman/mcp-openfec
cd mcp-openfecInstalar dependencias:
npm installCree un archivo
.enven el directorio raíz y agregue su clave API de OpenFEC:
OPENFEC_API_KEY=your_api_key_hereConstruir el servidor:
npm run buildConfiguración
Para utilizar este servidor MCP con Claude Desktop:
Localice el archivo de configuración de Claude Desktop:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonVentanas:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
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:
Reemplace
/absolute/path/to/mcp-openfeccon la ruta real donde clonó el repositorioUtilice rutas absolutas, no relativas
Establezca
disabledenfalsepara habilitar el servidorMantenga
autoApprovecomo una matriz vacía por seguridadAgregue su clave API de OpenFEC en la sección
env
Herramientas disponibles
get_candidate: Obtener información detallada sobre un candidatoget_candidate_financials: Obtener datos financieros de un candidatosearch_candidates: Busca candidatos por nombre u otros criteriosget_committee: Obtener información detallada sobre un comitéget_candidate_contributions: Obtener contribuciones individuales de un candidatoget_filings: Recuperar archivos oficiales de la FECget_independent_expenditures: Obtener gastos independientesget_electioneering: Obtener comunicaciones electoralesget_party_coordinated_expenditures: Obtener los gastos coordinados del partidoget_communication_costs: Obtener los costos de comunicación corporativos/sindicalesget_audit_cases: Obtener casos de auditoría y hallazgos de la FECget_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:
Realizar cambios en los archivos TypeScript en el directorio
srcReconstruir el servidor:
npm run buildLicencia
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:
Debe incluir el aviso de derechos de autor original.
Debes incluir el texto de la licencia en las distribuciones
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
Bifurcar el repositorio
Crea tu rama de funciones (
git checkout -b feature/my-new-feature)Confirme sus cambios (
git commit -am 'Add some feature')Empujar a la rama (
git push origin feature/my-new-feature)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 toolsget_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
Scored across 12 tools
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.
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.
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.
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
Related MCP Connectors
Access FEC campaign finance data. Query data about candidates, money trails, and election filings.
OpenFEC MCP — Federal Election Commission campaign finance data
Read sourced U.S. civic records: candidates, offices, campaign finance, elections and governments.
US political money data: campaign finance, lobbying, dark money, contracts and SEC filings.
1
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables interaction with Linear's API for managing issues, teams, and projects programmatically through the Model Context Protocol.783 npm4MIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with FireHydrant's incident management API through the Model Context Protocol. Provides programmatic access to FireHydrant's features for managing incidents, retrospectives, and operational workflows.385 npm5MIT
- AlicenseNot gradedqualityFmaintenanceEnables interaction with the Edgee API for managing organizations, projects, domains, components, users, invitations, and API tokens through the Model Context Protocol.Apache 2.0
- AlicenseNot gradedqualityDmaintenanceConnects the OpenFEC API to AI assistants for investigating US federal campaign finance through natural language conversations.1MIT