# Archicad Mcp

> Archicad MCP server implementation

- **Type:** MCP server
- **Install:** `agentstack add mcp-lgradisar-archicad-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [lgradisar](https://agentstack.voostack.com/s/lgradisar)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [lgradisar](https://github.com/lgradisar)
- **Source:** https://github.com/lgradisar/archicad-mcp

## Install

```sh
agentstack add mcp-lgradisar-archicad-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# archicad-mcp

`archicad-mcp` is a framework that runs an **MCP server** for **Graphisoft Archicad**.  
It uses the **Tapir** add-on with its additional JSON commands to let MCP clients like **Anthropic’s Claude** interact with Archicad.

## Installation

### Tapir

For `archicad-mcp` to work, the [Tapir Archicad Add-On](https://github.com/tlorantfy/tapir-archicad-automation) is required. Please follow the installation instructions provided in that repository.

This package also depends on two Tapir files that define the JSON command structure used to automatically compile MCP-ready tools:

- [Tapir Command Definitions file](https://github.com/ENZYME-APD/tapir-archicad-automation/blob/main/docs/archicad-addon/command_definitions.js)  
- [Tapir Common Schema Definitions file](https://github.com/ENZYME-APD/tapir-archicad-automation/blob/main/docs/archicad-addon/common_schema_definitions.js)  

These files are located under the `src/mcp_server/tapir` folder.  
If you encounter mismatched commands, update the files directly from the Tapir repository.
These files can also be linked directly from the Tapir repo, but may cause mismatches if not updated in sync with the add-on.

### FastMCP Server

#### 1. Clone the repository
```bash
git clone https://github.com/lgradisar/archicad-mcp.git
cd archicad-mcp
```

#### 2. Setup virtual environemnt
It is recommended to use [`uv`](https://docs.astral.sh/uv/getting-started/installation/) to install and create virutal environment.

Simply run:

```bash
uv sync
```

#### 3. Add to Claude config
Edit the config file manually:
- On Windows: `%APPDATA%\Claude\claude_desktop_config.json`
- On Mac: `~/Library/Application\ Support/Claude/claude_desktop_config.json`

Add this block (replace `YOUR_DIRECTORY` with the full path to archicad-mcp):

```json
{
  "mcpServers": {
    "archicad-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "YOUR_DIRECTORY/archicad-mcp",
        "python",
        "-m",
        "server"
      ],
      "env": {
        "PYTHONPATH": "YOUR_DIRECTORY/archicad-mcp/src"
      }
    }
  }
}
```

## Supported Tools

### Tapir JSON Commands
See the full list of [Tapir JSON Commands](https://enzyme-apd.github.io/tapir-archicad-automation/archicad-addon/).

### Custom Tools
This repository also supports adding your custom tools, either from the [official JSON commands](https://archicadapi.graphisoft.com/JSONInterfaceDocumentation/#Introduction) or other sources.  
They can be defined in the `src/mcp_server/tools/custom_tools.py` file.

For new Archicad-specific commands that are not part of the official JSON commands, it is recommended to contribute them directly to the Tapir repository instead.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [lgradisar](https://github.com/lgradisar)
- **Source:** [lgradisar/archicad-mcp](https://github.com/lgradisar/archicad-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-lgradisar-archicad-mcp
- Seller: https://agentstack.voostack.com/s/lgradisar
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.