# nonprofit-explorer-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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1281 installs · ★ 2 repo stars
- Author: cyanheads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyanheads/nonprofit-explorer-mcp-server
- Updated: 2026-10-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/nonprofit-explorer-mcp-server

## What it 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.

## Requirements
- Remote server: `https://nonprofit-explorer-mcp-server--cyanheads.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http nonprofit-explorer-mcp-server https://nonprofit-explorer-mcp-server--cyanheads.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add nonprofit-explorer-mcp-server --url https://nonprofit-explorer-mcp-server--cyanheads.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "nonprofit-explorer-mcp-server": {
            "url": "https://nonprofit-explorer-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "nonprofit-explorer-mcp-server": {
            "type": "http",
            "url": "https://nonprofit-explorer-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http nonprofit-explorer-mcp-server https://nonprofit-explorer-mcp-server--cyanheads.run.tools
```

## When to use it
- 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
- Search for environmental nonprofits in Oregon using `nonprofit_search_organizations`
- Get the financial summary and IRS standing for EIN `53-0196605` via `nonprofit_get_organization`
- Pull all historical Form 990 filings for this EIN to inspect executive compensation and grant payouts

## Similar
- [tres-explorer-tx-to-ledger](https://affpapa.org/en/nevibecode/skills/tres-explorer-tx-to-ledger.md) — skill · ★ 4931 repo stars
- [Granted](https://affpapa.org/en/nevibecode/mcp/granted.md) — MCP server · 2545 installs
- [stock-info-explorer](https://affpapa.org/en/nevibecode/skills/stock-info-explorer.md) — skill · 509 installs
- [decision-tree-explorer](https://affpapa.org/en/nevibecode/commands/decision-tree-explorer.md) — command · 291 installs
- [business-scenario-explorer](https://affpapa.org/en/nevibecode/commands/business-scenario-explorer.md) — command · 273 installs
- [tooluniverse-gwas-study-explorer](https://affpapa.org/en/nevibecode/skills/tooluniverse-gwas-study-explorer.md) — skill · 363 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
