Tekla and AI. Made Easy.

Tekla MCP Server

This server enables interaction with Tekla Structures, helping users automate and accelerate modeling workflows. It acts as a bridge between AI agents or MCP-compatible clients and Tekla, exposing resources and tools for selection, component insertion, property management, modeling and view operations. A read-only mode is available for safe query-only access.

📌 What is MCP?

MCP stands for Model Context Protocol, a communication protocol introduced by Anthropic to enable efficient and secure interactions between large language models and external systems.

Tekla MCP Server uses AI-powered natural language processing to translate human intent into Tekla operations, allowing users to interact with tools using plain text.

To use this server, one must first install and configure an MCP client.

Features

• Modular Architecture: Powered by FastMCP 3.0, with toolset organization through modular providers (Selection, View, Properties, Components, Operations, Drawings, Modeling).

• Resource Discovery: Auto‑detection of available filters, macros, components, Tekla phases, grids, material and rebar catalogs and project context files.

• Component Handler Plugin System: Flexible plugin model for Tekla components with lifecycle hooks, e.g., Lifting Anchors component selects anchors based on element weight and auto‑calculates anchor placement according to center of gravity.

• LLM‑Powered Component Property Understanding: Natural language mapping like "concrete cover thickness" → actual Tekla component property.

• Semantic Attribute Mapping: Hybrid semantic system (MiniLM embedding model + LLM fallback) for mapping user‑friendly names to Tekla attributes.

• Flexible Access Control: Possibility to run in read-only mode for safe query-only access and to hide specific tool categories based on project or workflow needs.

See Reference for complete list of tools and resources.

Compatibility

Tested with Tekla 2022 and Tekla 2026. See Compatibility for the full list of verified MCP clients and language models.

Installation

For complete setup instructions, see Quickstart Guide.

Documentation

Guide	Description
Reference	Tools and resources reference
Quickstart	Setup and first steps
Configuration	Config files and environment variables
Testing	Running tests
Distribution	Building portable binary

License

This software is open-source and released under the GPLv3 license. You are free to use, modify, and distribute it, as long as all modifications remain open-source under the same license.

For full details, please refer to the LICENSE file included in this repository.

Disclaimer

This software is provided as is, without any warranties or guarantees of functionality, reliability, or security. The developer assumes no responsibility for any damages, data loss, or other issues arising from its use.

Use at your own risk.