Skip to content
MCP server

Zoo MCP

Run KCL code, import CAD files and take model snapshots through Zoo's CAD engine

Runs locally
Install
Platforms
CLI, API, self-hosted
Runs
Locally
Version
0.35.0
Listing updated
4 days ago

Similar MCP servers

About Zoo MCP

Zoo MCP is an MCP server for design and media. It runs locally on your machine and is started by your AI client.

Modelling happens in explicit persistent sessions, with at most one open per server process. An agent calls start_modeling_session (or get_modeling_sessions to recover an ID after reconnect), fills it with execute_kcl or import_cad_file, takes snapshots, and calls stop_modeling_session when done. Sessions survive client reconnects while the server and engine connection stay alive.

It installs from PyPI as zoo-mcp and runs over stdio by default, with an optional Streamable HTTP mode on 127.0.0.1:8000. Authentication is a one-time device login (zoo-mcp auth login) saved to the system keyring, or an API key in ZOO_API_TOKEN; public tools also work without login. Standalone PyInstaller binaries for Linux, macOS and Windows are attached to GitHub releases.

Python applications can also import individual tools or supply client configuration directly, which Zoo says it uses to embed the server in each agent's own runtime.

Install

Run in a terminal

claude mcp add zoo-mcp --env ZOO_TOKEN='<ZOO_TOKEN>' -- uvx zoo_mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "zoo-mcp": {
      "command": "uvx",
      "args": [
        "zoo_mcp"
      ],
      "env": {
        "ZOO_TOKEN": "<ZOO_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "zoo-mcp": {
      "command": "uvx",
      "args": [
        "zoo_mcp"
      ],
      "env": {
        "ZOO_TOKEN": "<ZOO_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "zoo-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "zoo_mcp"
      ],
      "env": {
        "ZOO_TOKEN": "<ZOO_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "zoo-mcp": {
      "command": "uvx",
      "args": [
        "zoo_mcp"
      ],
      "env": {
        "ZOO_TOKEN": "<ZOO_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "zoo-mcp": {
      "command": "uvx",
      "args": [
        "zoo_mcp"
      ],
      "env": {
        "ZOO_TOKEN": "<ZOO_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • ZOO_TOKENOptional Zoo API key. If unset, run zoo-mcp auth login before starting the server to save a login in your system credential store. Get an API key from https://zoo.dev/account/developer

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

start_modeling_session
Starts a persistent modelling session.
get_modeling_sessions
Recovers the current session ID.
execute_kcl
Runs KCL code in a session.
import_cad_file
Imports a CAD file into a session.
snapshot
Takes a snapshot of the session's model.
stop_modeling_session
Ends the session.
list_org_datasets
Lists the organisation's datasets.

What it does

Persistent modelling sessions
One reusable session per server, recoverable after reconnect.
KCL execution
Runs KCL code in the modelling engine.
CAD import
Loads CAD files into a session.
Snapshots
Renders views of the current model.
Device login
Saves credentials in the system keyring.
Standalone binaries
Prebuilt executables for Linux, macOS and Windows.

Good for

  • Have an agent generate and iterate on parametric CAD from a prompt
  • Import a CAD file and view a snapshot
  • List an organisation's datasets
  • Embed CAD tools in a Python agent runtime

Pricing

Pricing unknown

Requires a Zoo account or API key

Zoo MCP FAQ

How do I authenticate?

Run uvx zoo-mcp auth login, or set an API key in ZOO_API_TOKEN.

Does it need an account?

A Zoo account is a prerequisite, though public tools work without login.

Can it run over HTTP?

Yes, with --transport streamable-http, default host 127.0.0.1 and port 8000.

How many modelling sessions can be open?

At most one per server process.

How do I add Zoo MCP to Claude Code?

Run this command in your terminal: claude mcp add zoo-mcp --env ZOO_TOKEN='<ZOO_TOKEN>' -- uvx zoo_mcp

What are the best alternatives to Zoo MCP?

The closest alternatives to Zoo MCP are mcp-for-blender, design-os-3d-blender, AEC Pilot: MCP for Revit, AutoCAD, Civil 3D, Navisworks and more, Lambdacad MCP and MCP Flux Pro.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers