# io.github.cyanheads/nonprofit-explorer-mcp-server (remote · nonprofit-explorer.caseyjhand.com)

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

- Trust score: 68/100 (medium)
- Change this week: +5
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `nonprofit-explorer.caseyjhand.com`: 68/100 (this document), [markdown](https://verifymcp.io/servers/cyanheads-nonprofit-explorer-mcp-server/nonprofit-explorer.md), [page](https://verifymcp.io/servers/cyanheads-nonprofit-explorer-mcp-server/nonprofit-explorer)
- npm · `@cyanheads/nonprofit-explorer-mcp-server`: 35/100, [markdown](https://verifymcp.io/servers/cyanheads-nonprofit-explorer-mcp-server/cyanheads-nonprofit-explorer-mcp-server.md), [page](https://verifymcp.io/servers/cyanheads-nonprofit-explorer-mcp-server/cyanheads-nonprofit-explorer-mcp-server)

## Channel facts

- Endpoint: `https://nonprofit-explorer.caseyjhand.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.1.4`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 66/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 3 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 65/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 926 tokens (~308/item across 3 items; 3 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http cyanheads-nonprofit-explorer-mcp-server https://nonprofit-explorer.caseyjhand.com/mcp
```

### Codex

```toml
[mcp_servers.cyanheads-nonprofit-explorer-mcp-server]
url = "https://nonprofit-explorer.caseyjhand.com/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cyanheads-nonprofit-explorer-mcp-server": {
      "type": "remote",
      "url": "https://nonprofit-explorer.caseyjhand.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add cyanheads-nonprofit-explorer-mcp-server --url https://nonprofit-explorer.caseyjhand.com/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  cyanheads-nonprofit-explorer-mcp-server:
    url: "https://nonprofit-explorer.caseyjhand.com/mcp"
```

### Other

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

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 68, +1)

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 67, +2)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 65, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 65, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 64, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 63, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 63)

First indexed and scored.

## MCP tools (3)

### `nonprofit_search` (~463 tokens)

Search Nonprofits

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 paginated at 25 per page; use the page parameter and num_pages to paginate. Total results cap at 10,000 in the API; if total_results === 10000 the actual count may be higher. Supports quoted phrases ("Red Cross"), required terms (+evanston), excluded terms (-dental). Data from ProPublica Nonprofit Explorer, sourced from IRS Form 990 filings.

Input parameters:

- `ntee_category` (string): NTEE (National Taxonomy of Exempt Entities) major group integer (1–10). 1=Arts/Culture/Humanities, 2=Education, 3=Environment/Animals, 4=Health, 5=Human Services, 6=International/Foreign Affairs, 7=P…
- `page` (integer): Zero-indexed page number. 25 results per page. Total pages is in num_pages. Increment to paginate large result sets.
- `query` (string, required): Keyword search string. Searched against org name, alternate name, and city in order of relevance. Supports: quoted phrases ("Red Cross"), required terms (+evanston), excluded terms (-dental). Empty s…
- `state` (string): Two-letter US state abbreviation (e.g., "WA", "NY"). Use "ZZ" for foreign entities. Restricts results to orgs headquartered in that state.
- `subsection_code` (string): 501(c) subsection code. "3" = public charity (most common — donations tax-deductible), "4" = social welfare org, "6" = business league/trade association, "92" = 4947(a)(1) nonexempt charitable trust.…

Output parameters:

- `active_filters` (object): Active filters echoed back for verification.
- `cur_page` (number): Current page (zero-indexed).
- `data_source` (string): ProPublica + IRS attribution text.
- `num_pages` (number): Total pages available (total_results / 25, ceiling).
- `organizations` (array): Matching organizations for the current page.
- `total_results` (number): Total matching orgs (up to 10,000 — the API ceiling). If 10000, actual count may be higher.

### `nonprofit_get_organization` (~156 tokens)

Get Nonprofit Organization

Full profile for a single tax-exempt org by EIN: legal name, address, NTEE classification, 501(c) type, IRS ruling date, and a financial snapshot from the most recent Form 990 filing (revenue, expenses, assets, net assets, and the source PDF link). Use nonprofit_search first if you only have an org name — this tool requires an EIN. Data lags 1–2 years; the tax year is shown prominently. Data from ProPublica Nonprofit Explorer, sourced from IRS Form 990 filings.

Input parameters:

- `ein` (required): Employer Identification Number. Accepts integer (530196605) or string with optional hyphen ("53-0196605"). Obtain from nonprofit_search results.

Output parameters:

- `address`: Street address. Null when not on record.
- `asset_amount`: Most recent IRS BMF total assets in USD. Null when not reported.
- `city`: City. Null when not on record.
- `data_source` (string): ProPublica + IRS attribution text.
- `ein` (number): Employer Identification Number as integer.
- `filing_count` (number): Total filings with extracted data on record.
- `income_amount`: Most recent IRS BMF total income in USD. Null when not reported.
- `latest_filing`: Financial snapshot from the most recent Form 990. Null if no filings_with_data are available.
- `name` (string): Legal org name per IRS.
- `ntee_code`: Full NTEE code (e.g., "E210" = hospital). Null when unclassified.
- `propublica_url` (string): ProPublica Nonprofit Explorer URL for this org.
- `revenue_amount`: Most recent IRS BMF total revenue in USD. Null when not reported.
- `ruling_date`: ISO date of IRS recognition (e.g., "1946-07"). Null when not on record.
- `sort_name`: Alternate or subtitle name from the org record. Null when absent.
- `state`: Two-letter state abbreviation. Null when not on record.
- `strein` (string): EIN in "XX-XXXXXXX" format.
- `subsection_code`: 501(c) subsection number (e.g., 3 = public charity). Null when not classified.
- `zipcode`: ZIP code. Null when not on record.

### `nonprofit_get_filings` (~191 tokens)

Get Nonprofit Filings

All Form 990 filings for a tax-exempt org by EIN: year-by-year revenue, expenses, assets, program-expense ratio (with inputs shown), executive compensation, and source PDF/XML links. Use for trend analysis, due diligence, and accessing primary 990 documents. The filing year (tax_prd_yr) is the fiscal year of the return — data lags 1–2 years; always cite the year. Program expense ratio is computed as (total_expenses − officer comp − other wages − fundraising) / total_expenses for 990/990-EZ; not available for 990-PF. Also returns filings_pdf_only — older filings with a PDF but no extracted financial data. Data from ProPublica Nonprofit Explorer, sourced from IRS Form 990 filings.

Input parameters:

- `ein` (required): Employer Identification Number. Use nonprofit_search to resolve an org name to its EIN.

Output parameters:

- `data_source` (string): ProPublica + IRS attribution text.
- `ein` (number): Employer Identification Number as integer.
- `filings` (array): Filings with extracted financial data, sorted newest first.
- `filings_pdf_only` (array): Older filings with a PDF but no extracted financial data.
- `name` (string): Legal org name per IRS.
- `propublica_url` (string): ProPublica Nonprofit Explorer URL for this org.
- `total_filings_pdf_only` (number): Count of PDF-only filings (no extracted data).
- `total_filings_with_data` (number): Count of filings with extracted financial data.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/cyanheads-nonprofit-explorer-mcp-server/nonprofit-explorer#diagnostics

## Score history

- 2026-08-03: 68
- 2026-08-02: 68
- 2026-08-01: 67
- 2026-07-31: 67
- 2026-07-30: 65
- 2026-07-29: 65
- 2026-07-28: 64
- 2026-07-27: 63
- 2026-07-26: 63

## Links

- Remote endpoint: https://nonprofit-explorer.caseyjhand.com/mcp
- Repository: https://github.com/cyanheads/nonprofit-explorer-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/cyanheads-nonprofit-explorer-mcp-server/nonprofit-explorer/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/cyanheads-nonprofit-explorer-mcp-server/nonprofit-explorer/changelog.json
- HTML version of this page: https://verifymcp.io/servers/cyanheads-nonprofit-explorer-mcp-server/nonprofit-explorer