{
  "protocolVersion": "0.3.0",
  "name": "Ḥeshbon Data Agent",
  "version": "1.0.0",
  "description": "Answers questions about how Jewish life is paid for, from the published Ḥeshbon datasets: affordability figures for 269 US communities and an index of 48 published research pieces. Read-only, single-turn, no authentication.",
  "documentationUrl": "https://heshbon.org/api/",
  "iconUrl": "https://heshbon.org/apple-touch-icon.png",
  "provider": {
    "organization": "Ḥeshbon · Center on Data and Jewish Life",
    "url": "https://heshbon.org/about.html"
  },
  "supportedInterfaces": [
    {
      "url": "https://heshbon.org/a2a",
      "transport": "JSONRPC"
    }
  ],
  "url": "https://heshbon.org/a2a",
  "preferredTransport": "JSONRPC",
  "additionalInterfaces": [
    {
      "url": "https://heshbon.org/a2a",
      "transport": "JSONRPC"
    }
  ],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json",
    "text/plain"
  ],
  "securitySchemes": {},
  "security": [],
  "skills": [
    {
      "id": "community-lookup",
      "name": "Look up a community",
      "description": "Return the published affordability figures for one community: home price, modelled all-in cost inputs, tax rates, safety percentile and counts of day schools, shuls and mikvaot.",
      "tags": [
        "communities",
        "cost-of-living",
        "lookup"
      ],
      "examples": [
        "What does a starter home cost in Teaneck?",
        "{\"skill\":\"community-lookup\",\"args\":{\"community\":\"Lakewood\",\"state\":\"NJ\"}}"
      ],
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    },
    {
      "id": "community-compare",
      "name": "Compare communities",
      "description": "Rank or compare communities on a published field such as home price, safety percentile, property tax rate or modelled tuition per child.",
      "tags": [
        "communities",
        "ranking",
        "comparison"
      ],
      "examples": [
        "Which communities have the cheapest homes?",
        "{\"skill\":\"community-compare\",\"args\":{\"field\":\"safety\",\"order\":\"desc\",\"limit\":10}}"
      ],
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    },
    {
      "id": "story-search",
      "name": "Search published research",
      "description": "Find published Ḥeshbon stories and essays by keyword, season or topic, returning title, summary and URL.",
      "tags": [
        "research",
        "search",
        "publications"
      ],
      "examples": [
        "What has Heshbon published about kollels?",
        "{\"skill\":\"story-search\",\"args\":{\"topic\":\"aliyah\",\"limit\":5}}"
      ],
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    },
    {
      "id": "dataset-describe",
      "name": "Describe the datasets",
      "description": "Explain what the published datasets contain: record counts, field names, scoring factors and which fields each comparison metric reads.",
      "tags": [
        "metadata",
        "schema",
        "datasets"
      ],
      "examples": [
        "What fields are in the community dataset?",
        "{\"skill\":\"dataset-describe\",\"args\":{}}"
      ],
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    }
  ]
}