FreeCAD MCP

70/100

Capped at 70: core tools not tested: no backing service on the test box; the tests add up to 95. Why scores are capped

Last tested 2026-11-13 UTC (Fresh: tested within 30 days) Connects · tools listedNo tool call tested yet No key to connect

Advisories: not yet checked

Security review: not tested

Test points add up to 95; the score is capped at 70 until a tool call passes. Not a quality or security rating. Methodology

Test points before the cap (95/100)

  • Install20/20
  • Handshake30/30
  • Maintenance25/25
  • Docs10/15
  • License10/10

Tested pypi freecad-mcp 0.1.31 (MIT; repo neka-nat/freecad-mcp). Installed pinned with scripts off (uv venv, Python 3.13) and launched: initialize and tools/list over stdio succeeded with no credentials and listed 17 tools (no tool annotations). Real calls: 0 of 3 real function calls passed. No passing real call: needs a running FreeCAD with the MCP add-on. Core tools not tested: 70 cap.
Tool-call test (2026-11-13 UTC, direct MCP stdio client, no LLM): fail. 0 of 3 real function calls passed. No passing real call: needs a running FreeCAD with the MCP add-on. Evidence: local test run, Nov 13, 2026 UTC.

Transport (tested 2026-11-13 UTC): stdio

Token cost (estimate): approx. 5307 tokens, cl100k estimate (17 tools, measured 2026-11-13 UTC, version 0.1.31). This is an estimate from our testing of the tool names, descriptions and input schemas, counted with cl100k_base.

Permissions: 8 read, 6 write (state-changing), 3 unclassified · Auth: none · Rate limit: unknown · Pricing unit: unknown

Auth: none. Rate limit: unknown. Pricing unit: unknown.

  • create_document — write (state-changing)
  • create_object — write (state-changing)
  • delete_object — write (state-changing)
  • edit_object — write (state-changing)
  • execute_code — read
  • execute_code_async — write (state-changing)
  • execute_code_headless — unclassified
  • get_async_status — read
  • get_object — read
  • get_objects — read
  • get_parts_list — read
  • get_rpc_status — read
  • get_view — read
  • insert_part_from_library — write (state-changing)
  • list_documents — read
  • reload_document — unclassified
  • run_fem_analysis — unclassified

handshake and tools listed without a recorded key or OAuth

Score 70/100 · Tools 17 · Token cost approx. 5,307 tokens · Compare · Last tested 2026-11-13 UTC · Version tested 0.1.31 · Package freecad-mcp · Repo neka-nat/freecad-mcp

Summary: FreeCAD MCP completed an MCP handshake without credentials and exposed 17 tools.

Evidence summary

Handshake
pass
Tools listed
17
Context cost
approx. 5307 tokens, cl100k estimate (17 tools, measured 2026-11-13 UTC, version 0.1.31; an estimate) ranking · add up your servers' context cost
API key
No key to connect (handshake passed)
Tested
2026-11-13 UTC

Test results

TestResultPointsEvidence
installpass20uv pip install freecad-mcp (Python venv, Linux) succeeded in 0s.
handshakepass30MCP initialize + tools/list over stdio succeeded with no credentials; 17 tools listed in 12.8s.
maintenancepass25Repo pushed 0 days before test; 3,312 GitHub stars.
docspartial10install instructions present; mcpServers config example present. Check of the package's own README (PyPI long_description (package README)).
licensepass10MIT (OSI-approved).

Local-model readiness

Token cost (estimate): approx. 5307 tokens, cl100k estimate for 17 tools · about 65% of an 8k context. This is an estimate from our testing (counted with cl100k_base).

Small-model friendly (schema heuristic, not a model result): unknown.

Not tested

Small-model task runs: Not yet tested.

What we tested and what we didn't

Tested on 2026-11-13 UTC

  • Install from the registry
  • We connected with no credentials and asked for its tool list: it listed 17 tools (Method details: MCP initialize then tools/list)
  • Maintenance signals (last push, archived/deprecated status)
  • Docs (README length, install and config example)
  • License (OSI-approved or not)
  • Token cost (estimate)

Not tested

  • Security: not audited (no code review, no permission or data-flow analysis)
  • Real tasks (no functional task runs yet)
  • Behaviour with real credentials or a real account
  • Performance, rate limits or load
  • Correctness of results beyond the listed tasks

Methodology: how we test. A high score means it installs and responds, not that giving it access to your data carries no risk.

Known security issues

Not yet checked.

Monthly roundup: MCP security issues, October 2026.

Tool list changes

Baseline recorded from the 2026-11-13 UTC test run; changes appear after the next test.

Snapshot hash (fingerprint of the tool list)

3905c94d8a48: SHA-256 of the canonical tool names, descriptions and input schemas. If it changes, the tool list changed.

Feeds: RSS · JSON.

Raw test record (JSON)
{
  "name": "freecad-mcp",
  "version": "0.1.31",
  "registry": "pypi",
  "status": "working",
  "tested": "2026-11-13",
  "tools_count": 17,
  "deprecated": false,
  "archived": false,
  "tests": {
    "install": [
      "pass",
      20,
      "`uv pip install freecad-mcp` (Python venv, Linux) succeeded in 0s."
    ],
    "handshake": [
      "pass",
      30,
      "MCP `initialize` + `tools/list` over stdio succeeded with no credentials; 17 tools listed in 12.8s."
    ],
    "maintenance": [
      "pass",
      25,
      "Repo pushed 0 days before test; 3,312 GitHub stars."
    ],
    "docs": [
      "partial",
      10,
      "install instructions present; `mcpServers` config example present. Check of the package's own README (PyPI long_description (package README))."
    ],
    "license": [
      "pass",
      10,
      "MIT (OSI-approved)."
    ]
  }
}

Install

uvx freecad-mcp

Pin the version we tested

uvx freecad-mcp==0.1.31

pip install freecad-mcp==0.1.31

tested 2026-11-13 UTC. Newer versions may differ and were not tested by us.

{
  "mcpServers": {
    "freecad-mcp": {
      "command": "uvx",
      "args": [
        "freecad-mcp==0.1.31"
      ]
    }
  }
}

Tools listed

create_document, create_object, edit_object, delete_object, execute_code_async, execute_code_headless, get_async_status, execute_code, get_view, insert_part_from_library, get_objects, get_object, get_parts_list, reload_document, list_documents, get_rpc_status, run_fem_analysis

Quick config

{
  "mcpServers": {
    "freecad-mcp": {
      "command": "uvx",
      "args": [
        "freecad-mcp"
      ]
    }
  }
}

Add to config Opens the config generator with this server selected.

Setup

  1. Install. Run uv pip install freecad-mcp (Python venv). This is the exact command we ran on 2026-11-13 UTC.
  2. Configure. Add the mcpServers entry below to your MCP client config.
  3. Verify. Restart the client and check that tools/list returns tools (17 in our test).
{
  "mcpServers": {
    "freecad-mcp": {
      "command": "uvx",
      "args": [
        "freecad-mcp"
      ]
    }
  }
}

Test history

Follow this server (RSS) · Monthly changelog

Related: Best design MCP servers

FAQ

Is FreeCAD MCP deprecated?

No. freecad-mcp was not deprecated or archived when we last tested it on 2026-11-13 UTC.

What replaces FreeCAD MCP?

Nothing; FreeCAD MCP is not deprecated as of 2026-11-13 UTC.

Does FreeCAD MCP need an API key?

No. It completed an MCP handshake with no credentials and listed 17 tools.

Embed the badge

TestedMCP: 70/100, tested 2026-11-13 UTC

Every tested server gets a free embeddable badge. It shows the current score and test date and expires after 90 days. Testing is free; payment never changes a score.

Claim this listing · Report an issue