API documentation

Homepage Link header

</.well-known/api-catalog>; rel="api-catalog"; type="application/linkset+json", </api/openapi.json>; rel="service-desc"; type="application/openapi+json", </api-docs>; rel="service-doc"; type="text/html", </api/status>; rel="status"; type="application/json"

Markdown negotiation

HTML pages also respond in markdown when the request sends Accept: text/markdown. Those responses return Content-Type: text/markdown, Vary: Accept, and an x-markdown-tokens estimate for agents.

Browser agent tools

On supported browsers, site pages also publish read-only WebMCP tools for search, services search, weather summary, urgent help contacts, language support routes, and newcomer first steps. The published server card lives at /.well-known/mcp/server-card.json, and published agent skills are available at /.well-known/agent-skills/index.json.

Collection response shape

{
  "status": "success",
  "count": 147,
  "data": {
    "services": [
      {
        "id": "sample-service",
        "collection": "services",
        "title": "Sample service"
      }
    ]
  }
}

Search response shape

{
  "status": "success",
  "query": "education",
  "totalResults": 3,
  "results": {
    "services": [
      {
        "slug": "sample-service",
        "title": "Education service",
        "collection": "services",
        "url": "/services/sample-service"
      }
    ],
    "events": [
      {
        "slug": "sample-event",
        "title": "Education workshop",
        "collection": "events",
        "url": "/events/sample-event"
      }
    ]
  },
  "cached": false
}

Export response shape

{
  "status": "success",
  "data": {
    "services": [
      {
        "id": "sample-service",
        "title": "Sample service"
      }
    ],
    "resources": [
      {
        "id": "sample-resource",
        "title": "Sample resource"
      }
    ],
    "metadata": {
      "exportDate": "2026-04-14T01:00:00.000Z",
      "totalCollections": 2,
      "collections": [
        "services",
        "resources"
      ]
    },
    "stats": {
      "totalItems": 2,
      "itemsPerCollection": {
        "services": 1,
        "resources": 1
      }
    }
  }
}