Zoo MCP
Run KCL code, import CAD files and take model snapshots through Zoo's CAD engine
- 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_mcpAdd 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.
