io.github.Kindora-PBC/foundation-discovery

Find grantmakers that have ACTUALLY funded organizations LIKE the caller's, using the real 7.5M-edge who-funds-whom grant graph (IRS 990-PF, 2022-2026). This is the strongest free-tier prospecting move: collaborative-filtering peer prospecting, distinct from search_funders (name/topic lookup) and search_open_grants (active RFPs). HOW IT WORKS: for each peer organization, it looks up every foundation that granted to that peer, then merges funders across peers. A funder that gave to several of your peers ranks highest. Every result carries real grant evidence — which peers the funder funded and for how much. INPUTS (provide one): - peer_orgs (PREFERRED): names or 9-digit EINs of organizations LIKE the one you're raising for — peers, aspirational orgs, or orgs with a similar mission. The graph is keyed by recipient EIN, so naming real peers yields the sharpest evidence. Up to 12 are used. - org_description: a SHORT CAUSE PHRASE, not a paragraph — "food bank", "mental health", "affordable housing". Fallback for when you cannot name peers: it matches the phrase against IRS BMF organization NAMES and, if that finds nothing, against the NTEE cause taxonomy, then uses the best-funded organizations in that cause (biased to `location`). It does NOT search mission text, so a LONGER description matches FEWER orgs, not more — keep it to the cause, and prefer peer_orgs. The response reports which pass produced the peers in `peer_discovery`. RECOMMENDED WORKFLOW: establish the org's mission/cause, then name 2-5 peer organizations and call this tool. Deepen any candidate with get_funder_profile / get_foundation_grants (pass the returned ein).

Find the foundations that have ACTUALLY granted to ONE specific nonprofit — the reverse of get_foundation_grants, over the real 7.5M-edge who-funds-whom grant graph (IRS 990-PF, 2022-2026). Use this when the question is about a SINGLE org: "who funds Greater Chicago Food Depository?", "which foundations support this nonprofit?", or to prospect from one well-funded peer. To aggregate the same signal across SEVERAL peer orgs, use find_funders_for_peers instead. Pass recipient_ein when known (most precise). Otherwise pass recipient_name and it is resolved to the best IRS-registered match — the response echoes which nonprofit it resolved to under 'recipient'; confirm it's the org the caller meant. COVERAGE: US private-foundation (990-PF) grants only. Government grants, corporate giving, and most donor-advised funding do NOT appear, so an empty result means "no tracked foundation reported a grant to this org", not "this org has no funders" — say exactly that.

Get IRS 990 filing summary and financial trends for a foundation. This tool retrieves IRS 990 filing data (Form 990 or 990-PF) for a foundation, showing financial information over time. It calculates year-over-year trends for assets, grants, and revenue.

View grants made by a funder across IRS, web-extracted, and registry records. Merges five stores. **(1) IRS 990-PF filings** — structured grant lines from the ~143K US private foundations that file 990s, keyed by EIN. **(2) Web-extracted grant records** — our enrichment pipeline crawls funder websites and an LLM extracts their grant lists. This second store covers ~15K additional US foundations AND ~17K non-990 funders (European foundations, US community foundations, DAFs, corporate giving programs). **(3) 360Giving** UK GrantNav rows, **(4) CRA T3010** Canadian rows, and **(5) ACRI** Italian banking-foundation erogazioni are structured registry sources with original-currency amounts preserved. Use this for ANY funder when the user asks about grants given, including European funders without an EIN (pass ``funder_id`` instead of ``ein``). Each row in the response carries a ``source`` field (``"990"`` for IRS data, ``"discovered_web"`` for crawled, plus ``"360giving"``, ``"t3010"``, and ``"acri"`` for structured registries). When web-extracted rows for a funder lack captured amounts (common for European funders that publish PDFs rather than open data), the response includes an ``amount_coverage_note`` in ``data_quality`` — surface that caveat in your reply. Note: ``recipient_country`` reflects the recipient organization's HQ country (where the grantee is registered), not necessarily where the program work is implemented.

Get detailed profile information for a specific funder. Polymorphic identifier — pass ``ein`` for US 990 foundations OR ``funder_id`` (bare UUID / ``n9f:<uuid>``) for non-990 funders such as European, UK 360Giving, and Canadian CRA T3010 funders. ``search_funders`` returns both fields on every hit, so the caller can hand either one back here. At least one identifier must be supplied. Use this after searching for funders to get detailed information about a specific one.

Get comprehensive giving statistics for a funder. This tool calculates aggregate statistics about a funder's grantmaking from IRS 990-PF data, web-extracted grant records, 360Giving rows, CRA T3010 rows, and ACRI rows. It provides lifetime totals, focus areas, geographic distribution, and year-over-year trends. Pass ``ein`` for US 990 foundations, or ``funder_id`` (bare UUID / ``n9f:<uuid>``) for non-990 funders.

Browse NTEE (National Taxonomy of Exempt Entities) classification codes. NTEE codes are used to classify nonprofit organizations by their primary purpose. This tool helps you find the right NTEE code for searching or understanding a foundation's focus area.

Check server health and connectivity. Returns: Dictionary with health status including: - status: "healthy" or "unhealthy" - version: Server version - environment: Current environment (dev/staging/prod)

List available MCP tools and get detailed help. Use this tool to discover what tools are available and how to use them. Call without parameters to see all tools, or provide a tool name to get detailed help including parameters, examples, and related tools.

Search OPEN PHILANTHROPY JOBS at grantmaking foundations. Surfaces roles involved in giving away money, running philanthropic programs, or executive leadership of philanthropic work. Backed by a weekly scrape of ~50K funder careers pages + GPT-5.4-mini classification against an 8-category taxonomy. Categories (use the `category` param to filter): - grantmaking: Program officers, grants managers, RFP reviewers - program_leadership: VP Programs, Chief Program Officer, Program Director (cause-area) - executive_leadership: CEO, President, Executive Director at a foundation or community foundation - philanthropy_operations: Foundation finance/HR/IT/COO - program_support: Program associates, M&E officers, learning officers, program coordinators - development_for_grantmaking: Major gifts officers and development roles at community foundations and other regranting entities (NOT university or hospital development for the parent's operations) - philanthropy_communications: Foundation comms staff - philanthropy_strategy: Chief Strategy Officer, impact officer, equity & inclusion at a foundation What's excluded by design: clinical/medical, retail, academic teaching, university advancement for the university itself, hospital fundraising for hospital ops, construction/facilities.

Look up grantmaking organizations by name, topic, or location. This tool searches 174K+ grantmaking organizations from IRS data using organization names plus grant-purpose/topic signals. Use it when you know the funder's name, want aligned funders for a cause area, or want to browse by location/size/NTEE code. Multi-word searches are ranked by relevance; simple browse/name fallback results are ordered by total assets. IMPORTANT: Use search_open_grants when the user needs active grant programs or RFPs. search_funders is for finding aligned grantmakers, including ones that may fund by relationship, LOI, or annual cycle rather than a live call.

Search the ~2M-org universe of US nonprofits (IRS Business Master File) — the RECIPIENT / grantee side, distinct from search_funders (the grantmaker side). Use this to benchmark peer organizations, research a cause's landscape, or find well-funded peers and then look up WHO funds them. Each result carries 990 financials (revenue, program-expense ratio, employees, governance score) and recipient-side funding signals: `total_grants_received` (tracked foundation $ received), `funder_count` (distinct funders), `avg_grant_size_received`, and `funder_concentration_hhi`. CHOOSING THE RIGHT TOOL: - Want FUNDERS to apply to → use search_funders. - Want to research/benchmark RECIPIENT nonprofits (peers, "who received $X", landscape of a cause) → use search_nonprofits. - Found a well-funded peer and want their funders → note its `funder_count`, then use get_foundation_grants / search_funders to find who funds that work.

Search open grant opportunities from Kindora's active foundation-program corpus plus federal and state government grants. FOR-PROFIT APPLICANTS: pass for_profit_applicant=true to search capital a for-profit can take (PRIs, loans, revenue-based financing, patient equity) from CDFIs, impact investors, and PRI-active foundations. The default pool is 501(c)(3)-shaped and will NOT contain those programs. Searches both private foundation grant programs (from IRS data and funder websites) and government grant opportunities — federal (Grants.gov) plus state and district grant portals. Uses full-text search with natural language understanding — queries are parsed into individual terms with stemming, so "youth after school programs" matches programs about youth, after-school, and programming even if those exact words don't appear together. Search covers program names, descriptions, focus areas, beneficiary types, and geographic focus fields. Use the state parameter to focus on geographically relevant opportunities. Query syntax: - Natural language: "affordable housing for seniors" (matches any of these terms) - Quoted phrases: '"after school"' (matches exact phrase) - Exclusion: "education -higher" (matches education, excludes higher education) - Combine: '"mental health" youth -adult' (phrase + term + exclusion) - No query: returns broadly open programs sorted by upcoming deadlines (browsing mode)