{"schema_version":"1.0","protocolVersion":"0.3.0","name":"CharitySense","legal_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","version":"1.3.0","provider":{"organization":"CharitySense","url":"https://charitysense.com","legalEntity":{"name":"Osci Labs LLC","jurisdiction":"US","entity_type":"LLC","identifier_type":"EIN","identifier":"99-0651763"}},"publisher":{"name":"CharitySense","url":"https://charitysense.com"},"contact":{"email":"mazhar@charitysense.com","url":"https://data.charitysense.com/contact"},"support_url":"https://data.charitysense.com/contact","privacy_policy_url":"https://data.charitysense.com/privacy","main_site_url":"https://charitysense.com","capabilities":{"streaming":false,"pushNotifications":false,"stateTransitionHistory":false},"defaultInputModes":["text/plain","application/json"],"defaultOutputModes":["application/json","text/plain"],"homepage_url":"https://data.charitysense.com","agent_url":"https://data.charitysense.com/agents","developer_url":"https://data.charitysense.com/developers","openapi_url":"https://data.charitysense.com/openapi.yaml","llms_url":"https://data.charitysense.com/llms.txt","llms_full_url":"https://data.charitysense.com/llms-full.txt","ai_txt_url":"https://data.charitysense.com/ai.txt","ai_profile_url":"https://data.charitysense.com/ai-profile.json","instructions_url":"https://data.charitysense.com/INSTRUCTIONS_FOR_AGENTS.md","custom_gpt_url":"https://chatgpt.com/g/g-6a197ea908a88191816369ed81f721b0-charitysense-donor-research-assistant","feedback_url":"https://data.charitysense.com/api/v2/agent-feedback","agent_identity_headers":["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"],"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."},"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."},"public_pages":{"charity_profile_url_template":"https://data.charitysense.com/charity/{ein}","purpose":"Use public charity pages for crawlable mission, programs, sector, places of operation, official sources, and enhanced JSON-LD. The OpenAPI tools remain the structured Form 990 data surface."},"capability_tags":["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"],"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."]},{"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."]},{"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."]},{"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."]},{"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."]},{"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?"]},{"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."]},{"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?"]},{"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."]}],"primary_tools":[{"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."}],"recommended_citation":{"format":"CharitySense public charity profile, https://data.charitysense.com/charity/{ein}","include_filing_year":true}}