MCP

The MCP server exposes the same tool registry as the in-app assistant (Kallax, Malm, Skadis, Strala, Vesken, Lenast). DNS (Rannilen) tools are not included.

Auth: personal access token (kfx_…) or platform JWT. Create a PAT in Settings → Developers → API keys.

Hosted (recommended)

No local process. Cursor talks to the platform API:

{
  "mcpServers": {
    "kataflax": {
      "url": "https://api.tefily.com/mcp",
      "headers": {
        "Authorization": "Bearer kfx_…"
      }
    }
  }
}

Use Authorization: Bearer, not a custom API_KEY header.

Optional default project: set KATAFLAX_PROJECT_ID only on stdio / local HTTP processes. For hosted MCP, pass projectId in tool arguments or rely on tools that list projects first.

Local HTTP sidecar

KATAFLAX_API_URL=https://api.tefily.com \
KATAFLAX_TOKEN=kfx_… \
dart run packages/kataflax_mcp/bin/kataflax_mcp.dart --transport=http --port=3000

{
  "mcpServers": {
    "kataflax": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer kfx_…"
      }
    }
  }
}

Stdio

From the Kataflax repository root (so the package path resolves):

{
  "mcpServers": {
    "kataflax": {
      "command": "dart",
      "args": ["run", "packages/kataflax_mcp/bin/kataflax_mcp.dart"],
      "env": {
        "KATAFLAX_API_URL": "https://api.tefily.com",
        "KATAFLAX_TOKEN": "kfx_…"
      }
    }
  }
}

Variable	Description
KATAFLAX_API_URL	Backend URL (default http://localhost:8080)
KATAFLAX_TOKEN	PAT or platform JWT. Required for HTTP.
KATAFLAX_EMAIL / KATAFLAX_PASSWORD	Auto-login alternative (stdio)
KATAFLAX_PROJECT_ID	Optional default project
KATAFLAX_MCP_TRANSPORT	stdio (default) or http
KATAFLAX_MCP_PORT	HTTP port (default 3000)

See MCP tools for the catalog and prompts.