{"schema_version":"1.0","protocolVersion":"0.3.0","name":"CharitySense","legal_name":"CharitySense","description":"Agent-ready IRS Form 990 nonprofit dataset and no-auth API for US charity search, donor research, nonprofit comparison, financial metrics, governance review, and citation-ready analysis.","url":"https://data.charitysense.com","version":"1.1.0","provider":{"organization":"CharitySense","url":"https://charitysense.com"},"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","schemas":["https://data.charitysense.com/schemas/charitysense-990-current.schema.json","https://data.charitysense.com/schemas/api-charity-response.schema.json"],"custom_gpt_url":"https://chatgpt.com/g/g-6a197ea908a88191816369ed81f721b0-charitysense-donor-research-assistant","feedback_url":"https://data.charitysense.com/api/v1/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","auth":"none","base_url":"https://data.charitysense.com","spec_url":"https://data.charitysense.com/openapi.yaml"},"coverage":{"jurisdiction":"United States","entity_scope":"U.S.-registered nonprofits and charities","source_data":"IRS Form 990 filings","approximate_organizations":752000,"approximate_filings":5000000,"data_lag":"IRS Form 990 data is historical and can lag current operations."},"citation":{"preferred":"CharitySense, IRS Form 990 data, https://data.charitysense.com/charity/{ein}","include_filing_year":true,"caveat":"Figures are based on IRS Form 990 filings and may lag current operations."},"capability_tags":["nonprofit_search","irs_990_analysis","charity_comparison","donor_research","financial_metrics","governance_review","zakat_and_religious_giving_research","beneficiary_geography_search"],"skills":[{"id":"search_charities","name":"Search U.S. nonprofits","description":"Search CharitySense IRS Form 990 data by charity name, EIN, mission, cause, donor intent, geography, revenue, rating, state, category, or donation type.","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":"summarize_charity","name":"Summarize a charity by EIN","description":"Return a concise charity profile with identity, mission, financials, governance signals, category, and canonical URL.","tags":["ein_lookup","summary","nonprofit_profile"],"examples":["Summarize EIN 131644147."]},{"id":"analyze_charity_document","name":"Analyze normalized Form 990 data","description":"Retrieve detailed normalized IRS Form 990 records for financial analysis, governance review, ratings, and comparison.","tags":["form_990","financial_analysis","governance"],"examples":["Compare Feeding America and City Harvest before I donate."]},{"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 a clearer zakat policy field."]}],"primary_tools":[{"name":"searchCharities","method":"GET","path":"/api/v1/charity-search","description":"Use first for charity names, EINs, donor intent, geography, causes, and ranking."},{"name":"getCharitySummary","method":"GET","path":"/api/v1/charity-summary/{ein}","description":"Get a concise single-charity summary card."},{"name":"getCharityDocument","method":"GET","path":"/api/v1/charity-document/{ein}","description":"Get the full normalized IRS 990 document and history."},{"name":"getCharityMetrics","method":"GET","path":"/api/v1/charity-metrics/{ein}","description":"Get multi-year financial and impact metric series."},{"name":"sendAgentFeedback","method":"POST","path":"/api/v1/agent-feedback","description":"Optional: send agent identity, purpose, task, result quality, and desired-data feedback to improve CharitySense."}],"recommended_citation":{"format":"CharitySense, IRS Form 990 data, https://data.charitysense.com/charity/{ein}","include_filing_year":true}}