{"openapi":"3.1.0","info":{"title":"Charity Navigator (BYOK) API","version":"0.1.0","description":"Charity Navigator (BYOK) lets an AI assistant read your own Charity Navigator data through the Charity Navigator API with a key you supply (Charity Navigator Data API key (subscription plan with a 30-day trial)). Read-only: 7 tools (search_nonprofits, lookup_nonprofit_by_ein, search_nonprofits_by_cause, list_nonprofits_bulk, list_giving_alerts, list_giving_alerts_by_level,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-charity-navigator.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-charity-navigator/docs"},"termsOfService":"https://connectorbay.com/byok-charity-navigator/terms"},"servers":[{"url":"https://byok-charity-navigator.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-charity-navigator/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/search_nonprofits":{"post":{"operationId":"search_nonprofits","summary":"Search rated US nonprofits by name or EIN with optional state, size, star rating, cause and 501(c)(3) filters; returns r","description":"Search rated US nonprofits by name or EIN with optional state, size, star rating, cause and 501(c)(3) filters; returns ratings, mission, location and alert level. Counts against the plan's monthly request quota. Use for \"Which 4-star food banks in Illinois does Charity Navigator rate\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Name words or an exact 9-digit EIN to search for. Leave out to filter only.","title":"Term"},"state":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Two-letter US state code to filter by, for example 'CA'.","title":"State"},"size":{"anyOf":[{"enum":["MICRO","SMALL","MEDIUM","LARGE","SUPER"],"type":"string"},{"type":"null"}],"default":null,"description":"Charity size: MICRO, SMALL, MEDIUM, LARGE or SUPER (by annual revenue).","title":"Size"},"stars":{"anyOf":[{"enum":["0","1","2","3","4"],"type":"string"},{"type":"null"}],"default":null,"description":"Only nonprofits with this Encompass star rating, 0 to 4.","title":"Stars"},"cause":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Cause name from the Candid subject taxonomy, for example 'Food banks'.","title":"Cause"},"is_rated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for only rated nonprofits, false for only unrated; leave out for both.","title":"Is Rated"},"only_501c3":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to return only 501(c)(3) organizations.","title":"Only 501C3"},"order_by":{"anyOf":[{"enum":["relevance","rating","size"],"type":"string"},{"type":"null"}],"default":"relevance","description":"Sort style: relevance, rating or size.","title":"Order By"},"result_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100).","title":"Result Size"},"offset":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of results to skip, for paging.","title":"Offset"}},"title":"search_nonprofitsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/lookup_nonprofit_by_ein":{"post":{"operationId":"lookup_nonprofit_by_ein","summary":"Look up one US nonprofit by its 9-digit EIN: Encompass score and stars, mission, size, location, causes and alert level.","description":"Look up one US nonprofit by its 9-digit EIN: Encompass score and stars, mission, size, location, causes and alert level. Use for \"What is the Charity Navigator rating for EIN 53-0196605\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ein":{"description":"Employer Identification Number as 9 digits without a dash, for example '530196605'.","maxLength":9,"title":"Ein","type":"string"},"only_501c3":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to return only 501(c)(3) organizations.","title":"Only 501C3"},"result_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100).","title":"Result Size"}},"required":["ein"],"title":"lookup_nonprofit_by_einArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_nonprofits_by_cause":{"post":{"operationId":"search_nonprofits_by_cause","summary":"List rated nonprofits working on one cause, optionally narrowed by state and star rating, best rated first. Use for \"Whi","description":"List rated nonprofits working on one cause, optionally narrowed by state and star rating, best rated first. Use for \"Which highly rated charities work on clean water\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cause":{"description":"Cause name from the Candid subject taxonomy, for example 'Clean water supply'.","maxLength":100,"title":"Cause","type":"string"},"state":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Two-letter US state code to filter by, for example 'CA'.","title":"State"},"stars":{"anyOf":[{"enum":["0","1","2","3","4"],"type":"string"},{"type":"null"}],"default":null,"description":"Only nonprofits with this Encompass star rating, 0 to 4.","title":"Stars"},"only_501c3":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to return only 501(c)(3) organizations.","title":"Only 501C3"},"result_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100).","title":"Result Size"},"offset":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of results to skip, for paging.","title":"Offset"}},"required":["cause"],"title":"search_nonprofits_by_causeArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_nonprofits_bulk":{"post":{"operationId":"list_nonprofits_bulk","summary":"Page through rated nonprofits by EIN order with optional state, size, star and alert-level filters, up to 100 per call. ","description":"Page through rated nonprofits by EIN order with optional state, size, star and alert-level filters, up to 100 per call. Needs a plan that includes bulk data. Use for \"List the first 100 rated large nonprofits in California\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"state":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Two-letter US state code to filter by, for example 'CA'.","title":"State"},"size":{"anyOf":[{"enum":["MICRO","SMALL","MEDIUM","LARGE","SUPER"],"type":"string"},{"type":"null"}],"default":null,"description":"Charity size: MICRO, SMALL, MEDIUM, LARGE or SUPER (by annual revenue).","title":"Size"},"stars":{"anyOf":[{"enum":["0","1","2","3","4"],"type":"string"},{"type":"null"}],"default":null,"description":"Only nonprofits with this Encompass star rating, 0 to 4.","title":"Stars"},"is_rated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for only rated nonprofits, false for only unrated; leave out for both.","title":"Is Rated"},"only_501c3":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to return only 501(c)(3) organizations.","title":"Only 501C3"},"after_ein":{"anyOf":[{"maxLength":9,"type":"string"},{"type":"null"}],"default":"","description":"Continue after this EIN (the last EIN of the previous page); empty starts at the beginning.","title":"After Ein"},"alert_level":{"anyOf":[{"enum":["Review Before Proceeding","Proceed with Caution","Proceed with Increased Caution","Giving Not Recommended"],"type":"string"},{"type":"null"}],"default":null,"description":"Only nonprofits with this alert level.","title":"Alert Level"},"cause":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Cause name from the Candid subject taxonomy, for example 'Food banks'.","title":"Cause"},"result_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100).","title":"Result Size"}},"title":"list_nonprofits_bulkArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_giving_alerts":{"post":{"operationId":"list_giving_alerts","summary":"List published Charity Navigator alerts, newest first, with nonprofit, level (LOW to HIGHEST), severity, offense and sta","description":"List published Charity Navigator alerts, newest first, with nonprofit, level (LOW to HIGHEST), severity, offense and status. Needs a plan with premium data. Use for \"What are the newest Charity Navigator alerts at the highest level\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"first":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many alerts to return (1 to 50).","title":"First"},"after":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous page's endCursor.","title":"After"}},"title":"list_giving_alertsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_giving_alerts_by_level":{"post":{"operationId":"list_giving_alerts_by_level","summary":"List published alerts at one level (LOW, MEDIUM, HIGH or HIGHEST), newest first. Needs a plan with premium data. Use for","description":"List published alerts at one level (LOW, MEDIUM, HIGH or HIGHEST), newest first. Needs a plan with premium data. Use for \"Which charities currently carry a HIGHEST giving alert\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"level":{"description":"Alert level: LOW, MEDIUM, HIGH or HIGHEST.","enum":["LOW","MEDIUM","HIGH","HIGHEST"],"title":"Level","type":"string"},"first":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many alerts to return (1 to 50).","title":"First"},"after":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous page's endCursor.","title":"After"}},"required":["level"],"title":"list_giving_alerts_by_levelArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_giving_alerts_for_nonprofit":{"post":{"operationId":"list_giving_alerts_for_nonprofit","summary":"List published alerts for one nonprofit by exact EIN. Needs a plan with premium data. Use for \"Does this charity have an","description":"List published alerts for one nonprofit by exact EIN. Needs a plan with premium data. Use for \"Does this charity have any Charity Navigator alerts\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ein":{"description":"Employer Identification Number, 9 digits without a dash.","maxLength":9,"title":"Ein","type":"string"},"first":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many alerts to return (1 to 50).","title":"First"}},"required":["ein"],"title":"list_giving_alerts_for_nonprofitArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}