Allplan MCP Server

FastMCP server that exposes the local Allplan Python host as MCP tools.

The existing Allplan PythonPart starts a small local HTTP host at 127.0.0.1:5679. This package adds a FastMCP server in front of it, so agents can call MCP tools over Streamable HTTP at /mcp.

Setup

uv sync

Register the Allplan PythonPart bridge on the Windows machine where Allplan is installed:

utils\register_python_host.cmd

By default this copies the bridge to:

%USERPROFILE%\Documents\Nemetschek\Allplan\2026\Usr\Local\PythonParts\PythonHost
%USERPROFILE%\Documents\Nemetschek\Allplan\2026\Usr\Local\PythonPartsScripts\PythonHost

For a different Allplan version:

utils\register_python_host.cmd --allplan-version 2025

In Allplan, start the StartPythonHost PythonPart after registration. It must keep running while the MCP server is being used.

Run locally

uv run allplan-mcp

By default this starts the MCP server at:

http://127.0.0.1:8000/mcp

Useful environment variables:

ALLPLAN_HOST_URL=http://127.0.0.1:5679
MCP_HOST=127.0.0.1
MCP_PORT=8000
MCP_PATH=/mcp

Tools

• allplan_health: checks whether the Allplan host is reachable.
• get_allplan_version: returns the running Allplan version.
• get_all_object_names: returns display names for elements in the current document.
• create_cube: creates a cube in the current document.
• create_box: creates a rectangular cuboid in the current document.