tapir-archicad-mcp
This MCP server connects an AI assistant to Archicad through the Tapir add-on, letting it discover running instances, search 800+ Archicad commands on demand, and execute them to inspect and automate projects.
Discover instances — list running Archicad targets with ports, project names/paths, Archicad and Tapir versions, plus diagnostics for unavailable instances (missing Tapir, unresponsive).
Search commands — keyword or exact-name search across 800+ commands, filtered by command groups, with paginated and chained follow-up queries.
Inspect schemas — retrieve the exact JSON input schema for a command before calling it, avoiding guessed parameters.
Execute commands — run any discovered command against a chosen port; long-running calls return job handles, and paginated results use page tokens.
Manage jobs — list retained executions (running, completed, failed) or fetch a job's result, useful for recovering after a lost response before retrying writes.
Automate workflows — inspect projects, elements, properties, and attributes; find elements by type/property/classification; create and modify elements; work with views and layouts; export data; use IFC and Teamwork commands; connect to multiple instances.
Caution — commands can create, modify, or delete model elements, export files, and interact with Teamwork, so review changes and experiment on a copy.
Provides tools for interacting with Archicad projects, including discovering and calling commands to manage elements, layers, views, and more via the Tapir and official Archicad JSON APIs.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tapir-archicad-mcp check what Archicad projects I have running"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Archicad Tapir MCP Server
Connect your AI assistant to Archicad. Use natural language to explore projects and automate workflows through the Tapir add-on and the official Archicad JSON API.
See it in action
Astra uses photos and a plan as references to model in Archicad.

Related MCP server: archicad-mcp
What can it do?
Inspect open projects, elements, properties, and attributes.
Find elements that match conditions on type, properties, and classifications.
Create and modify model elements, and work with views and layouts.
Export project data and use supported IFC and Teamwork commands.
Access 800+ Archicad commands, discovered on demand by your assistant.
Connect to multiple running Archicad instances.
Quick start
Before installing the MCP server, make sure Archicad is running on Windows or macOS and install these two requirements:
Tapir add-on — an Archicad add-on that gives the server access to Archicad's automation commands. Install it in Archicad for the version you use.
uv — a tool that installs and runs the MCP server and its dependencies. Install it on the computer running Archicad.
You'll also need an MCP client: the AI application that connects to the server.
Ask your AI to install it
Copy this prompt into your AI assistant:
Install the Archicad Tapir MCP server for my MCP client, following the instructions at https://github.com/SzamosiMate/tapir-archicad-MCP/blob/master/docs/setup-and-configuration.md. Help me verify that it can connect to my running Archicad instance.
Install it yourself
If your client supports MCP bundles, download tapir-archicad.mcpb and open it in your client. The client must be able to find uv on its PATH.
Prefer the old-school approach? Follow the manual setup instructions—editing a config file is optional hacker cred.
Try it
With Archicad running, ask your assistant:
What Archicad projects do I have open?
The assistant can list ready instances, their project names and ports, and report instances that are unavailable. If you have multiple projects open, specify the port when asking it to work on one.
How it works
Your MCP client runs this server, which connects to Archicad through multiconn_archicad. The server exposes five MCP tools for finding instances, searching and browsing commands, looking up their schemas, executing commands, and checking long-running jobs. Your assistant can search for several workflow steps at once and narrow results by command group.
Important to know
The server can create, modify, and delete model elements, export files, and interact with Teamwork. Project names, paths, and model data returned by commands are sent to your MCP client. Review changes made to your projects and use a copy when experimenting.
Available commands depend on your installed Archicad and Tapir versions. Instance discovery reports a missing Tapir add-on as unavailable and warns when the installed Tapir version differs from the version supported by the server.
Documentation
See Setup and configuration for client setup, troubleshooting, server options, HTTP transports, jobs, and pagination.
See Command discovery for keyword search, follow-up searches, and benchmarks.
See Element queries for finding and filtering elements.
Development and contributing
To develop the server, clone the repository and run uv sync from the project directory. Then configure your MCP client to run the Python interpreter from that checkout's virtual environment:
Client setting | Windows | macOS |
Command |
|
|
Arguments |
|
|
Replace <project> with the absolute path to your checkout. This runs the local code instead of the published uvx package. Restart the server in your client after making changes. Run tests with uv run pytest tests.
Generated commands
The Archicad command wrappers in src/tapir_archicad_mcp/tools/generated/ are generated from the exact multiconn-archicad version pinned in pyproject.toml. The generator reads command metadata from that release's Git tag; scripts/generator_config.py controls naming, exclusions, pagination, and image handling, and scripts/generate_tools.py produces the wrappers. To change generated behavior, review the generator and its configuration rather than only editing the generated files, since regeneration can overwrite those edits.
Contributions
Ideas, bug fixes, and small, focused improvements are welcome. For larger features, architectural changes, or major rewrites, please open an issue to discuss the approach before investing in a pull request. I may prefer to work through those changes myself as part of understanding and shaping the design.
AI-assisted contributions are welcome. Please keep pull request descriptions short and in plain language: explain the problem, your solution, and how you checked it. For larger changes in particular, understand the proposed implementation and be ready to discuss the design and trade-offs.
License and acknowledgments
This project is licensed under the MIT License. The bundle icon uses the Tapir mark from ENZYME-APD/tapir-archicad-automation (branding/logo/png/tapir_logo_black_512.png), MIT, Copyright 2024 Enzyme APD.
Available Tools
5 toolsarchicad_call_toolExecute Archicad API CommandADestructive
Executes a specific Archicad API command by its 'name'. CRITICAL WORKFLOW: You MUST use 'archicad_get_command_schema' first to understand the exact JSON structure required for the 'arguments' parameter. The 'arguments' dictionary MUST contain a 'port' number (obtained from 'discovery_list_active_archicads'). If a tool's response includes a 'next_page_token', call this same tool again with the same parameters and add a 'page_token' key to the 'arguments' dictionary. Long executions return status='running' and a jobHandle; retrieve them with archicad_get_job. If a response is lost or cancelled, list jobs with archicad_get_job() before retrying a write. Cancelling this request does not cancel an admitted execution.
Inputs: name (required), arguments (required).
archicad_get_command_schemaGet Archicad Command SchemaARead-onlyIdempotent
Retrieves the exact JSON schema (required arguments) for a specific Archicad command. Provide the exact 'command_name' obtained from 'archicad_list_commands'. CRITICAL: You MUST call this tool before executing 'archicad_call_tool' to ensure you provide the correct parameters. Do NOT guess or hallucinate parameters based on the command name.
Inputs: command_name (required). Returns: The detailed JSON schema required to execute a specific Archicad command.
archicad_get_jobGet or List Archicad JobsARead-onlyIdempotent
With no job_handle, immediately lists all retained executions newest first, including fast, completed, and failed jobs, with command, port, timestamps, and a short argumentsPreview. Use this to recover after a lost response before retrying a write; similar calls may be ambiguous. With a job_handle, waits up to the configured threshold and returns running, completed with result, or failed with error. Polling never redispatches commands.
Inputs: job_handle.
archicad_list_commandsList Available Archicad CommandsARead-onlyIdempotent
Search by keyword phrases or exact command names. Batch separate workflow steps and narrow by groups as needed.
For every follow-up on the same user request, pass the latest query_id from the previous response, even when replacing all keywords or changing groups. Omit query_id to start a new task or restart an unavailable chain.
The matches list returns up to 12 pooled ranked command names with descriptions. An exact name in scope returns that name and its status in exact_matches by keyword_index. Omit keywords to browse names.
Available groups: analytical, app, attributes, classifications, components, custom_data, design_options, dev, elements, favorites, grouping, ifc, issues, keynotes, layout, library, mep, navigator, project, project_data, properties, revisions, solid_ops, teamwork, view. Use archicad_get_command_schema before executing a selected command.
Inputs: groups, keywords, query_id. Returns: result
discovery_list_active_archicadsList Active Archicad InstancesARead-onlyIdempotent
Scans for and lists running Archicad instances. Returns 'active' (ready to receive commands with their target 'port') and 'unavailable' (instances that are unresponsive or missing the Tapir Add-On).
Inputs: no named parameters. Returns: The result of scanning for Archicad instances.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool occupies a distinct step in a clearly prescribed workflow: discover instances, search commands, fetch a schema, execute, and poll jobs. The descriptions explicitly state prerequisites and boundaries, leaving no realistic chance of misselection.
Four tools share the archicad_ prefix with a verb_noun pattern (list_commands, get_command_schema, get_job, call_tool), but discovery_list_active_archicads uses a different prefix and the generic 'call_tool' noun is vaguer than its peers.
Five meta-tools is exactly the right scope for a proxy that exposes hundreds of underlying Archicad commands via dynamic search and schema lookup. Each tool is load-bearing; nothing is redundant.
The surface covers discovery, search, introspection, execution, pagination, and job retrieval, which is solid lifecycle coverage. Minor gaps exist: no way to cancel or delete jobs despite mentions of cancellation, and no batching/parallel execution helper.
Maintenance
Related MCP Connectors
Design buildings as IFC4 BIM models from a brief: an AI architect that plans, builds and edits.
Connect your AI assistant to Blender for 3D modeling, Geometry Nodes, materials, lighting, animation, rendering and export. Inspect real scenes and viewport images, refine the result and restore checkpoints. OAuth connects your chat to Blender Bridge Desktop on an online Windows 10/11 x64 computer running Blender 4.2+. The chat can run on another device. Requires an active Blender Bridge account; 7-day trial available. AI model access is separate.
Human-input bridge for AI agents with voice-first answer links, MCP tools, and HTTP APIs.
Parametric 3D CAD for AI agents: build print-ready parts, check them, export STL, 3MF or STEP.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients like Claude to interact with Graphisoft Archicad through the Tapir add-on's JSON commands. Supports automated Archicad operations and custom tool integration for architectural design workflows.39MIT
- AlicenseAqualityBmaintenanceMCP server for Archicad automation, enabling AI assistants to run Python scripts against running Archicad instances via the Tapir JSON API for complex workflows.4202 PyPI8MIT
- FlicenseAqualityBmaintenanceRead-only MCP bridge for Archicad using the Tapir Add-On, enabling discovery, context binding, and safe read operations on Archicad projects.8-
- AlicenseCqualityBmaintenanceEnables Claude and other MCP clients to query and modify an open Archicad project through Graphisoft's official JSON API and the ~250 commands of the Tapir add-on, covering model summaries, quantity takeoffs, quality checks, element creation (walls, slabs, zones), ID management, undo/journal history, and execution of arbitrary API or Tapir commands.531MIT