Agent Setup

ZCode

Quick answer
Prism registers a custom provider in ~/.zcode/v2/config.jsonusing ZCode's anthropic kind. That choice lets ZCode use Anthropic server tools — web search and web fetch — which Prism answers locally for free.

Last updated Reviewed against Prism v0.3.26

Why the Anthropic kind

A provider declared as openai-compatible only gets OpenAI-style tools. Declaring it anthropic instead gives ZCode access to Anthropic server-side tools, and Prism emulates those locally — so ZCode gets working web search and web fetch without any API key.

The base URL is the proxy root
ZCode appends /v1/messages itself for an Anthropic-kind provider, so Prism writes the bare http://127.0.0.1:11434 with no path.

One-click setup

1

Open the Agents tab

In the Admin UI, select Agents. ZCode is detected via ~/.zcode/v2/config.json.
2

Click Setup

Prism adds its provider block under a fixed UUID key and keeps a one-time config.json.prism-backup. All your other providers and settings are preserved.
3

Select a Prism model

Choose the Prism provider in ZCode's model picker and pick any model from your catalog.

What Prism writes

{
  "provider": {
    "90063b74-3eb7-4871-963d-86ce200d4d97": {
      "name": "Prism",
      "kind": "anthropic",
      "options": {
        "baseURL": "http://127.0.0.1:11434",
        "apiKey": "prism",
        "apiKeyRequired": true
      },
      "source": "custom",
      "models": {
        "glm-5.1:cloud": {
          "name": "glm-5.1:cloud",
          "displayName": "GLM 5.1 (Ollama Cloud)",
          "limit": { "context": 128000, "output": 16384 },
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          },
          "reasoning": {
            "enabled": true,
            "variants": ["low", "medium", "high"],
            "defaultVariant": "high"
          }
        }
      }
    }
  }
}

Per-model metadata

FieldWhat Prism puts there
nameThe model's route key, used in requests — matching ZCode's own lowercased-slug convention.
displayNameThe readable name from your Prism catalog.
limit.context / limit.outputYour configured context length and max output, defaulting to 128000 and 16384.
modalities.inputtext, plus image when the model reports vision support, so ZCode offers attachments.
modalities.outputAlways text.
reasoningWritten only for reasoning models: the model's own effort variants, defaulting to high.

The fixed provider UUID

Prism uses a constant UUID as the provider key, mirroring the format ZCode itself assigns to custom providers. Because the key never changes, re-syncing updates the same block instead of accumulating duplicates, and disabling the integration deletes exactly that key.

Add MCP servers

ZCode's MCP servers live in a different file from its providers: ~/.zcode/cli/config.json, under mcp.servers. Prism writes an HTTP entry there with no enable field at all, since absent means enabled in ZCode. See MCP Gateway.