propublica-npo-mcp

MCP-Server, der die ProPublica Nonprofit Explorer API mit kuratierten Zusammenfassungen zu gemeinnützigen Organisationen und deren Einreichungen bereitstellt.

Installation

npm install

Related MCP server: Charity MCP Server

Ausführung

npm run start

Für die lokale Entwicklung:

npm run dev

Claude Desktop / Cline Konfiguration

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

Tools

search_nonprofits durchsucht den ProPublica Nonprofit Explorer-Index nach Name oder Stichwort, mit optionalen Filtern für Bundesstaat, NTEE-Hauptkategorie, 501(c)-Untertyp und Seitenzahl.

get_organization gibt Metadaten der Organisation sowie standardmäßig eine kuratierte Zusammenfassung der bis zu fünf aktuellsten Einreichungen zurück. Übergeben Sie verbose: true, um die rohen Upstream-Daten zu erhalten.

list_organization_filings gibt alle Einreichungen für eine EIN zurück, beginnend mit der neuesten. Die Standardausgabe ist kuratiert; verbose: true gibt die rohen Einreichungs-Arrays zurück.

compare_nonprofits vergleicht 2-5 Organisationen direkt anhand ihrer neuesten Einreichung mit Daten, wobei 404-Fehler pro EIN als zeilenbezogene Fehler beibehalten werden.

Hinweise

Der Server verwendet einen In-Memory-LRU-Cache für 100 Einträge mit einer TTL von 1 Stunde. Jede Upstream-Anfrage hat ein Timeout von 15 Sekunden und wird bei Netzwerkfehlern oder 5xx-Fehlern einmal wiederholt. ProPublica ist öffentlich zugänglich, unterliegt jedoch weiterhin Ratenbegrenzungen; falls Sie einen 429-Fehler erhalten, warten Sie bitte und versuchen Sie es erneut, anstatt in einer Schleife zu agieren.

Unterstützung

Wenn dieses Projekt Ihnen bei der Recherche zu gemeinnützigen Organisationen hilft oder Sie dabei unterstützt, coole Agenten zu entwickeln, ziehen Sie bitte in Betracht, mir einen Kaffee auszugeben! Es hilft dabei, die Updates fortzusetzen.

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

Lizenz

MIT-Lizenz - Erstellt von Ian Shen.