propublica-npo-mcp

ProPublica Nonprofit Explorer APIを公開し、厳選された非営利団体および申告概要を提供するMCPサーバーです。

インストール

npm install

Related MCP server: Charity MCP Server

実行

npm run start

ローカル開発用:

npm run dev

Claude Desktop / Clineの設定

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

ツール

search_nonprofits は、名前またはキーワードでProPublica Nonprofit Explorerインデックスを検索します。州、NTEE主要カテゴリ、501(c)サブタイプ、ページフィルターをオプションで指定できます。

get_organization は、組織のメタデータと、デフォルトで最新の申告書最大5件の厳選された概要を返します。verbose: true を渡すと、生のアップストリームペイロードを取得できます。

list_organization_filings は、EINに対するすべての申告書を新しい順に返します。デフォルトの出力は厳選されたものですが、verbose: true を指定すると生の申告書配列が返されます。

compare_nonprofits は、2〜5つの組織を最新の申告データを使用して並列比較します。EINごとの404エラーは行レベルのエラーとして保持されます。

注意事項

このサーバーは、1時間のTTLを持つ100エントリのインメモリLRUキャッシュを使用します。各アップストリームリクエストには15秒のタイムアウトが設定されており、ネットワークエラーや5xxエラーが発生した場合は1回再試行します。ProPublicaは公開されていますが、レート制限があります。429エラーが発生した場合は、ループさせずに待機してから再試行してください。

サポート

このプロジェクトが非営利団体の調査やエージェントの開発に役立った場合は、コーヒーを一杯おごることを検討してください！更新を継続する励みになります。

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

ライセンス

MITライセンス - 作成者: Ian Shen。