MCP server

Connect an AI agent — Claude, ChatGPT, or any MCP-compatible client — directly to your boards over the Model Context Protocol.

Endpoint

https://app.getzolt.ai/api/mcp

Transport is MCP Streamable HTTP (JSON responses, no server-sent events) — GET, POST, and DELETEare all supported on the same URL. The server is stateless: no session is kept between calls, so there's nothing to reconnect if a client drops.

Authentication

Same as every other endpoint on this site — an X-API-Key header. Most MCP clients let you configure custom headers per server; add it there. A board-scoped key restricts every tool call to that one board automatically.

{
  "mcpServers": {
    "content-integrator": {
      "url": "https://app.getzolt.ai/api/mcp",
      "headers": { "X-API-Key": "ci_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" }
    }
  }
}

Tools

Five tools are registered under the server name content-integrator. Each wraps the same underlying operations as the Board API — a tool's result text is a JSON-stringified version of exactly what the equivalent REST endpoint returns.

Tool	Description	Input
list_boards	List the boards this API key can access.	(none)
list_zones	List the zones on a board.	{ board_id: string }
create_zone	Create a new zone on a board.	{ board_id: string, name: string }
list_tiles	List the tiles on a board, optionally scoped to one zone.	{ board_id: string, zone_id?: string }
create_tile	Create a new text tile on a board, optionally inside one zone.	{ board_id: string, zone_id?: string, title?: string, content: string }

A tool call against a board your key can't access returns an MCP error result (not an HTTP error) with message "This API key is not authorized for this board." or "Board not found."

Errors

Field	Type	Required	Description
401	HTTP	optional	Missing or invalid X-API-Key — returned before the MCP transport is even constructed.
429	HTTP	optional	Rate limit exceeded (30 requests/60s per key, same as every other endpoint).
isError: true	MCP result	optional	A specific tool call failed (bad board id, unauthorized board) — surfaced as tool output, not an HTTP error.