{"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.2.0","documentationUrl":"https://data.charitysense.com/agents","api":{"type":"openapi","auth":"none","base_url":"https://data.charitysense.com","spec_url":"https://data.charitysense.com/openapi.yaml"},"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}"},"schemas":["https://data.charitysense.com/schemas/charitysense-990-current.schema.json","https://data.charitysense.com/schemas/api-charity-response.schema.json"],"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":790000,"approximate_filings":5800000,"data_lag":"IRS Form 990 data is historical and can lag current operations."},"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 for charity names, EINs, donor intent, geography, causes, and ranking."},{"name":"getCharityProfile","method":"GET","path":"/api/v2/charity/{ein}/profile","description":"Get identity, mission, filing years, latest scale, officers, and overall trust spectrum."},{"name":"getCharitySummary","method":"GET","path":"/api/v2/charity/{ein}/summary","description":"Get donor decision summary facts and multi-year financial series."},{"name":"getCharityMetrics","method":"GET","path":"/api/v2/charity/{ein}/metrics","description":"Get multi-year financial and impact metric series."},{"name":"getCharityFlows","method":"GET","path":"/api/v2/charity/{ein}/flows","description":"Get money-flow graph, grants, noncash gifts, fundraising, and itemization controls."},{"name":"getCharityContradictions","method":"GET","path":"/api/v2/charity/{ein}/contradictions","description":"Get deterministic filing consistency checks and review flags."},{"name":"getCharityLeadership","method":"GET","path":"/api/v2/charity/{ein}/leadership","description":"Get officers, directors, key employees, compensation, and pay-setting controls."},{"name":"getCharityRelated","method":"GET","path":"/api/v2/charity/{ein}/related","description":"Get Schedule R related-organization graph and related transactions."},{"name":"getCharityRatings","method":"GET","path":"/api/v2/charity/{ein}/ratings","description":"Get rating metrics, category rollups, peer percentiles, and overall trust score."},{"name":"getCharityBlocks","method":"GET","path":"/api/v2/charity/{ein}/blocks","description":"Get the manifest of available raw filing blocks by year."},{"name":"getCharityBlock","method":"GET","path":"/api/v2/charity/{ein}/block/{block}","description":"Get one raw filing block across filing years."},{"name":"getCoreFiling","method":"GET","path":"/charities/{ein}","description":"Get a core IRS 990 filing record, optionally for a specific tax year."},{"name":"getDatasetStats","method":"GET","path":"/api/v2/stats","description":"Get dataset-wide counts and aggregate sector totals."},{"name":"getTopLists","method":"GET","path":"/api/v2/top-lists","description":"Get public top lists for common charity discovery workflows."},{"name":"sendAgentFeedback","method":"POST","path":"/api/v2/agent-feedback","description":"Optional: 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":true,"auth":{"type":"none"},"notice":"CharitySense currently exposes a no-auth read-only OpenAPI/HTTP surface, not an A2A JSON-RPC task endpoint. Use openapi.yaml for callable operations.","capabilities":{"streaming":false,"pushNotifications":false,"stateTransitionHistory":false,"extendedAgentCard":false,"supportsAuthenticatedExtendedCard":false,"extensions":[{"uri":"https://spec.openapis.org/oas/v3.1.0","description":"Read-only CharitySense 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 small first-paint charity profile: identity, mission, website, location, filing years, governance counts, officers, latest revenue/assets, and overall trust spectrum.","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":"summarize_charity","name":"Summarize donor decision facts by EIN","description":"Return donor-facing summary facts: functional expense split, headline efficiency figures, multi-year financial series, program descriptions, assets, liabilities, and public-support test data.","tags":["summary","donor_research","financials","programs"],"examples":["Summarize the donor decision facts for EIN 131644147."],"inputModes":["text/plain","application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[]},{"id":"analyze_financial_metrics","name":"Analyze financial metrics and trends","description":"Retrieve multi-year revenue, expense, asset, liability, ratio, reserve, and trend series for a charity.","tags":["metrics","financial_analysis","trends","charts"],"examples":["Show multi-year revenue and asset trends for Feeding America."],"inputModes":["text/plain","application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[]},{"id":"get_charity_ratings","name":"Get CharitySense ratings","description":"Retrieve per-metric scores, direction-aware peer percentiles, weighted category rollups, and the overall 0-100 CharitySense trust score.","tags":["ratings","peer_percentiles","trust_score"],"examples":["Get the ratings breakdown 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":"Retrieve the filing-year money-flow graph and schedule drill-ins for foreign grants, domestic grantees, noncash gifts, professional fundraising, and grant-itemization controls.","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":"review_leadership_compensation","name":"Review leadership and compensation","description":"Retrieve officers, directors, trustees, key employees, compensation splits, hours, Schedule J detail, and pay-setting controls.","tags":["leadership","compensation","form_990_part_vii","schedule_j"],"examples":["Review executive compensation for EIN 530196605."],"inputModes":["text/plain","application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[]},{"id":"review_related_organizations","name":"Review related organizations","description":"Retrieve the Schedule R related-organization graph, control flags, related entities, and itemized transactions where filed.","tags":["related_organizations","schedule_r","transactions"],"examples":["Show related organizations for EIN 530196605."],"inputModes":["text/plain","application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[]},{"id":"check_filing_consistency","name":"Check filing consistency","description":"Retrieve deterministic cross-check findings between the base Form 990 and schedules, including mismatches, conflicts, and review items.","tags":["consistency_checks","review_flags","red_flags","evidence"],"examples":["Does EIN 530196605 have filing contradictions or review flags?"],"inputModes":["text/plain","application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[]},{"id":"fetch_filing_blocks","name":"Fetch available filing blocks","description":"Retrieve the manifest of available raw filing blocks, then fetch a specific block such as financials, governance, people, grants, foreign, related, fundraising, public-support, balance-detail, transactions, or noncash.","tags":["raw_blocks","schedules","evidence","form_990"],"examples":["Fetch the grants block for 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":"get_top_lists","name":"Get public top charity lists","description":"Retrieve curated public top lists for common donor research areas using the existing CharitySense v2 top-list endpoint.","tags":["top_lists","donor_research","discovery"],"examples":["Show the current top charity lists on CharitySense."],"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"}