# Zoo MCP

> Zoo MCP is an MCP server for design and media. Run KCL code, import CAD files and take model snapshots through Zoo's CAD engine. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, API, self-hosted
- **Repository:** https://github.com/kittycad/mcp
- **MCP Registry name:** io.github.KittyCAD/zoo-mcp
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media), [engineering simulation](https://ai-powered.com/categories/engineering-simulation)
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [design-os-3d-blender](https://ai-powered.com/mcp/design-os-3d-blender): design-os-3d-blender is an open-source MCP server for design and media.
- [AEC Pilot: MCP for Revit, AutoCAD, Civil 3D, Navisworks and more](https://ai-powered.com/mcp/aec-pilot-mcp-for-revit-autocad-civil-3d-navisworks-and-more): AEC Pilot: MCP for Revit, AutoCAD, Civil 3D, Navisworks and more is a paid MCP server for design and media.
- [Lambdacad MCP](https://ai-powered.com/mcp/lambdacad-mcp): Lambdacad MCP is an open-source MCP server for design and media.
- [MCP Flux Pro](https://ai-powered.com/mcp/mcp-flux-pro): MCP Flux Pro is an open-source MCP server for design and media.
- [Network Sketcher (Local MCP)](https://ai-powered.com/mcp/network-sketcher-local-mcp): Network Sketcher (Local MCP) is an open-source MCP server for design and media.
- [kernelCAD](https://ai-powered.com/mcp/kernelcad): kernelCAD is a paid MCP server for design and media.
- [OpenSCAD](https://ai-powered.com/mcp/openscad): OpenSCAD is an open-source MCP server for design and media.

---
Source: https://ai-powered.com/mcp/zoo-mcp
