Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Nonprofit Explorer MCP Server

by cyanheadsversion 0.3.0i★ 2iComputer or cloudOfficial site ↗
Registry nameio.github.cyanheads/nonprofit-explorer-mcp-server

How to install

What it does

MCP server for nonprofit financials via ProPublica: IRS Form 990 data for 1.8M+ nonprofits.

  • Connects Computer or cloud
  • Account or key No key needed
  • Category Other

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity15/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering8/8The cloud endpoint answered at the last check
Usage score35/100

Quality: Passed 5/5 basic checks (shown, not used for ordering) · Momentum: 11 (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Nonprofit Explorer MCP Server. Follow https://mcp.popnx.com/i/cyanheads-nonprofit-explorer-mcp-server.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 5/5 checks · What you ask goes through the maker’s server (nonprofit-explorer.caseyjhand.com) · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameNonprofit Explorer MCP Server
    Remote MCP server URL · Addresshttps://nonprofit-explorer.caseyjhand.com/mcp

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +ConnectorsNonprofit Explorer MCP Server

  4. Try it

    Use Nonprofit Explorer MCP Server and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Nonprofit Explorer MCP Server or shows a Nonprofit Explorer MCP Server tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NameNonprofit Explorer MCP Server
    Connection · Addresshttps://nonprofit-explorer.caseyjhand.com/mcp
  3. Pick Nonprofit Explorer MCP Server in a chat

    Start a new chat and pick Nonprofit Explorer MCP Server from your plugins before typing

  4. Try it

    Use Nonprofit Explorer MCP Server and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using Nonprofit Explorer MCP Server or shows a Nonprofit Explorer MCP Server tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user nonprofit-explorer https://nonprofit-explorer.caseyjhand.com/mcp
  3. Type /mcp in Claude Code

    You should see Nonprofit Explorer MCP Server listed as connected

  4. Try it

    Use Nonprofit Explorer MCP Server and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Nonprofit Explorer MCP Server or shows a Nonprofit Explorer MCP Server tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use Nonprofit Explorer MCP Server and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Nonprofit Explorer MCP Server or shows a Nonprofit Explorer MCP Server tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use Nonprofit Explorer MCP Server and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Nonprofit Explorer MCP Server or shows a Nonprofit Explorer MCP Server tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://nonprofit-explorer.caseyjhand.com/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use Nonprofit Explorer MCP Server💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

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

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "nonprofit-explorer": {
      "url": "https://nonprofit-explorer.caseyjhand.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "nonprofit-explorer": {
      "type": "http",
      "url": "https://nonprofit-explorer.caseyjhand.com/mcp"
    }
  }
}

Installed on your computer

Claude Code

claude mcp add --scope user nonprofit-explorer -- npx -y @cyanheads/nonprofit-explorer-mcp-server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "nonprofit-explorer": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/nonprofit-explorer-mcp-server"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "nonprofit-explorer": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/nonprofit-explorer-mcp-server"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "nonprofit-explorer": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/nonprofit-explorer-mcp-server"
      ]
    }
  }
}

Values you fill in

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

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
406/wk
Licencei
Apache-2.0
Connection
Computer or cloud
Transport
stdio, streamable-http
Latest versioni
0.3.0
Categoryi
Other
Published to registryi
Nov 3, 2026
Code last changedi
Nov 13, 2026
Last checked
Nov 18, 2026
Maker
cyanheads
Packages
npm: @cyanheads/nonprofit-explorer-mcp-server
npm: @cyanheads/nonprofit-explorer-mcp-server
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 18, 2026. The maker wrote them, not us; we show them as plain text.

  • nonprofit_search_organizations

    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 pag

  • nonprofit_get_organization

    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 EIN.

  • nonprofit_get_filings

    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 sorted b

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account cyanheads, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 6 days ago

  • ✓ Pass

    Has a licence

    Uses Apache-2.0

  • ✓ Pass

    Endpoint responds

    Responded in 241 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 3 tool descriptions and found no hidden instructions to the AI

The cloud address answered 4 of the last 4 checks · latest 241 ms · checked Nov 18, 2026

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for @cyanheads/nonprofit-explorer-mcp-server@0.3.0

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/cyanheads-nonprofit-explorer-mcp-server.svg)](https://mcp.popnx.com/en/servers/cyanheads-nonprofit-explorer-mcp-server)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Otheri

  • More stars than 91% of the other 20653 servers in this category
  • Published to the registry more recently than 75% of the other 20653 servers in this category
  • Basic checks equal to or better than 99% of the other 20653 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Nonprofit Explorer MCP Server safe?

It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed 6 days ago, and the latest version (0.3.0) reached the registry 16 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

by koala73Widely used★ 90.9KUpdated 3 days ago

Runs in the cloud✓ service owner · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

by openstatusHQWidely used★ 9.3KUpdated 2 months ago

Runs in the cloud✓ service owner · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

by JanDeDobbeleerWidely used★ 23.8K Stars for the whole repoUpdated 30 days ago

Runs in the cloud✓ service owner · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

by Klavis-AIGrowing★ 5.8KUpdated 14 months ago

Runs in the cloudRepo archived✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

by jitsucomWidely used★ 5.1KUpdated 4 months ago

Runs in the cloud✓ service owner · jitsu.com
Compared with similar ones
This one
Nonprofit Explorer MCP Server
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Runs whereCloud or install on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks5/54/44/44/41/44/4
LicenseApache-2.0AGPL-3.0AGPL-3.0MITApache-2.0MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

@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

Public Hosted Server: https://nonprofit-explorer.caseyjhand.com/mcp


Overview

IRS Form 990 data for 1.8M+ tax-exempt organizations, via the ProPublica Nonprofit Explorer API. Search by name, fetch an org's financial snapshot, and pull its full filing history.

Tools
ToolDescription
nonprofit_search_organizationsSearch 1.8M+ IRS-recognized tax-exempt organizations by name, keyword, city, or phrase with optional state, NTEE sector, and 501(c) filters
nonprofit_get_organizationFull profile by EIN: legal identity, IRS classification, filing requirements, newest-return metadata, and latest extracted financial snapshot
nonprofit_get_filingsForm 990 history by EIN, optionally filtered by fiscal year: financials, fundraising figures, executive compensation, and source PDF links

Capability reference

nonprofit_search_organizations tool
  • Full-text query — supports quoted phrases ("Red Cross"), required terms (+evanston), excluded terms (-dental)
  • Optional filters: state/territory name or postal code (including military codes and ZZ for foreign entities), NTEE major sector (1–10 or a case-insensitive major letter), and 501(c) subsection code (3 covers both public charities and private foundations — see foundation_type on nonprofit_get_organization to tell them apart). Names and letters normalize to the upstream codes shown in active_filters; unrecognized states are rejected before a request
  • sub_name is the upstream legal name with an optional secondary line; it can repeat name or be null
  • Paginated at 25 per page (page, zero-indexed); num_pages, per_page, and page_offset track position
  • API caps total results at 10,000 — total_results === 10000 means the actual count may be higher, and a page whose offset reaches that ceiling is refused (pagination_ceiling)
  • Zero matches and a page past the last one both succeed with an empty organizations array and a notice explaining which case it is
  • Returns EINs — pass to nonprofit_get_organization or nonprofit_get_filings for details

nonprofit_get_organization tool
  • Accepts EIN as integer (530196605) or string with or without hyphen ("53-0196605"); use nonprofit_search_organizations first if you only have an org name
  • Returns legal identity, address, NTEE code, 501(c) type, and IRS ruling date
  • IRS Business Master File standing: deductibility (including the deductible-by-treaty case), exemption status, and public-charity vs. private-foundation classification — each decoded from its IRS code with the raw code retained
  • latest_filing is the latest extracted financial snapshot: revenue, expenses, assets, liabilities, net assets, and source PDF link. latest_return separately identifies the newest return across extracted and PDF-only histories; a newer return need not have extracted figures
  • Filing requirements, private-foundation filing requirements, affiliation, and group exemption number come from the IRS Business Master File. Empty-history guidance uses these codes without claiming why a particular filing is absent
  • filing_count counts filings with extracted data; filing_count_pdf_only separately counts PDFs without financial extracts. Use nonprofit_get_filings for those links; PDF-only histories have no financial snapshot
  • Data lags 1–2 years — tax_prd_yr in the snapshot is the fiscal year of the filing, not the current year

nonprofit_get_filings tool
  • All Form 990 filings with extracted data, sorted by full tax period newest first — per filing: revenue, expenses, assets, liabilities, net assets, revenue breakdown (contributions, program service, investment income), and the source PDF link
  • Optional inclusive from_year / to_year bounds apply to both extracted and PDF-only histories. Totals remain unfiltered; an empty selected interval does not mean the organization has no history
  • Financial fields follow each return's form type. For 990-PF, investment income is savings interest plus dividends and securities interest (Part I column (a), lines 3–4); both components must be extracted. It excludes capital gains, rents, and net investment income
  • 990-PF filings include grants_paid, distributable_amount, fair_market_value_assets, and net_investment_income. The distributable amount is a payout requirement, not actual payments or a compliance measure
  • program_expense_ratio is always null — ProPublica returns no Form 990 Part IX program-service expense total, so the program/management/fundraising split is only in the source PDF
  • Form 990 includes other salaries and wages, payroll taxes, professional fundraising fees, and fundraising event gross, direct expenses, and net income. For 990-EZ, event gross is separate from combined gaming/fundraising expenses and net income; the combined figures cannot establish event-only results
  • Executive compensation includes the source field for 990 and 990-PF. The 990-EZ extract has no compensation source: amount and field name are null, with guidance to Part IV of the PDF
  • filings_pdf_only retains fiscal years and tax periods for returns without extracted data, including returns newer than the financial snapshots
  • An EIN that resolves to a real org with no 990 on record returns an empty filings array plus a notice, not an error
  • Data lags 1–2 years — always cite tax_prd_yr (fiscal year) when presenting figures

Features

Built on @cyanheads/mcp-ts-core: stdio and Streamable HTTP transports, pluggable auth (none / jwt / oauth), swappable storage (in-memory, filesystem, Supabase, Cloudflare KV/R2/D1), structured logging with optional OpenTelemetry tracing.

ProPublica Nonprofit Explorer / IRS-specific:

  • Keyless access — ProPublica Nonprofit Explorer API requires no API key
  • Covers 1.8M+ IRS-recognized tax-exempt organizations
  • IRS Form 990 data: annual filings for public charities (990), small orgs (990-EZ), and private foundations (990-PF)
  • Source filing PDF link on every filing record, except where IRS PDF processing lags the extracted data and pdf_url is still null
  • Data sourced from ProPublica Nonprofit Explorer, derived from IRS Form 990 filings; data lags 1–2 years

Agent-friendly output:

  • Provenance on every response — data_source attribution on all tool outputs, ProPublica URL for direct verification
  • Filing-year clarity — tax_prd_yr prominently labeled as fiscal year with explicit lag caveat in every financial response
  • Null values are rendered, not dropped — the formatted text names why a value is absent (never recorded by the IRS, not extracted from the filing, not carried by that form type), and structuredContent keeps an explicit null rather than omitting the key
  • Field-name transparency on compensation — field_name and form_type exposed so agents know exactly which IRS field was read

The published nonprofit-explorer-guide covers diligence, financial comparisons, and when to inspect the source return. It is included in npm, Docker, and desktop bundles and served through MCP skill resources.

Getting started

Public Hosted Instance

A public instance is available at https://nonprofit-explorer.caseyjhand.com/mcp — no installation required. Point any MCP client at it via Streamable HTTP, with this client config:

{

"mcpServers": { "nonprofit-explorer-mcp-server": { "type": "streamable-http", "url": "https://nonprofit-explorer.caseyjhand.com/mcp" } } }

Self-Hosted / Local

Add the following to your MCP client configuration file.

{

"mcpServers": { "nonprofit-explorer-mcp-server": { "type": "stdio", "command": "bunx", "args": ["@cyanheads/nonprofit-explorer-mcp-server@latest"], "env": { "MCP_TRANSPORT_TYPE": "stdio", "MCP_LOG_LEVEL": "info" } } } }

Or with npx (no Bun required):

{

"mcpServers": { "nonprofit-explorer-mcp-server": { "type": "stdio", "command": "npx", "args": ["-y", "@cyanheads/nonprofit-explorer-mcp-server@latest"], "env": { "MCP_TRANSPORT_TYPE": "stdio", "MCP_LOG_LEVEL": "info" } } } }

Or with Docker:

{

"mcpServers": { "nonprofit-explorer-mcp-server": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "-e", "MCP_TRANSPORT_TYPE=stdio", "ghcr.io/cyanheads/nonprofit-explorer-mcp-server:latest" ] } } }

For Streamable HTTP, set the transport and start the server:

MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 bun run start:http

Server listens at http://localhost:3010/mcp

Prerequisites
  • Bun v1.4.0 or higher (or Node.js v24+).
  • No API key required — ProPublica Nonprofit Explorer is a keyless public API.
Installation
  1. Clone the repository:
git clone https://github.com/cyanheads/nonprofit-explorer-mcp-server.git
  1. Navigate into the directory:
cd nonprofit-explorer-mcp-server
  1. Install dependencies:
bun install
  1. Configure environment:
cp .env.example .env

edit .env as needed (no required vars — server works out of the box)

Configuration

All configuration is validated at startup. Key environment variables:

VariableDescriptionDefault

| `MCP_TRANSPORT_TYPE

Only the beginning is shown; read the rest in the repo