propublica-npo-mcp

Servidor MCP que expone la API de Nonprofit Explorer de ProPublica con resúmenes seleccionados de organizaciones sin ánimo de lucro y sus declaraciones.

Instalación

npm install

Related MCP server: Charity MCP Server

Ejecución

npm run start

Para desarrollo local:

npm run dev

Configuración de Claude Desktop / Cline

{
  "mcpServers": {
    "propublica-npo": {
      "command": "npx",
      "args": ["tsx", "/absolute/path/to/propublica-npo-mcp/src/index.ts"]
    }
  }
}

Herramientas

search_nonprofits busca en el índice de Nonprofit Explorer de ProPublica por nombre o palabra clave, con filtros opcionales de estado, categoría principal NTEE, subtipo 501(c) y página.

get_organization devuelve los metadatos de la organización junto con un resumen seleccionado de hasta las cinco declaraciones más recientes por defecto. Pasa verbose: true para obtener la carga útil original (raw payload).

list_organization_filings devuelve todas las declaraciones para un EIN, empezando por la más reciente. La salida por defecto es seleccionada; verbose: true devuelve las matrices de declaraciones originales.

compare_nonprofits compara de 2 a 5 organizaciones lado a lado utilizando su última declaración con datos, mientras preserva los errores 404 por EIN como errores a nivel de fila.

Notas

El servidor utiliza una caché LRU en memoria de 100 entradas con un TTL de 1 hora. Cada solicitud ascendente tiene un tiempo de espera de 15 segundos y se reintenta una vez en caso de fallos de red o 5xx. ProPublica es público pero sigue teniendo límites de tasa; si recibes un 429, espera y vuelve a intentarlo en lugar de entrar en un bucle.

Soporte

Si este proyecto te ayuda a investigar organizaciones sin ánimo de lucro o a crear agentes interesantes, ¡considera invitarme a un café! Ayuda a que las actualizaciones sigan llegando.

https://paypal.me/2b3/5

Licencia

Licencia MIT - Creado por Ian Shen.