{"protocolVersion":"0.3.0","name":"CharitySense","description":"Agent-ready nonprofit due diligence surface over public U.S. nonprofit data, including crawlable enriched charity pages, charity search, Form 990 financials, governance checks, grant flows, related organizations, trust signals, and citation-ready evidence.","url":"https://data.charitysense.com","supportedInterfaces":[{"protocolBinding":"OPENAPI","url":"https://data.charitysense.com/openapi.yaml","protocolVersion":"0.3.0"}],"preferredTransport":"OPENAPI","additionalInterfaces":[{"transport":"OPENAPI","url":"https://data.charitysense.com/openapi.yaml"},{"transport":"HTTP+JSON","url":"https://data.charitysense.com"}],"provider":{"organization":"CharitySense","url":"https://charitysense.com"},"version":"1.3.0","documentationUrl":"https://data.charitysense.com/agents","api":{"type":"openapi","base_url":"https://data.charitysense.com","spec_url":"https://data.charitysense.com/openapi.yaml","auth":{"public_research_reads":"none","assistant_operations":["Bearer token","X-CharitySense-API-Key"]},"operation_policy":"Research reads are metered daily. Paid Advanced operations are consequential; obtain user confirmation before every POST."},"discovery":{"agents_page":"https://data.charitysense.com/agents","ai_txt":"https://data.charitysense.com/ai.txt","llms_txt":"https://data.charitysense.com/llms.txt","llms_full_txt":"https://data.charitysense.com/llms-full.txt","instructions":"https://data.charitysense.com/INSTRUCTIONS_FOR_AGENTS.md","openapi":"https://data.charitysense.com/openapi.yaml","agent_manifest":"https://data.charitysense.com/.well-known/agent.json","a2a_agent_card":"https://data.charitysense.com/.well-known/agent-card.json","plugin_manifest":"https://data.charitysense.com/.well-known/ai-plugin.json","feedback_endpoint":"https://data.charitysense.com/api/v2/agent-feedback","sitemap":"https://data.charitysense.com/sitemap.xml","public_profile_url_template":"https://data.charitysense.com/charity/{ein}"},"coverage":{"jurisdiction":"United States","entity_scope":"U.S.-registered nonprofits and charities","source_data":"Public IRS Form 990 filings, derived CharitySense filing signals, and official-source public profile enrichment where available","approximate_organizations":2200000,"approximate_filings":8800000,"data_lag":"IRS Form 990 data is historical and can lag current operations.","live_stats_url":"https://data.charitysense.com/api/v2/stats"},"citation":{"preferred":"CharitySense public charity profile, https://data.charitysense.com/charity/{ein}","include_filing_year":true,"caveat":"Financial figures are based on IRS Form 990 filings and may lag current operations. Public profile enrichment uses official-source website evidence where available."},"primaryTools":[{"name":"searchCharities","method":"GET","path":"/api/v2/search","description":"Use first with the required Query parameter for charity names, EINs, donor intent, geography, causes, and ranking."},{"name":"getCharityPage","method":"GET","path":"/api/v2/charity/{ein}/page","description":"Get the bounded selected-form profile shell, live verdict, and available section manifest."},{"name":"getCharitySection","method":"GET","path":"/api/v2/charity/{ein}/sections/{SectionId}","description":"Get one section whose Id was advertised by getCharityPage."},{"name":"getCharityFilings","method":"GET","path":"/api/v2/charity/{ein}/filings","description":"Page through filing metadata for one available form context."},{"name":"getCharityMoneyNetwork","method":"GET","path":"/api/v2/charity/{ein}/money-network","description":"Page through exact latest directed counterparty evidence."},{"name":"discoverRelatedOrganizations","method":"GET","path":"/api/v2/charity/{ein}/discovery","description":"Discover organizations related by cause, region, mission, or explicit Intent."},{"name":"getDatasetStats","method":"GET","path":"/api/v2/stats","description":"Get dataset-wide counts and aggregate sector totals."},{"name":"sendAgentFeedback","method":"POST","path":"/api/v2/agent-feedback","description":"Advanced action: send agent identity, purpose, task, result quality, and desired-data feedback to improve CharitySense."}],"capabilityTags":["nonprofit_search","irs_990_analysis","charity_comparison","donor_research","financial_metrics","governance_review","zakat_and_religious_giving_research","beneficiary_geography_search","public_charity_profile_pages","enhanced_json_ld"],"agentIdentity":["X-Agent-Name","X-Agent-Version","X-Agent-Platform","X-Agent-Stack","X-Agent-Owner","X-Agent-Contact","X-Agent-Purpose","X-Agent-Community","X-Agent-Session"],"feedbackUrl":"https://data.charitysense.com/api/v2/agent-feedback","readOnly":false,"auth":{"type":"none"},"notice":"CharitySense exposes public research reads plus paid, explicitly consequential Advanced operations over OpenAPI/HTTP. It does not expose an A2A JSON-RPC task endpoint. Use openapi.yaml for the callable operation and security contract.","capabilities":{"streaming":false,"pushNotifications":false,"stateTransitionHistory":false,"extendedAgentCard":false,"supportsAuthenticatedExtendedCard":false,"extensions":[{"uri":"https://spec.openapis.org/oas/v3.1.0","description":"CharitySense HTTP API contract at https://data.charitysense.com/openapi.yaml.","required":false}]},"securitySchemes":{},"security":[],"securityRequirements":[],"defaultInputModes":["text/plain","application/json"],"defaultOutputModes":["application/json","text/plain"],"skills":[{"id":"cite_public_charity_profile","name":"Cite the public charity profile","description":"Use the public /charity/{ein} page as the citation target for crawlable mission, programs, sector, operating places, leadership, governance, impact, source evidence, and enhanced JSON-LD where available.","tags":["public_profile","citation","json_ld","seo","geo"],"examples":["Cite the public CharitySense profile for EIN 954453134.","Use the public profile page for mission and program evidence."],"inputModes":["text/plain","application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[]},{"id":"search_charities","name":"Search U.S. nonprofits","description":"Search CharitySense public nonprofit data and Form 990 signals by charity name, EIN, mission, cause, donor intent, geography, revenue, rating, state, or category.","tags":["nonprofit","charity","donor_research","irs_990"],"examples":["Find trustworthy clean water charities with strong financials.","Search for U.S. charities serving Gaza or Pakistan."],"inputModes":["text/plain","application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[]},{"id":"get_charity_profile","name":"Get charity identity and trust profile","description":"Return the bounded first-paint charity page: selected form context, identity, mission, location, live verdict, and the manifest of sections available for lazy retrieval.","tags":["ein_lookup","nonprofit_profile","identity","trust"],"examples":["Get the profile for EIN 530196605."],"inputModes":["text/plain","application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[]},{"id":"get_charity_section","name":"Get an advertised charity section","description":"Retrieve one section advertised by the charity page, such as financials, governance, leadership, schedules, filing consistency, related organizations, or web evidence.","tags":["sections","evidence","financials","governance"],"examples":["Fetch the MoneyFlow section advertised for EIN 131644147."],"inputModes":["text/plain","application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[]},{"id":"get_charity_filings","name":"List charity filings","description":"List filing metadata for one available form context, with cursor-based retrieval for historical filing records.","tags":["filings","history","form_contexts"],"examples":["List Form 990PF filings for EIN 530196605."],"inputModes":["text/plain","application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[]},{"id":"analyze_money_flows","name":"Analyze money flows and grants","description":"Page through exact latest directed counterparties and graph evidence. Use an advertised MoneyFlow section for the selected filing's complete revenue and expense presentation.","tags":["grants","money_flows","schedule_f","schedule_i","fundraising"],"examples":["Where did this charity's grants go in its latest filing?"],"inputModes":["text/plain","application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[]},{"id":"discover_related_organizations","name":"Discover related organizations","description":"Discover other organizations related by the selected profile's cause, mission, or an explicit discovery intent.","tags":["discovery","related_organizations","cause","mission"],"examples":["Find organizations related to EIN 530196605."],"inputModes":["text/plain","application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[]},{"id":"get_dataset_stats","name":"Get dataset-wide statistics","description":"Retrieve dataset scale and aggregate public corpus totals, including organization count, filing count, sector revenue, and program spending.","tags":["dataset_stats","coverage","aggregate_financials"],"examples":["How many nonprofits and filings does CharitySense cover?"],"inputModes":["text/plain","application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[]},{"id":"send_agent_feedback","name":"Send result or data feedback","description":"Let CharitySense know when an agent needed different data, better ranking, clearer fields, missing context, or a new endpoint for its task.","tags":["feedback","agent_identity","api_improvement"],"examples":["Report that a disaster-relief query needed grant-recipient geography.","Tell CharitySense that an answer needed clearer published zakat-policy evidence."],"inputModes":["text/plain","application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[]}],"iconUrl":"https://data.charitysense.com/logo.svg"}