Summary
Zoo is KittyCAD's API for programmatic CAD operations, and this server brings it into Claude through MCP. The main capability here is executing KCL (KittyCAD Language) code directly from your conversations, turning natural language descriptions into 3D geometry operations. You'll need a Zoo API token to use it. The tooling is solid: it integrates with Claude Desktop and Claude Code, can be tested with MCP Inspector, and supports codex-cli workflows. Individual tools like zoo_execute_kcl can be imported into your own Python projects if you want to build custom MCP servers that include CAD functionality. Reach for this when you're working on CAD automation and want Claude to generate or manipulate geometry on the fly.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Zoo Model Context Protocol (MCP) Server
An MCP server housing various Zoo built utilities
Prerequisites
- An API key for Zoo, get one here
- An environment variable
ZOO_API_TOKENset to your API keyexport ZOO_API_TOKEN="your_api_key_here"
Installation
-
uv venv -
Install the package from GitHub
uv pip install git+ssh://git@github.com/KittyCAD/mcp.git
Running the Server
The server can be started by using uvx
uvx zoo-mcp
The server can be started locally by using uv and the zoo_mcp module
uv run -m zoo_mcp
The server can also be run with the mcp package
uv run mcp run src/zoo_mcp/server.py
Prebuilt binaries
Each GitHub release also attaches standalone executables (built with PyInstaller) for Linux (x86_64, arm64), macOS (arm64, x86_64), and Windows (x86_64) — no Python toolchain required. Download the binary for your platform, set ZOO_API_TOKEN, and run it directly, e.g.:
ZOO_API_TOKEN="your_api_key_here" ./zoo-mcp-linux-x86_64
The binaries are not code-signed, so macOS Gatekeeper and Windows SmartScreen may warn on first run.
Integrations
The server can be used as is by running the server or importing directly into your python code.
from zoo_mcp.server import mcp
mcp.run()
Individual tools can be used in your own python code as well
from mcp.server.fastmcp import FastMCP
from zoo_mcp.zoo_tools import zoo_execute_kcl
mcp = FastMCP(name="My Example Server")
@mcp.tool()
async def my_execute_kcl(kcl_code: str) -> tuple[bool, str]:
"""
Example tool that uses the zoo_execute_kcl function from zoo_mcp.zoo_tools
"""
return await zoo_execute_kcl(kcl_code=kcl_code)
The server can be integrated with Claude desktop using the following command
uv run mcp install src/zoo_mcp/server.py
The server can also be integrated with Claude Code using the following command
claude mcp add --scope project "Zoo-MCP" uv -- --directory "$PWD"/src/zoo_mcp run server.py
The server can also be tested using the MCP Inspector
uv run mcp dev src/zoo_mcp/server.py
For running with codex-cli
codex \
-c 'mcp_servers.zoo.command="uvx"' \
-c 'mcp_servers.zoo.args=["zoo-mcp"]' \
-c mcp_servers.zoo.env.ZOO_API_TOKEN="$ZOO_API_TOKEN"
You can also use the helper script included in this repo:
./codex-zoo.sh
The script prompts for a request, runs Codex with the Zoo MCP server, and saves a JSONL transcript (including token usage) to codex-run-<timestamp>.jsonl.
Contributing
Contributions are welcome! Please open an issue or submit a pull request on the GitHub repository
PRs will need to pass tests and linting before being merged.
ruff is used for linting and formatting.
uvx ruff check
uvx ruff format
ty is used for type checking.
uvx ty check
Testing
The server includes tests located in tests. To run the tests, use the following command:
uv run pytest -n auto
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
ZOO_TOKEN*secretYour Zoo API key to access the Zoo services. Get one from https://zoo.dev/account/developer