cyanheads avatar

Nonprofit Explorer Mcp Server

cyanheads/nonprofit-explorer-mcp-server

Connects Claude to ProPublica's Nonprofit Explorer API for IRS Form 990 data on 1.8 million U.S. tax-exempt organizations. Three tools: search by name or location with state and NTEE filters, fetch full org profiles with financials from the latest 990, and pull complete filing histories with year-by-year revenue, expenses, and program-expense ratios. No API key needed. Returns EINs, ruling dates, executive compensation summaries, and direct links to source PDFs and XML. Useful for grant research, due diligence, or any workflow that needs verified nonprofit financials. Data lags one to two years behind current filings. Built on the mcp-ts-core framework with stdio and streamable HTTP transports.

GitHub stars
2
tools
3
transport
STDIO, HTTP
env vars
7
last updated
Nov 3, 2026

Install

From registry metadata
$ npx add-mcp https://nonprofit-explorer.caseyjhand.com/mcp --name nonprofit-explorer

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http nonprofit-explorer https://nonprofit-explorer.caseyjhand.com/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 3 tools

Verified live against the running server on Nov 6, 2026.

nonprofit_search_organizationsSearch 1.8M+ IRS-recognized tax-exempt organizations by name, keyword, city, or phrase. Optionally narrow by US state, NTEE major sector (1–10), or 501(c) subsection type. Returns EINs — pass them to nonprofit_get_organization or nonprofit_get_filings for details. Results are...5 params

Search 1.8M+ IRS-recognized tax-exempt organizations by name, keyword, city, or phrase. Optionally narrow by US state, NTEE major sector (1–10), or 501(c) subsection type. Returns EINs — pass them to nonprofit_get_organization or nonprofit_get_filings for details. Results are...

Parameters* required
ntee_categorystring
NTEE major group digit string (1–10) or case-insensitive major letter: A→1 Arts/Culture/Humanities, B→2 Education, C–D→3 Environment/Animals, E–H→4 Health, I–P→5 Human Services, Q→6 International/F...one of 1 · 2 · 3 · 4 · 5 · 6
pageinteger
Zero-indexed page number. 25 results per page. Total pages is in num_pages. Increment to paginate large result sets.default: 0
query*string
Keyword search string. Searched against org name, the secondary name line, and city in order of relevance. Supports: quoted phrases ("Red Cross"), required terms (+evanston), excluded terms (-denta...
statestring
US state or territory name (e.g., "Washington", "Puerto Rico") or two-letter state, territory, or military postal code. Trimmed and case-insensitive; normalized to a postal code before filtering. U...
subsection_codestring
501(c) subsection code. "3" = charitable/religious/educational organization (most common — includes both public charities and private foundations; nonprofit_get_organization returns foundation_type...one of 2 · 3 · 4 · 5 · 6 · 7
nonprofit_get_organizationFull profile for a tax-exempt org by EIN: legal identity, IRS classification and BMF filing requirements, latest extracted financial snapshot, and latest return metadata across extracted and PDF-only histories. Use nonprofit_search_organizations first to resolve a name to an E...1 params

Full profile for a tax-exempt org by EIN: legal identity, IRS classification and BMF filing requirements, latest extracted financial snapshot, and latest return metadata across extracted and PDF-only histories. Use nonprofit_search_organizations first to resolve a name to an E...

Parameters* required
ein*value
Employer Identification Number. Accepts integer (530196605) or string with optional hyphen ("53-0196605"). Obtain from nonprofit_search_organizations results.
nonprofit_get_filingsForm 990 history by EIN with extracted financials, form-specific compensation, and PDF-only returns. Optional inclusive from_year/to_year bounds select fiscal years across both histories; omitted bounds return full history. Unfiltered totals remain available. Records are sorte...3 params

Form 990 history by EIN with extracted financials, form-specific compensation, and PDF-only returns. Optional inclusive from_year/to_year bounds select fiscal years across both histories; omitted bounds return full history. Unfiltered totals remain available. Records are sorte...

Parameters* required
ein*value
Employer Identification Number. Use nonprofit_search_organizations to resolve an org name to its EIN.
from_yearinteger
Inclusive minimum fiscal year (tax_prd_yr). Omit for no lower bound.
to_yearinteger
Inclusive maximum fiscal year (tax_prd_yr). Omit for no upper bound.

Sponsors

Configuration

MCP_LOG_LEVELdefault: info

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

MCP_TRANSPORT_TYPEdefault: http

Selects the HTTP transport.

MCP_HTTP_HOSTdefault: 127.0.0.1

The hostname for the HTTP server.

MCP_HTTP_PORTdefault: 3010

The port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATHdefault: /mcp

The endpoint path for the MCP server.

MCP_PUBLIC_URL

Public origin override for deployments behind a TLS-terminating reverse proxy.

MCP_AUTH_MODEdefault: none

Authentication mode to use: 'none', 'jwt', or 'oauth'.

Readme

@cyanheads/nonprofit-explorer-mcp-server

Search and explore 1.8M+ US nonprofits, fetch Form 990 financials, and access IRS filing history via MCP. STDIO or Streamable HTTP.

3 Tools

Details

Repository
github.com/cyanheads/nonprofit-explorer-mcp-server
Category
Data & Analytics
Package
@cyanheads/nonprofit-explorer-mcp-server
Transport
STDIO, HTTP
Registry
MCP registry, active
Resources
1
Tools verified
Nov 6, 2026

More from cyanheads

Related Data & Analytics MCP servers

View all
1rapiercraft avatarMcp Serverrapiercraft/alterlab-mcp-serverWeb scraping MCP server — scrape, extract structured data, screenshot any site with anti-bot bypass.2stars
2slookisen avatarFinn Tannlege Mcpslookisen/lokalNorwegian dental clinic MCP: more than 4,500 clinics with Helfo, specialty and emergency care data.0stars
3lukisch avatarBACH CodeCommanderlukisch/bach-codecommander-mcp17 tools for code analysis, JSON repair, encoding fix, format conversion, diff, and regex.2stars
4malkreide avatarSbb Opendata Mcpmalkreide/sbb-opendata-mcpSBB Open Data via OpenDataSoft2stars
5matiasbattocchia avatarGoogle Mcpmatiasbattocchia/google-mcpStreamable HTTP MCP server for Google Calendar and Sheets with OAuth login.2stars
6tushariitr-19 avatarPatents Mcptushariitr-19/patents-mcpPatent search and prior art discovery via Google Patents on BigQuery2stars