CharitySense

{
  "display_name": "CharitySense",
  "description": "Agent-ready nonprofit due diligence surface over public U.S. nonprofit data, including charity search, Form 990 financials, governance checks, grant flows, related organizations, trust signals, and citation-ready evidence.",
  "manifest_url": "https://data.charitysense.com/.well-known/agent.json",
  "openapi_url": "https://data.charitysense.com/openapi.yaml",
  "version": "1.2.0",
  "category": "General",
  "target_audience": "General",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "skills": [
    {
      "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 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."
      ]
    },
    {
      "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."
      ]
    },
    {
      "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."
      ]
    },
    {
      "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."
      ]
    },
    {
      "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?"
      ]
    },
    {
      "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."
      ]
    },
    {
      "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."
      ]
    },
    {
      "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?"
      ]
    },
    {
      "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."
      ]
    },
    {
      "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": "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."
      ]
    },
    {
      "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."
      ]
    }
  ],
  "default_input_modes": [
    "text/plain",
    "application/json"
  ],
  "default_output_modes": [
    "application/json",
    "text/plain"
  ],
  "extra": {
    "schema_version": "1.0",
    "protocolVersion": "0.3.0",
    "legal_name": "CharitySense",
    "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": "[email protected]",
      "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",
    "homepage_url": "https://data.charitysense.com",
    "agent_url": "https://data.charitysense.com/agents",
    "developer_url": "https://data.charitysense.com/developers",
    "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/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",
      "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": "Public IRS Form 990 filings and derived CharitySense filing signals",
      "approximate_organizations": 790000,
      "approximate_filings": 5800000,
      "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"
    ],
    "primary_tools": [
      {
        "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."
      }
    ],
    "recommended_citation": {
      "format": "CharitySense, IRS Form 990 data, https://data.charitysense.com/charity/{ein}",
      "include_filing_year": true
    }
  },
  "found": true,
  "strategy": "manifest-a2a",
  "protocol_std": "a2a"
}