Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

io.github.KittyCAD/zoo-mcp

PYPI · ZOO_MCP

An MCP server that provides access to the Zoo API for various CAD operations and tools.

Available components

−2 this week 60 Trust /100

Last scanned (23 hours ago)

Scores higher than 53% of PyPI servers

Category Design and Media

Recent critical change

CVE-2026-112398 affects this package (24 Oct 2026). See the changelog before you install this server.

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security49
  • Malware scan not yet available for this package.Unverified
  • No known CVEs affecting this package version or its production dependencies.Pass
  • No install/post-install scripts declared.Pass
  • 9 of 70 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency45
Schema Quality & AI Usability62
  • AI-judged instruction clarity (good).Pass
  • Context-footprint check failed: tool/resource definitions use about 9680 tokens (~158/item across 61 items; 61 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management80
  • Stability check failed: the tool surface changed between 0.28.13 and 0.37.0: 6 tool removals, 0 breaking changes, 21 additions. See how to fix → Fail
Tool Coverage72
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 1% of tool parameters carry a description.Partial
  • Structured output schemas are declared (74% of tools); any adoption earns full credit.Pass
Tool Safety75
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • 0 of 5 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "execute_kcl" implies "execute" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
  • An AI judge read all 61 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a current MCP spec version (2026-07-28).Pass
What we tested

Checks we ran (15)

  • Known CVEs
  • Install scripts
  • Dependency health
  • Source repository
  • Provenance
  • License
  • Maintenance
  • Security disclosure
  • Schema quality
  • Stability
  • Tool coverage
  • Injection markers
  • Destructive annotations
  • Judged manipulation
  • MCP protocol

Checks we could not complete (1)

These are gaps on our side, not findings about this package. We only credit what we can confirm, so a category made up entirely of them scores 0.

  • Malware scan in Supply Chain SecurityMalware scan not yet available for this package.

Does not apply to this package (2)

  • Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
  • Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.

The score does not measure everything. What the score does not measure →

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 21 Nov 26 −1
    • Package version: 0.36.0 → 0.37.0 functional
  • 20 Nov 26 −16
    • Malware scan: pass → unverified ▼ security
    • Tool coverage: 92% → 78% ▼ functional
    • Package version: 0.35.0 → 0.36.0 functional
  • 19 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
  • 18 Nov 26 −15
    • Malware scan: pass → unverified ▼ security
    • Schema quality: 195 → 175 ▲ functional
    • Schema quality: excellent → good functional
    • Package version: 0.34.4 → 0.35.0 functional
  • 17 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
  • 16 Nov 26 −15
    • Malware scan: pass → unverified ▼ security
  • 15 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
  • 13 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 84 to 87.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 21 Nov 2026 · Analysed pypi/zoo_mcp@0.37.0

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem pypi
Reason No attestation published

Background: How many MCP packages publish verified provenance →

Dependencies 70 packages
Packages resolved 70
Stale 5
No linked repository 4
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 61 exposed · ~9,680 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
calculate_bounding_box_cad ~129

Calculate the bounding box of a CAD file. Args: input_file (str): The path of the CAD file. The file should be one of the supported formats: .fbx, .gltf, .obj, .ply, .sldprt, .step, .stp, .stl (case-insensitive) Returns: dict | str: A dictionary with 'center' (dict with x,y,z) and 'dimensions' (dict with x,y,z), or an error message if the operation fails.

NameTypeReqDescription
input_filestringyes–
NameTypeReqDescription
result–yes–

No examples provided.

calculate_cad_physical_properties ~387

Calculate physical properties (volume, mass, surface area, center of mass, bounding box) of a CAD file. Args: input_file (str): The path of the file. The file should be one of the supported formats: .fbx, .gltf, .obj, .ply, .sldprt, .step, .stp, .stl (case-insensitive) unit_length (str): The unit of length for center of mass. One of 'cm', 'ft', 'in', 'm', 'mm', 'yd'. unit_mass (str): The unit of mass for the mass result. One of 'g', 'kg', 'lb'. unit_density (str): The unit of density for the material. One of 'lb:ft3', 'kg:m3'. density (float): The density of the material. unit_area (str): The unit of area for surface area. One of 'cm2', 'dm2', 'ft2', 'in2', 'km2', 'm2', 'mm2', 'yd2'. unit_volume (str): The unit of volume. One of 'cm3', 'ft3', 'in3', 'm3', 'mm3', 'yd3', 'usfloz', 'usgal', 'l', 'ml'. Returns: dict | str: A dictionary with keys 'volume', 'mass', 'surface_area', 'center_of_mass', and 'bounding_box', or an error message if the operation fails.

NameTypeReqDescription
densitynumberyes–
input_filestringyes–
unit_areastringyes–
unit_densitystringyes–
unit_lengthstringyes–
unit_massstringyes–
unit_volumestringyes–
NameTypeReqDescription
result–yes–

No examples provided.

calculate_center_of_mass ~170

Calculate the center of mass of a 3d object represented by the input file. Args: input_file (str): The path of the file to get the mass from. The file should be one of the supported formats: .fbx, .gltf, .obj, .ply, .sldprt, .step, .stp, .stl (case-insensitive) unit_length (str): The unit of length to return the result in. One of 'cm', 'ft', 'in', 'm', 'mm', 'yd' Returns: str: The center of mass of the file in the specified unit of length, or an error message if the operation fails.

NameTypeReqDescription
input_filestringyes–
unit_lengthstringyes–
NameTypeReqDescription
result–yes–

No examples provided.

calculate_mass ~209

Calculate the mass of a 3d object represented by the input file. Args: input_file (str): The path of the file to get the mass from. The file should be one of the supported formats: .fbx, .gltf, .obj, .ply, .sldprt, .step, .stp, .stl (case-insensitive) unit_mass (str): The unit of mass to return the result in. One of 'g', 'kg', 'lb'. unit_density (str): The unit of density to calculate the mass. One of 'lb:ft3', 'kg:m3'. density (float): The density of the material. Returns: str: The mass of the file in the specified unit of mass, or an error message if the operation fails.

NameTypeReqDescription
densitynumberyes–
input_filestringyes–
unit_densitystringyes–
unit_massstringyes–
NameTypeReqDescription
result–yes–

No examples provided.

calculate_surface_area ~182

Calculate the surface area of a 3d object represented by the input file. Args: input_file (str): The path of the file to get the surface area from. The file should be one of the supported formats: .fbx, .gltf, .obj, .ply, .sldprt, .step, .stp, .stl (case-insensitive) unit_area (str): The unit of area to return the result in. One of 'cm2', 'dm2', 'ft2', 'in2', 'km2', 'm2', 'mm2', 'yd2'. Returns: str: The surface area of the file in the specified unit of area, or an error message if the operation fails.

NameTypeReqDescription
input_filestringyes–
unit_areastringyes–
NameTypeReqDescription
result–yes–

No examples provided.

calculate_volume ~185

Calculate the volume of a 3d object represented by the input file. Args: input_file (str): The path of the file to get the volume from. The file should be one of the supported formats: .fbx, .gltf, .obj, .ply, .sldprt, .step, .stp, .stl (case-insensitive) unit_volume (str): The unit of volume to return the result in. One of 'cm3', 'ft3', 'in3', 'm3', 'mm3', 'yd3', 'usfloz', 'usgal', 'l', 'ml'. Returns: str: The volume of the file in the specified unit of volume, or an error message if the operation fails.

NameTypeReqDescription
input_filestringyes–
unit_volumestringyes–
NameTypeReqDescription
result–yes–

No examples provided.

cancel_job_execution ~31

Request cancellation. Check the job's status to confirm how it ended.

NameTypeReqDescription
job_idstringyes–
NameTypeReqDescription
completed_at–––
compute_profile_idstringyes–
created_at–––
execution_ended_at–––
idstringyes–
runtime_idstringyes–
started_at–––
state_versioninteger––
statusstringyes–
timeout_secondsintegeryes–

No examples provided.

center_camera_on_selection ~225

Point the camera at the current "selection set". Useful for making a small selection legible, especially an edge: an edge is only a pixel or two wide, so centring it helps far more than any change of colour. Set the selection first with select_entities. Centring moves the camera without re-framing the scene, so parts of the model may fall outside the image. Follow with `snapshot` passing zoom=False, since zoom=True re-frames the whole scene and undoes the centring. Args: session_id: An open modeling session, from start_modeling_session. Required: camera position is scene state and would be discarded without one. move_vantage: Move the camera's vantage point as well as its target. True (the default) centres the selection most precisely; False re-aims the camera from where it already is. Returns: DefaultCameraCenterToSelection: Confirmation that the camera was centred.

NameTypeReqDescription
move_vantageboolean––
session_idstringyes–

Structured output declared, but exposes no named fields.

No examples provided.

convert_cad_file ~234

Convert a CAD file from one format to another CAD file format. Args: input_file (str): The input cad file to convert. The file should be one of the supported formats: .fbx, .gltf, .obj, .ply, .sldprt, .step, .stp, .stl (case-insensitive) export_path (str | None): The path to save the converted CAD file to. If the path is a directory, a temporary file will be created in the directory. If the path is a file, it will be overwritten if the extension is valid. export_format (str | None): The format of the exported CAD file. This should be one of 'fbx', 'glb', 'gltf', 'obj', 'ply', 'step', 'stl'. If no format is provided, the default is 'step'. Returns: str: The path to the converted CAD file, or an error message if the operation fails.

NameTypeReqDescription
export_format–yes–
export_path–yes–
input_filestringyes–
NameTypeReqDescription
resultstringyes–

No examples provided.

curve_get_end_points ~82

Get the start and end points of a curve entity. Args: curve_id: Curve UUID, typically obtained from an artifact graph. session_id: A modeling session populated by execute_kcl. Returns: CurveGetEndPoints: The curve's start and end points.

NameTypeReqDescription
curve_idstringyes–
session_idstringyes–
NameTypeReqDescription
end–yes–
start–yes–

No examples provided.

curve_get_type ~83

Get whether a curve is a line, arc, or NURBS curve. Args: curve_id: Curve UUID, typically obtained from an artifact graph. session_id: A modeling session populated by execute_kcl. Returns: CurveGetType: The curve's geometric type.

NameTypeReqDescription
curve_idstringyes–
session_idstringyes–
NameTypeReqDescription
curve_type–yes–

No examples provided.

edge_get_length ~83

Get the length of an edge entity in the current scene units. Args: edge_id: Edge UUID, typically obtained from an artifact graph. session_id: A modeling session populated by execute_kcl. Returns: EdgeGetLength: The edge length in the current scene units.

NameTypeReqDescription
edge_idstringyes–
session_idstringyes–
NameTypeReqDescription
lengthnumberyes–

No examples provided.

engine_util_evaluate_path ~261

Evaluate a serialized KCL path at parameter t. Examples of `path_json`: ```json { "start": { "from": [10, 0] }, "value": [ { "type": "Arc", "center": [0, 0], "radius": 10, "angle_range": [0, 90] } ] } ``` ```json { "start": { "from": [0, 0] }, "value": [ { "type": "ToPoint", "to": [10, 0] }, { "type": "ToPoint", "to": [10, 10] } ] } ``` Args: path_json: The serialized JSON representation of the KCL sketch or path. t: Normalized path parameter, conventionally between 0 and 1. session_id: A modeling session populated by execute_kcl. Returns: EngineUtilEvaluatePath: The position on the path at parameter t.

NameTypeReqDescription
path_jsonstringyes–
session_idstringyes–
tnumberyes–
NameTypeReqDescription
pos–yes–

No examples provided.

entity_distance ~126

Get the minimum and maximum distance between two model entities. Args: entity_id1: The first entity UUID, typically obtained from an artifact graph. entity_id2: The second entity UUID. session_id: A modeling session populated by execute_kcl. on_axis: Optional global axis for projected distance; omit for Euclidean distance. Returns: EntityGetDistance: The minimum and maximum distance between the entities.

NameTypeReqDescription
entity_id1stringyes–
entity_id2stringyes–
on_axis–––
session_idstringyes–
NameTypeReqDescription
max_distancenumberyes–
min_distancenumberyes–

No examples provided.

entity_get_all_child_uuids ~84

Get all child UUIDs belonging to an entity. Args: entity_id: Entity UUID, typically obtained from an artifact graph. session_id: A modeling session populated by execute_kcl. Returns: EntityGetAllChildUuids: All child entity UUIDs.

NameTypeReqDescription
entity_idstringyes–
session_idstringyes–
NameTypeReqDescription
entity_idsarrayyes–

No examples provided.

entity_get_index ~78

Get an entity's index within its parent. Args: entity_id: Entity UUID, typically obtained from an artifact graph. session_id: A modeling session populated by execute_kcl. Returns: EntityGetIndex: The entity's index within its parent.

NameTypeReqDescription
entity_idstringyes–
session_idstringyes–
NameTypeReqDescription
entity_indexintegeryes–

No examples provided.

entity_get_parent_id ~78

Get the UUID of an entity's parent. Args: entity_id: Entity UUID, typically obtained from an artifact graph. session_id: A modeling session populated by execute_kcl. Returns: EntityGetParentId: The parent entity's UUID.

NameTypeReqDescription
entity_idstringyes–
session_idstringyes–
NameTypeReqDescription
entity_idstringyes–

No examples provided.

entity_get_sketch_paths ~85

Get the sketch path UUIDs belonging to an entity. Args: entity_id: Entity UUID, typically obtained from an artifact graph. session_id: A modeling session populated by execute_kcl. Returns: EntityGetSketchPaths: The sketch path UUIDs belonging to the entity.

NameTypeReqDescription
entity_idstringyes–
session_idstringyes–
NameTypeReqDescription
entity_idsarrayyes–

No examples provided.

evaluate_kcl ~350

Execute KCL once and collect requested measurements, snapshots and exports. Prefer this when several checks or final export formats are known in advance. Provide exactly one source: self-contained kcl_code or a saved kcl_path project. Save editable source separately; inline code does not create a source file. Mock errors prevent hosted execution. The isolated session closes after the operation; no persistent session ID is needed or returned. snapshot_request: Optional views (1–4 named views or camera dicts with up, vantage, center). An empty object requests one isometric image. Named views use zoom-to-fit; custom views default to their explicit framing. physical_properties_request: Optional properties list (volume, mass, surface_area, center_of_mass, bounding_box) and units. Mass additionally requires density and unit_density. Only requested properties are measured. exports: Optional format/destination_dir pairs. Each format needs a separate, non-overlapping directory, created if missing. Returned bundle filenames are preserved; existing files are not overwritten. Request final formats together rather than executing separately for each export. Returns structured execution/inspection outcomes and per-export statuses and file paths, plus an inline image when requested and available. ok describes execution only: inspect output statuses for partial failures. Output failures never rerun geometry; successful outputs remain available.

NameTypeReqDescription
exports–––
kcl_code–––
kcl_path–––
physical_properties_request––Optional measurements and output units; omit to skip. Mass requires density and unit_density.
snapshot_request––Optional snapshots; omit to skip rendering, or pass {} for an isometric image.

No output schema declared.

No examples provided.

execute_kcl ~394

Execute KCL code given a string of KCL code or a path to a KCL project. Either kcl_code or kcl_path must be provided. If kcl_path is provided, it should point to a .kcl file or a directory containing a main.kcl file. Prefer evaluate_kcl when execution, measurements, snapshots, or exports are needed together; it collects them from one execution. Executing kcl_code does not save a .kcl source file. For model creation, save the source and required project files with the client's authorized file-editing tools, then validate the saved project using kcl_path and include the editable KCL files in the handoff. Session executions save the artifact graph to a temporary JSON file and return its path. Local executions do not produce an artifact graph and can have large network overhead depending on the model. Args: kcl_code (str | None): Self-contained KCL code to execute. Standard-library imports are allowed; filesystem imports require kcl_path. kcl_path (str | None): The path to a KCL file to execute. The path should point to a .kcl file or a directory containing a main.kcl file. Dependencies and symlink targets must remain inside the entrypoint's directory. session_id: An open modeling session in which to execute the KCL. Returns: ResultZooExecuteKcl: Separate mock_preflight and real_execution outcomes, each with status, message, and diagnostics. Mock errors return immediately with real_execution not_run; mock warnings remain visible and allow real execution. Known mock-engine limitations are warnings. Session successes include path_artifact_graph. Transient local failures may retry real execution without repeating preflight.

NameTypeReqDescription
kcl_code–––
kcl_path–––
session_id–––
NameTypeReqDescription
result–yes–

No examples provided.

format_kcl ~175

Format KCL code given a string of KCL code or a path to a KCL project. Either kcl_code or kcl_path must be provided. If kcl_path is provided, it should point to a .kcl file or a directory containing .kcl files. Args: kcl_code (str | None): The KCL code to format. kcl_path (str | None): The path to a KCL file to format. The path should point to a .kcl file or a directory containing a main.kcl file. Returns: str | None: Returns the formatted kcl code if the kcl_code is used otherwise returns None, the KCL in the kcl_path will be formatted in place

NameTypeReqDescription
kcl_code–––
kcl_path–––
NameTypeReqDescription
resultstringyes–

No examples provided.

get_face_info ~133

Get the position, gradient, normal, and center of a face in a modeling session. Args: face_id (str): Usually a user or LLM-selected face id. session_id: A modeling session populated by execute_kcl. Returns: FaceInfo: The face position, gradient, normal, and center. The position is the starting point of the face's outside perimeter in KittyCAD engine space. The center is the geometric center of the face and should generally be preferred over the position.

NameTypeReqDescription
face_idstringyes–
session_idstringyes–
NameTypeReqDescription
face_get_center–yes–
face_get_gradient–yes–
face_get_position–yes–

No examples provided.

get_job_execution ~66

Check a job's status, archived log previews, and outputs. Wait up to 20 seconds. Pass results.artifacts.next_page as artifact_page_token for more outputs.

NameTypeReqDescription
artifact_page_token–––
job_idstringyes–
wait_secondsinteger––
NameTypeReqDescription
error_code–––
job–yes–
job_idstringyes–
logs–––
msgstringyes–
okbooleanyes–
results–––

No examples provided.

get_kcl_doc ~161

Get the full content of a specific KCL documentation file. Prefer lookup_kcl_docs first; fetch a full page when more detail is needed. Use list_kcl_docs() to see available documentation paths, or lookup_kcl_docs() to find relevant documentation by symbol or topic. Args: doc_path (str): The path to the documentation file (e.g., "docs/kcl-lang/functions" or "docs/kcl-std/functions/std-sketch-extrude") Returns: str: The full Markdown content of the documentation file, or an error message if not found. Raises: ToolError: Documentation could not be fetched; the call can be retried.

NameTypeReqDescription
doc_pathstringyes–
NameTypeReqDescription
resultstringyes–

No examples provided.

get_kcl_sample ~247

Get the full content of a specific KCL sample including all files. Downloads a public Aquarium project and retrieves its KCL files with their project-relative paths, including files in subdirectories. Use list_kcl_samples() to see available sample names, or search_kcl_samples() to find samples by keyword. Args: sample_name (str): The public project ID returned by list_kcl_samples() or search_kcl_samples(). Returns: SampleData | str: A SampleData dictionary containing: - name: The public project ID - title: Human-readable title - description: Brief description - multipleFiles: Whether the sample contains multiple files. Reliable here (unlike in list_kcl_samples / search_kcl_samples), because this tool downloads the project and counts its KCL files. - files: List of SampleFile dictionaries, each with a project-relative 'filename' and its 'content' Returns an error message string if the sample is not found. Raises: ToolError: The sample could not be fetched; the call can be retried.

NameTypeReqDescription
sample_namestringyes–
NameTypeReqDescription
result–yes–

No examples provided.

get_modeling_sessions ~85

List modeling sessions owned by the current MCP server process. Use this to recover the active session ID after reconnecting to a server process. A restarted server has no sessions. The current implementation supports at most one session, but the list return type allows future support for multiple sessions. Returns: list[str]: Active modeling session IDs, currently empty or one item.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultarrayyes–

No examples provided.

get_sketch_constraint_status ~268

Execute KCL and return a report of sketch constraint status. Either kcl_code or kcl_path must be provided. If kcl_path is provided, it should point to a .kcl file or a directory containing a main.kcl file. Sketches are grouped by constraint status: fully_constrained, under_constrained, over_constrained, and errors. Each sketch entry includes the sketch name, status, free_count (under-constrained segments), conflict_count (over-constrained segments), and total_count (total segments analyzed). The report also includes kcl_executes_successfully (False when KCL parsing/execution failed before all sketches were analyzed) and kcl_error (None on success, otherwise a dict with phase ("parse" or "execution") and text fields describing the failure). A partial report may still contain sketch entries analyzed prior to the failure. Args: kcl_code (str | None): The KCL code to check constraints for. kcl_path (str | None): The path to a KCL file or directory containing a main.kcl file. Returns: dict | str: A report grouping sketches by constraint status, or an error message if the operation fails.

NameTypeReqDescription
kcl_code–––
kcl_path–––
NameTypeReqDescription
result–yes–

No examples provided.

highlight_set_entities ~291

Replace the currently highlighted entities. Does NOT modify the "selection set". This is a visual command: follow it with the `snapshot` tool, passing the same session_id and zoom=False, to see the highlight without moving the camera. It highlights edges, surfaces and bodies. Highlighting only brightens an entity slightly. select_entities is markedly more obvious, tinting the entity and drawing an outline around it. For the strongest emphasis on a face, call both; on an edge call only one, because selection overrides the highlight. An edge is a pixel or two wide whichever you choose, so also consider center_camera_on_selection or a larger max_image_dimension to make one legible. Highlights draw through the solid, so an entity facing away from the camera still renders, seen through the body. A highlighted entity in a snapshot is therefore not evidence that it faces the camera; choose a camera on the same side as the entity to see it properly. Args: entity_ids: Entity UUIDs to highlight; pass an empty list to clear highlights. session_id: An open modeling session, from start_modeling_session. Required: highlights are scene state and would be discarded without one. Returns: HighlightSetEntities: Confirmation that the highlights were replaced.

NameTypeReqDescription
entity_idsarrayyes–
session_idstringyes–

Structured output declared, but exposes no named fields.

No examples provided.

import_cad_file ~105

Import a CAD file into an existing modeling session. Args: session_id: The ID returned by start_modeling_session. input_file: Path to a .fbx, .gltf, .obj, .ply, .sldprt, .step, .stp, or .stl file. Returns: str: The modeling engine ID of the imported object.

NameTypeReqDescription
input_filestringyes–
session_idstringyes–
NameTypeReqDescription
resultstringyes–

No examples provided.

lint_and_fix_kcl ~213

Lint and fix KCL code given a string of KCL code or a path to a KCL project. Either kcl_code or kcl_path must be provided. If kcl_path is provided, it should point to a .kcl file or a directory containing .kcl files. Args: kcl_code (str | None): The KCL code to lint and fix. kcl_path (str | None): The path to a KCL file to lint and fix. The path should point to a .kcl file or a directory containing a main.kcl file. Returns: tuple[str, list[str]]: If kcl_code is provided, it returns a tuple containing the fixed KCL code and a list of unfixed lints. If kcl_path is provided, it returns a tuple containing a success message and a list of unfixed lints for each file in the project.

NameTypeReqDescription
kcl_code–––
kcl_path–––
NameTypeReqDescription
resultarrayyes–

No examples provided.

list_cloud_libraries ~68

List personal libraries and active-organization libraries, including all creation sources. Continue with next_page as page_token, even when a page has no items. Unassigned projects have no named library; use list_cloud_projects for them.

NameTypeReqDescription
limitinteger––
page_token–––

No output schema declared.

No examples provided.

list_cloud_projects ~83

Browse cloud projects and return cloud:<uuid> project_id values for filesystem tools. Use library_id alone or scope/unassigned without library_id. Keep filters unchanged while continuing with next_page as page_token.

NameTypeReqDescription
library_id–––
limitinteger––
page_token–––
scope–––
unassignedboolean––

No output schema declared.

No examples provided.

list_job_executions ~45

List this account's jobs across conversations, newest first. Use next_page to continue.

NameTypeReqDescription
page_token–––
runtime_id–––
status–––
NameTypeReqDescription
itemsarrayyes–
next_page–––

No examples provided.

list_kcl_docs ~153

List all available KCL documentation topics organized by category. Returns a dictionary with the following categories: - kcl-lang: KCL language documentation (syntax, types, functions, etc.) - kcl-std-functions: Standard library function documentation - kcl-std-types: Standard library type documentation - kcl-std-consts: Standard library constants documentation - kcl-std-modules: Standard library module documentation Each category contains a list of documentation file paths that can be retrieved using get_kcl_doc(). Returns: dict: Categories mapped to lists of available documentation paths. Raises: ToolError: Documentation could not be fetched; the call can be retried.

Input schema present but exposes no named parameters.

NameTypeReqDescription
result–yes–

No examples provided.

list_kcl_samples ~187

List all available KCL sample projects. Returns the public Aquarium projects from the Zoo API. Each sample demonstrates a CAD modeling technique or creates a particular 3D model. Returns: list[dict]: List of sample information, each containing: - name: The public project ID (use with get_kcl_sample) - title: Human-readable title - description: Brief description of what the sample creates - multipleFiles: Whether the sample contains multiple KCL files. Best-effort hint only. The public listing doesn't expose file counts, so this is ``False`` for any sample that has not yet been fetched via get_kcl_sample. Call get_kcl_sample if you need a reliable answer. Raises: ToolError: The sample index could not be fetched; the call can be retried.

Input schema present but exposes no named parameters.

NameTypeReqDescription
result–yes–

No examples provided.

list_org_datasets ~133

List the datasets available to the user's organization. Only datasets the organization has enabled for lookup are listed; datasets excluded from lookup (for example while their conversions are still being worked on) are omitted and should not be searched. Each dataset has a UUID `id`, a human-readable `name`, and an optional `description`. Use the `id` as the `dataset_id` argument to `search_org_dataset_semantic`. Returns: A list of {"id": str, "name": str, "description": str | None} entries, or an error message if the operation fails.

Input schema present but exposes no named parameters.

NameTypeReqDescription
result–yes–

No examples provided.

list_org_skills ~89

List the skills available to the user's organization. Each skill has a UUID `id`, a human-readable `name`, a `description`, and a `markdown` body containing the skill's full content. Returns: A list of {"id": str, "name": str, "description": str, "markdown": str} entries, or an error message if the operation fails.

Input schema present but exposes no named parameters.

NameTypeReqDescription
result–yes–

No examples provided.

lookup_kcl_docs ~121

Look up compact KCL reference sections. Prefer this for initial docs lookup. Matches symbols, titles, headings, and keywords. Returns source paths and nonempty sections with complete examples and table rows when they fit. max_chars is a shared budget for Markdown content across all results (metadata is additional). Tables may omit rows within this budget. Truncated results can be expanded with get_kcl_doc(path). Both limits must be positive.

NameTypeReqDescription
max_charsinteger––
max_resultsinteger––
querystringyes–

Structured output declared, but exposes no named fields.

No examples provided.

mock_execute_kcl ~171

Mock execute KCL code given a string of KCL code or a path to a KCL project. Either kcl_code or kcl_path must be provided. If kcl_path is provided, it should point to a .kcl file or a directory containing a main.kcl file. Args: kcl_code (str | None): The KCL code to mock execute. kcl_path (str | None): The path to a KCL file to mock execute. The path should point to a .kcl file or a directory containing a main.kcl file. Returns: tuple(bool, str): Returns True if the KCL code executed successfully and a success message, False otherwise and the error message.

NameTypeReqDescription
kcl_code–––
kcl_path–––
NameTypeReqDescription
resultarrayyes–

No examples provided.

project_access ~69

Get current project access capabilities for an existing path. Requires a cloud:<uuid> project ID and the caller's Zoo credentials. Default total uncompressed project limit: 256 MiB.

NameTypeReqDescription
max_project_bytesinteger––
pathstring––
project_idstringyes–

No output schema declared.

No examples provided.

project_cp ~98

Copy a file or directory within a cloud:<uuid> project in one upload. An existing destination directory receives the source basename. Existing files may be replaced, except main.kcl. Directory collisions are errors. Conflicts refresh and reapply. Default total project limit: 256 MiB.

NameTypeReqDescription
destinationstringyes–
max_project_bytesinteger––
project_idstringyes–
sourcestringyes–

No output schema declared.

No examples provided.

project_mkdir ~79

Create a cloud project directory using a zero-byte .empty file. The parent must exist and the target must not exist. The visible .empty marker may remain after files are added. Default project limit: 256 MiB.

NameTypeReqDescription
max_project_bytesinteger––
pathstringyes–
project_idstringyes–

No output schema declared.

No examples provided.

project_mv ~95

Move a file or directory within a cloud project in one replacement upload. Uses project_cp destination rules. Cannot move or overwrite main.kcl or move the root. Conflicts refresh and reapply against the latest contents. Default total uncompressed project limit: 256 MiB.

NameTypeReqDescription
destinationstringyes–
max_project_bytesinteger––
project_idstringyes–
sourcestringyes–

No output schema declared.

No examples provided.

project_read_file ~90

Read a cloud project file as UTF-8 text or base64-encoded binary data. Returns {contents: str, encoding: str}. Downloads only the requested file from the current immutable revision. Default total project limit: 256 MiB.

NameTypeReqDescription
encodingstring––
max_project_bytesinteger––
pathstringyes–
project_idstringyes–

No output schema declared.

No examples provided.

project_readdir ~69

List immediate cloud directory children as {files: [metadata, ...]}. Requires a cloud:<uuid> project ID. Default total uncompressed project limit: 256 MiB.

NameTypeReqDescription
max_project_bytesinteger––
pathstring––
project_idstringyes–

No output schema declared.

No examples provided.

project_rm ~84

Remove a cloud project file or directory recursively, without globbing. Cannot remove the project root or main.kcl. On conflicts this removes the latest contents beneath the path, including newly added files. Default total uncompressed project limit: 256 MiB.

NameTypeReqDescription
max_project_bytesinteger––
pathstringyes–
project_idstringyes–

No output schema declared.

No examples provided.

project_stat ~77

Get cloud project file metadata or an inferred directory's kind and path. Directory-specific IDs, timestamps, sizes, and hashes are null because the API stores files. Default total uncompressed project limit: 256 MiB.

NameTypeReqDescription
max_project_bytesinteger––
pathstring––
project_idstringyes–

No output schema declared.

No examples provided.

project_write_file ~165

Write a file in a cloud:<uuid> project; its parent must exist. Without encoding, bytes are written unchanged and strings use UTF-8. Explicit encoding applies to strings: utf-8 for text or base64 for binary data over JSON MCP transports. Replaces the file if present, including main.kcl. Conflicts refresh and reapply this write. max_project_bytes bounds total uncompressed project bytes (default 256 MiB). Returns acknowledged project metadata plus the normalized path, contents, and encoding. Text uses UTF-8; raw bytes and base64 inputs return base64.

NameTypeReqDescription
contents–yes–
encoding–––
max_project_bytesinteger––
pathstringyes–
project_idstringyes–

No output schema declared.

No examples provided.

read_job_execution_logs ~86

Read up to 64 KiB of archived stdout or stderr. Check available and continue at next_offset. data_base64 gives the original page bytes when text is lossy or a UTF-8 character crosses a page boundary.

NameTypeReqDescription
job_idstringyes–
limitinteger––
offsetinteger––
streamstring––
NameTypeReqDescription
availablebooleanyes–
completebooleanyes–
data_base64––Exact bytes of this page when its text alone cannot reproduce them.
failure_code–yes–
next_offsetintegeryes–
offsetintegeryes–
stored_bytes–yes–
streamstringyes–
textstringyes–
truncatedbooleanyes–
utf8_replacedbooleanyes–

No examples provided.

search_cloud_projects ~83

Search project titles/descriptions/filenames in the caller's active organization. Source contents and personal projects are not searched. library_id optionally restricts to one organization library. Search indexing is asynchronous. Results describe version_id at search time; filesystem tools read current files.

NameTypeReqDescription
library_id–––
limitinteger––
querystringyes–

No output schema declared.

No examples provided.

Install

How do I install the io.github.KittyCAD/zoo-mcp server?

io.github.KittyCAD/zoo-mcp runs locally as a PyPI package, launched with uvx zoo_mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

pypi · zoo_mcp

# add to Claude Code
claude mcp add kittycad-zoo-mcp -- uvx zoo_mcp
Common questions

What is the io.github.KittyCAD/zoo-mcp server?

io.github.KittyCAD/zoo-mcp is listed in the public MCP registry as io.github.KittyCAD/zoo-mcp. An MCP server that provides access to the Zoo API for various CAD operations and tools. This page covers its PyPI package (zoo_mcp).

Is the io.github.KittyCAD/zoo-mcp server safe to use?

io.github.KittyCAD/zoo-mcp scores 60 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the io.github.KittyCAD/zoo-mcp server expose?

io.github.KittyCAD/zoo-mcp exposes 61 tools: upload_job_execution_input, submit_job_execution, get_job_execution, list_job_executions, read_job_execution_logs, and 56 more. Their descriptions and schemas cost roughly 9,680 tokens of context every time the server is loaded.

Is the io.github.KittyCAD/zoo-mcp server still maintained?

io.github.KittyCAD/zoo-mcp is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the io.github.KittyCAD/zoo-mcp server under?

io.github.KittyCAD/zoo-mcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

What did VerifyMCP test on the io.github.KittyCAD/zoo-mcp server?

VerifyMCP ran 15 checks on io.github.KittyCAD/zoo-mcp, covering Known CVEs, Install scripts, Dependency health, Source repository and 11 more. One item could not be completed, a gap on our side rather than a finding about io.github.KittyCAD/zoo-mcp: Malware scan. Endpoint Security and Transport & Reachability do not apply to a PyPI package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.