Dzaleka Online Services API

Homepage Link header

</llms.txt>; rel="describedby"; type="text/plain", </.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.

MCP server

/.well-known/mcp is a live Model Context Protocol server over Streamable HTTP, protocol version 2025-06-18. Send a GET for a discovery document, or POST JSON-RPC 2.0 to run its read-only tools: search_dzaleka, list_dzaleka_collection, search_dzaleka_encyclopedia, get_dzaleka_encyclopedia_entry. It is unauthenticated and shares the same rate limit as the REST API.

curl -X POST https://services.dzaleka.com/.well-known/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0"}}}'

Full walkthrough in the agent access guide.

Command-line client

The DZDK CLI wraps this API for terminal and script use. Install it with pip install dzdk (Python 3.8+), then run dzdk health to check every endpoint, or dzdk search --query "legal aid" to search. See the DZDK CLI guide for the full command list.

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
      }
    }
  }
}