If you can do it in the app,
you can do it with curl.

Read

# List boards in a workspace
GET /v1/workspaces/acme-eng/boards
Authorization: Bearer $ZB_TOKEN

# Get a card with full history
GET /v1/cards/card_8f2a?expand=history,comments

# Search across the workspace
GET /v1/search?q="5xx errors"&workspace=acme-eng

Write

# Create a card (idempotent)
POST /v1/cards
Idempotency-Key: req_a8f...
{
  "board": "board_42",
  "title": "User reports billing 5xx",
  "column": "triage",
  "labels": ["bug", "p1"]
}

# Move + comment in one call
PATCH /v1/cards/card_8f2a
{ "column": "shipped", "comment": "v3.2.1" }

02 · Webhooks

Push, not just pull.

Subscribe once, get every change as a signed POST. Retries, dead-letter queue, and replay all built in. We send the events you'd expect — and let you wildcard them.

# Webhook payload (signed via HMAC-SHA256 in header)
{
  "event": "card.moved",
  "id": "evt_b91c...",
  "workspace": "acme-eng",
  "timestamp": "2026-04-30T14:22:18Z",
  "actor": { "type": "agent",
              "id": "agent_claude-code" },
  "data": {
    "card_id": "card_8f2a",
    "from_column": "in_progress",
    "to_column": "shipped",
    "comment": "Deployed in v3.2.1"
  }
}

# Verify with one HMAC check — example header:
# X-Zergboard-Signature: t=1714400538,v1=8d2...

TypeScript

import { Zergboard } from "@zergboard/sdk";

const zb = new Zergboard({
  token: process.env.ZB_TOKEN,
});

await zb.cards.create({
  board: "board_42",
  title: "Fix billing 5xx",
});

Python

from zergboard import Zergboard

zb = Zergboard(token=os.environ["ZB_TOKEN"])

zb.cards.create(
    board="board_42",
    title="Fix billing 5xx",
)

Go

zb := zergboard.New(os.Getenv("ZB_TOKEN"))

card, err := zb.Cards.Create(ctx, &zergboard.CardCreate{
  Board: "board_42",
  Title: "Fix billing 5xx",
})

04 · Agents

An MCP server. So your agents already know how to use it.

Zergboard ships an official Model Context Protocol server. Plug it into Claude Code, Cursor, or any MCP-compatible runtime — your agent can list boards, create cards, move them, and post comments using standard MCP tool calls. No glue code.

# Add Zergboard to Claude Code in one line
claude mcp add zergboard -- npx @zergboard/mcp

# Or in your config:
{
  "mcpServers": {
    "zergboard": {
      "command": "npx",
      "args": ["@zergboard/mcp"],
      "env": { "ZB_TOKEN": "$ZB_TOKEN" }
    }
  }
}

# Agent now has these tools:
  - zergboard_list_boards
  - zergboard_create_card
  - zergboard_move_card
  - zergboard_comment
  - zergboard_search