Skip to main content
Glama
propublica-npo-mcp

propublica-npo-mcp

by 2b3pro

propublica-npo-mcp

MCP server exposing the ProPublica Nonprofit Explorer API with curated nonprofit and filing summaries.

Install

npm install

Related MCP server: Charity MCP Server

Run

npm run start

For local development:

npm run dev

Claude Desktop / Cline config

{
  "mcpServers": {
    "propublica-npo": {
      "command": "npx",
      "args": ["tsx", "/absolute/path/to/propublica-npo-mcp/src/index.ts"]
    }
  }
}

Tools

search_nonprofits searches the ProPublica Nonprofit Explorer index by name or keyword, with optional state, NTEE major category, 501(c) subtype, and page filters.

get_organization returns organization metadata plus a curated summary of up to five most recent filings by default. Pass verbose: true to get the raw upstream payload.

list_organization_filings returns all filings for an EIN, newest first. The default output is curated; verbose: true returns the raw filing arrays.

compare_nonprofits compares 2-5 organizations side by side using their latest filing with data, while preserving per-EIN 404s as row-level errors.

Notes

The server uses a 100-entry in-memory LRU cache with a 1-hour TTL. Each upstream request has a 15-second timeout and retries once on network or 5xx failures. ProPublica is public but still rate-limited; if you hit a 429, wait and retry rather than looping.


Support

If this project helps you research nonprofits or build cool agents, consider buying me a coffee! It helps keep the updates coming.

https://paypal.me/2b3/5


License

MIT License - Created by Ian Shen.

Available Tools

4 tools
compare_nonprofitsA

Compare 2-5 nonprofits side by side on key financial metrics from their most recent filing with data.

Inputs: eins (required).

get_organizationA

Get full details for a single nonprofit by EIN, including organization metadata and a summary of the most recent IRS Form 990 filings. Pass verbose=true for the raw upstream payload.

Inputs: ein (required), verbose.

list_organization_filingsA

List all IRS Form 990 filings on file for a nonprofit, newest first. By default returns curated summaries; pass verbose=true for the raw filing arrays.

Inputs: ein (required), verbose.

search_nonprofitsB

Search US nonprofits in the ProPublica Nonprofit Explorer database by name or keyword, with optional filters for state, NTEE major category, and 501(c) subtype.

Inputs: query (required), state, ntee_category, c_code, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: search for nonprofits, get details by EIN, list filings, and compare multiple nonprofits. There is no overlap in functionality.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (compare_nonprofits, get_organization, list_organization_filings, search_nonprofits), ensuring predictability.

    Tool Count5/5

    With 4 tools, the server is well-scoped for its purpose of exploring and comparing nonprofit data. Each tool contributes a core operation without redundancy.

    Completeness4/5

    The tool set covers key operations: search, retrieve details, list filings, and compare. A minor gap is the lack of a tool to retrieve details of a specific filing beyond the summary, but verbose options partially address this.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that provides access to ProPublica's Nonprofit Explorer API, enabling AI models to search and analyze nonprofit organizations' Form 990 data for CRM integration and prospect research.
      1
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to look up IRS nonprofit data, verify tax-deductible charity status, and search for organizations by name or location using the CharityAPI database.
      4
      3
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to query the IRS 990 nonprofit database and OpenRegs federal regulations database via SQL, providing access to nonprofit filings, grants, lobbying, and congressional data.
      Creative Commons Zero v1.0 Universal
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables querying nonprofit organization data through the ProPublica Nonprofit Explorer API, providing access to financial and operational information without authentication.
      96 npm
      MIT