foundation-discovery

{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of funders to return (1-50)'}, 'location': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional 2-letter state or "City, ST". Only biases peer\ndiscovery under org_description; never filters funders.'}, 'peer_orgs': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Names or EINs of peer / aspirational organizations.\nExample: ["Greater Chicago Food Depository", "Feeding America"].'}, 'min_amount': {'type': 'integer', 'default': 5000, 'minimum': 0, 'description': 'Minimum single-grant size in USD (default 5000)'}, 'org_description': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Short cause phrase for the nonprofit (fallback).\nExample: "youth mental health". Adding words narrows the match.'}}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': True}

{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 25, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of funders to return (1-50)'}, 'min_amount': {'type': 'integer', 'default': 1000, 'minimum': 0, 'description': 'Minimum single-grant size in USD (default 1000)'}, 'recipient_ein': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'EIN of the RECIPIENT nonprofit whose funders you want.'}, 'recipient_name': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Name of the recipient nonprofit (resolved via the IRS\nBMF registry when recipient_ein is not given).'}}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': True}

{'type': 'object', 'required': ['ein'], 'properties': {'ein': {'type': 'string', 'description': 'Foundation EIN (9 digits). Can include hyphens (e.g., "94-3136777")\n or be provided as digits only (e.g., "943136777").'}, 'years': {'type': 'integer', 'default': 5, 'maximum': 10, 'minimum': 1, 'description': 'Number of years of filing data to return (1-10)'}}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': True}

{'type': 'object', 'properties': {'ein': {'type': 'string', 'default': '', 'description': 'Foundation EIN (9 digits, hyphens OK). Required for US 990 path.\n Optional if ``funder_id`` is supplied for a non-990 funder.'}, 'year': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Optional year to filter by (filing_year for 990, grant_year\n  for discovered). If not provided, returns all available years.'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of grants to return (1-50)'}, 'funder_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Optional non-990 funder id. Accepts a bare UUID or\n   prefixed id like ``n9f:<uuid>`` / ``non990:<uuid>``. Use this\n   for European funders, US community foundations, DAFs, and\n   other funders that don't file IRS 990-PF. You can get it from\n   search_funders or get_funder_profile."}, 'ntee_code': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional NTEE code to filter recipient organizations.\n  Example: "B41" (Higher Education), "E" (Health).\n  Use get_ntee_codes to browse available codes.'}, 'purpose_keyword': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional case-insensitive substring to match against\n  the grant_purpose field. Useful for narrowing to a topic when\n  recipient NTEE code is too coarse â\x80\x94 e.g., purpose_keyword="vaccine"\n  surfaces Gates grants whose purpose text mentions vaccines, even\n  when the recipient is classified outside health (universities,\n  think tanks, etc.).'}, 'recipient_state': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional 2-letter US state code to filter by\n  recipient state (e.g., "CA", "NY").'}, 'recipient_country': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional recipient country filter. Use ISO\n  3166-1 alpha-2 codes (e.g., "CH" Switzerland, "ZA" South\n  Africa, "NG" Nigeria, "IN" India). A code that is valid ISO\n  is always read as ISO ("NG" is Nigeria, never Niger; "SN" is\n  Senegal, never Singapore); legacy FIPS 10-4 codes match only\n  when they are not ISO codes at all ("UK", "SF"). Output\n  codes are emitted in ISO 3166.'}}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': True}

{'type': 'object', 'properties': {'ein': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Foundation EIN (9 digits) for US 990 funders. Can include hyphens\n (e.g., "94-3136777") or be provided as digits only (e.g., "943136777").\n Optional if ``funder_id`` is supplied for a non-990 funder.'}, 'funder_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional non-990 funder id. Accepts a bare UUID or\n ``n9f:<uuid>`` / ``non990:<uuid>``. The ``usf:<ein>`` prefix is\n also accepted and routes back to the EIN path.'}}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': True}

{'type': 'object', 'properties': {'ein': {'type': 'string', 'default': '', 'description': 'Foundation EIN (9 digits). Can include hyphens (e.g., "94-3136777")\n or be provided as digits only (e.g., "943136777"). Optional when\n funder_id is supplied.'}, 'funder_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional non-990 funder id (bare UUID / ``n9f:<uuid>``).'}}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': True}

{'type': 'object', 'properties': {'query': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Search term to find codes by description (case-insensitive).\n   Example: "education", "youth", "environment"'}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Single letter (A-Z) to browse codes in a major category.\n     Example: "A" for Arts, Culture & Humanities\n             "B" for Education\n             "E" for Health Care\n             "P" for Human Services'}}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': True}

{'type': 'object', 'properties': {}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': True}

{'type': 'object', 'properties': {'tool_name': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional name of a specific tool to get detailed help for.\n      Example: "search_funders", "get_funder_profile"'}}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': True}

{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results to return (1-50)'}, 'query': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Keyword search on job title (case-insensitive substring).\nExamples: "program officer", "grants manager", "CEO",\n"communications director".'}, 'state': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': '2-letter US state code (e.g., "CA", "NY"). Uses a broad SQL\nprefilter plus an exact token-aware post-filter against the\nlocation field.'}, 'remote': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'remote | hybrid | on-site.'}, 'country': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Funder HQ country â\x80\x94 ISO 3166-1 alpha-2 ("US", "GB", "DE") or a\nrecognized name ("United Kingdom", "Germany"). Filters by where the\nFOUNDATION is headquartered; the corpus spans European funders, not\njust US. Independent of `state` (US foundations are the only ones\nwith state-level location data).'}, 'sort_by': {'type': 'string', 'default': 'funder_giving', 'description': "Result ordering. 'funder_giving' (default) ranks by the foundation's annual average giving so the biggest funders surface first. 'recent' sorts by posted_at desc."}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'One of the 8 philanthropy categories above.'}, 'funder_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Restrict to one funder by the polymorphic id search_funders returns and the other funder tools accept: usf:<ein>, n9f:<uuid>, non990:<uuid>, a bare EIN or a bare UUID. Ignored when funder_ein/funder_eins is given.'}, 'seniority': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Experience level: internship_fellowship | entry_level | mid | senior | executive. Comma-separate for multi-select â\x80\x94 'entry_level,internship_fellowship' is the early-career shelf (new grads, students). Rows not yet leveled by the classifier are excluded when set."}, 'funder_ein': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Restrict to one funder by EIN (9 digits, optional\nprefixes/dashes accepted).'}, 'funder_eins': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': "Restrict to a LIST of funder EINs (up to 100). The\nrecommended compositional pattern is search_funders â\x86\x92\nsearch_funder_jobs(funder_eins=[...]) for cause-area searches\n(climate, racial equity, youth, etc.) where the cause isn't\ncaptured by the 8 role-family categories."}, 'employment_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'full-time | part-time | contract | internship |\nfellowship | temporary.'}, 'exclude_categories': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Categories to hide. Default is no category exclusions; the public jobs board includes operations roles. Pass specific category names to suppress them.'}, 'posted_within_days': {'type': 'integer', 'default': 365, 'maximum': 730, 'minimum': 0, 'description': 'Recency window in days (0-730). Set 0 to disable.'}}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': True}

{'type': 'object', 'properties': {'city': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'City name to filter by (case-insensitive).\n   Example: "San Francisco", "New York"'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results to return (1-50)'}, 'metro': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Colloquial metro / region name for sub-state geography a single\n   city can\'t capture â\x80\x94 "Bay Area", "NYC", "the DMV", "Greater\n   Boston", "Los Angeles", "Chicago", "Seattle". Resolved to its\n   MSA/CBSA code set and applied as an HQ pre-filter. PREFER this\n   over `city` whenever the user names a metro/region rather than\n   one municipality (e.g. "Bay Area funders that fund drug rehab"\n   â\x86\x92 query="drug rehab addiction", metro="Bay Area"). Accepts a\n   single name or a list. City names resolve too (\'Cleveland\',\n   \'Knoxville\', \'Portland, OR\'). An unrecognized name does NOT error:\n   the search runs without that metro filter and the result carries\n   `geo_notice` saying so (with a did-you-mean when one is close).\n   Example: "Bay Area", ["NYC", "Greater Boston"]'}, 'query': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Search term for a funder name or cause-area phrase.\n   Example: "Ford Foundation", "global health", "community foundation"\n   Topic searches work best with 2+ words.'}, 'state': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Two-letter US state code to filter by funder HQ location.\n   Example: "CA", "NY", "TX"'}, 'country': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Optional HQ country name (or list of names) to restrict to\n   funders headquartered in those countries (e.g., "Germany",\n   ["United States", "Canada"]). Distinct from\n   `grantee_country_codes` (where the funder\'s grants land) and\n   from `state` (US state of HQ). Use when the user asks for\n   funders based in a specific country â\x80\x94 e.g. "European-headquartered\n   foundations" â\x86\x92 country=["Germany","Spain","United Kingdom",\n   "Switzerland","Netherlands","France"]. US foundations are\n   included only when "United States" (or "USA") is in the list,\n   or when the param is omitted.'}, 'has_pris': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'default': None, 'description': 'Filter to foundations with known program-related investment\n   activity. Set true when looking for PRI-active capital providers.'}, 'msa_codes': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Explicit MSA/CBSA codes when you already know them\n   (e.g. ["41860", "41940"]); unioned with whatever `metro`\n   resolves to. Most callers should use `metro`.'}, 'ntee_code': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'NTEE classification code to filter by.\n   Example: "A20" (Arts Organizations), "B" (Education), "E" (Health)'}, 'max_assets': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Maximum total assets filter in dollars.\n   Example: 100000000 (foundations with up to $100M assets)'}, 'min_assets': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Minimum total assets filter in dollars.\n   Example: 10000000 (foundations with $10M+ assets)'}, 'funder_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional canonical funder_type to include. Examples:\n   "community_foundation", "family_foundation", "corporate_foundation",\n   "private_operating", "operating_nonprofit", "independent_foundation". Use this to narrow to\n   a specific kind of grantmaker. NOTE: operating entities\n   (private_operating, operating_nonprofit) are EXCLUDED BY DEFAULT â\x80\x94\n   name one here to include it (e.g. to look up a specific hospital or\n   patient-assistance foundation).'}, 'has_er_grants': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'default': None, 'description': 'Filter to foundations that make expenditure responsibility grants\n   (grants to non-501(c)(3) entities like PBCs, for-profits, and foreign orgs).\n   Set to True to find only ER-active funders.'}, 'exclude_funder_types': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Optional list of canonical funder_type codes to exclude\n   from results. NOTE: this search ALREADY excludes the operating-entity\n   types by default â\x80\x94 private_operating (pharma patient-assistance\n   foundations) and operating_nonprofit (hospital / university group\n   returns) post large "annual_grants" but aren\'t grantmakers you can\n   apply to. Use this for ADDITIONAL categories; to opt an operating\n   type back in, name it in funder_type instead.'}, 'grantee_country_codes': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Optional list of FIPS 10-4 country codes\n   (e.g., "UK" for United Kingdom, "IN" for India, "KE" for Kenya,\n   "SF" for South Africa) to restrict to funders whose grantees are\n   located in those countries. Use this when the user is asking\n   for funders that move money into a specific non-US geography.\n   Country here is the grantee\'s HQ country, derived from\n   foundation_grants. When set, the search is forced through the\n   hybrid path; the ILIKE-only name-match path cannot filter by\n   country. Distinct from `state`, which filters by the funder\'s\n   own US HQ.'}}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': True}

{'type': 'object', 'properties': {'city': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Case-insensitive exact city name.'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results (1-50)'}, 'metro': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Colloquial metro/region ("Bay Area", "NYC", "Chicago",\n"Greater Boston") or a city name ("Cleveland", "Portland, OR")\nâ\x86\x92 resolved to its MSA codes. Prefer over city for metro-area\nintent. An unrecognized name does not error: the search runs\nwithout the metro filter and the result carries `geo_notice`.'}, 'query': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Case-insensitive substring match on the organization name.'}, 'state': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': '2-letter US state code (e.g. "IL").'}, 'sort_by': {'type': 'string', 'default': 'received', 'description': 'received (default) | revenue | funders | name.'}, 'msa_codes': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Explicit CBSA codes if you already know them.'}, 'ntee_codes': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'NTEE classification PREFIXES (e.g. ["K31"] food banks,\n["E"] health, ["B20"] schools). Prefix match, so "K" = all\nfood/agriculture, "K31" = food banks specifically.'}, 'active_only': {'type': 'boolean', 'default': True, 'description': 'Only IRS-active orgs (default True).'}, 'max_revenue': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None}, 'min_revenue': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None}, 'max_received': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Maximum total received.'}, 'min_received': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Minimum total grant dollars RECEIVED (the key\ngrantee-benchmarking filter â\x80\x94 "received over $1M").'}, 'min_employees': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Minimum employee count.'}, 'min_funder_count': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Minimum distinct funders.'}}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': True}

{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results to return (1-50)'}, 'query': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Natural language search query. Searches across program names, descriptions,\n   focus areas, beneficiary types, and geographic focus. Supports quoted phrases\n   for exact matching and -term for exclusion.\n   Example: "youth outdoor education", "affordable housing", "STEM education for girls",\n            "food bank hunger", "climate change environment", "domestic violence women"'}, 'state': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Two-letter US state code to filter by geographic relevance.\n   Returns programs focused on that state plus nationally available programs.\n   Example: "CA", "NY", "TX"'}, 'topic': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Alias for query. The tool description says 'by TOPIC', so many MCP clients send topic= (32 rejected calls by 2026-07-11) â\x80\x94 accept both; query wins when both are set."}, 'agency': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Filter government grants by agency name (case-insensitive).\n   Example: "Department of Education", "NSF", "NIH"'}, 'source': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Filter by grant source type.\n   Options: "foundation" (private foundation programs only),\n            "government" (federal + state government grants only),\n            or omit for both sources combined.\n   PREFER omitting this â\x80\x94 the foundation corpus is much larger, and\n   filtering to government-only often returns few or zero results.'}, 'country': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Where the applicant works â\x80\x94 a country name or a region.\n   Returns funders scoped to that place PLUS regional and global\n   funders, with place-specific ones ranked first (a Kenyan\n   applicant also sees "Sub-Saharan Africa" and worldwide funders).\n   Native names work ("Deutschland", "Espana"). OMIT when the user\n   has not named a place: "Global"/"International" is accepted but\n   simply means no geographic restriction, so it is never needed.\n   An unrecognised value broadens the search rather than emptying\n   it. Use this instead of state for international queries â\x80\x94\n   passing "India" via state would error because state requires a\n   US code. Mixing state with a non-US country is rejected.\n   Example: "India", "Kenya", "Southeast Asia", "Deutschland"'}, 'max_award': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Maximum grant size filter in dollars.\n   Example: 500000 (grants up to $500K)'}, 'min_award': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Minimum grant size filter in dollars.\n   Example: 50000 (grants of $50K+)'}, 'focus_area': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Filter foundation programs by focus area (matches values in focus_areas array).\n   Example: "Education", "Health", "Environment"'}, 'deadline_days': {'type': 'integer', 'default': 90, 'maximum': 365, 'minimum': 1, 'description': 'Deadline lookahead window in days (1-365)'}, 'nonprofit_only': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'default': None, 'description': 'GOVERNMENT-grants applicant filter only. Omit for the entity-aware default: true for nonprofits and false for for-profit applicants. Does not open the foundation pool â\x80\x94 use for_profit_applicant.'}, 'for_profit_applicant': {'type': 'boolean', 'default': False, 'description': 'Set TRUE when the applicant is a FOR-PROFIT entity (social enterprise, public benefit corporation, B Corp, L3C, CDFI). Routes foundation-program search to the for-profit capital pool: loans, program-related investments, revenue-based financing, patient equity, guarantees â\x80\x94 capital a company can actually take. Default False = the 501(c)(3) grant pool, which deliberately excludes those instruments.'}}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': True}