nonprofit-explorer-mcp-server — Claude Code MCP server
nonprofit-explorer-mcp-server — an MCP server to query 1.8M+ US tax-exempt entities, retrieve IRS Form 990 figures, and access filing records via ProPublica.
Apache-2.0 1,281 installs ★ 2 updated 2026-10-22
claude mcp add --transport http nonprofit-explorer-mcp-server https://nonprofit-explorer-mcp-server--cyanheads.run.toolsWhat nonprofit-explorer-mcp-server does
This server bridges your AI assistant with the ProPublica Nonprofit Explorer database. It exposes three dedicated tools: text search across organizations with state, NTEE sector, and 501(c) filters; single-entity lookup by EIN; and complete filing archives detailing revenue streams, assets, executive pay, and source PDF links.
Entity search yields up to 25 items per page and halts at a 10,000-result ceiling. The server parses EINs whether passed as pure digits or hyphenated strings, resolving IRS Business Master File designations like foundation classification and deduction eligibility.
Financial figures reflect a 1–2 year lag behind real time, making the fiscal year attribute (tax_prd_yr) mandatory context for every metric. Also note that program_expense_ratio always evaluates to null because ProPublica omits Form 990 Part IX totals from the payload.
What it helps with
- search US charities and tax-exempt entities by name, city, or keyword
- inspect IRS deductibility status and foundation classification by EIN
- retrieve year-over-year revenue, expenses, and asset balances from Form 990
- fetch direct links to original IRS filing PDF documents
Example prompts for the agent
- Search for environmental nonprofits in Oregon using
nonprofit_search_organizations - Get the financial summary and IRS standing for EIN
53-0196605vianonprofit_get_organization - Pull all historical Form 990 filings for this EIN to inspect executive compensation and grant payouts
How to install nonprofit-explorer-mcp-server
Platform CLI: remote server
claude mcp add --transport http nonprofit-explorer-mcp-server https://nonprofit-explorer-mcp-server--cyanheads.run.toolsPlatform CLI: remote server
codex mcp add nonprofit-explorer-mcp-server --url https://nonprofit-explorer-mcp-server--cyanheads.run.toolsConfig file
{
"mcpServers": {
"nonprofit-explorer-mcp-server": {
"url": "https://nonprofit-explorer-mcp-server--cyanheads.run.tools"
}
}
}Config file
{
"servers": {
"nonprofit-explorer-mcp-server": {
"type": "http",
"url": "https://nonprofit-explorer-mcp-server--cyanheads.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http nonprofit-explorer-mcp-server https://nonprofit-explorer-mcp-server--cyanheads.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about nonprofit-explorer-mcp-server
How to install nonprofit-explorer-mcp-server in Claude Code?
Run this command in your CLI: claude mcp add --transport http nonprofit-explorer-mcp-server https://nonprofit-explorer-mcp-server--cyanheads.run.tools.
What does nonprofit-explorer-mcp-server do?
It lets coding assistants search US tax-exempt entities and inspect IRS Form 990 financial statements using the ProPublica API.
Why is the program expense ratio missing from filings?
The underlying API payload lacks Part IX expense aggregates, so program_expense_ratio returns null and requires checking the linked PDF instead.