CharitySense

{
  "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",
    "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",
  "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
  }
}