Skip to main content

​
Overview

The Tacit MCP server exposes Tacit building data as tools for AI assistants. It connects to your Tacit account via API key and provides read-only access to buildings, equipment, points, zones, and systems. Compatible with Claude Desktop, Claude Code, Cursor, Windsurf, and any MCP-compatible client.
For setup instructions, see Connect AI to your building.

​
Installation

Clone the MCP server from GitHub and install dependencies:
Then configure your AI client to use the local server (see setup guide).

​
Environment variables

​
Tool reference

The MCP server exposes four tools:

​
tacit_list_sites

List all building sites the API key has access to. Call this first to discover available site IDs. Parameters: None Returns: Site name, ID, address, city, country, timezone.

​
tacit_graphql

Execute a GraphQL query against the Tacit building digital twin API. Compose any query using the Brick-compliant schema. Supports nested fields, filtering by Brick class, supply chain traversal (upstream/downstream), and recursive location hierarchy. Use tacit_list_sites first to get a valid site ID, then construct queries freely. The tool automatically injects siteId into the query variables from the site_id parameter. The full GraphQL schema reference is embedded in the tool description so the AI model can compose queries without external documentation.

​
tacit_timeseries

Query historical or live sensor data for one or more points. Points are identified by their timeseriesId (UUID). Use tacit_graphql first to find points and their timeseriesId values. Response includes: query.timezone declares the site’s IANA timezone (e.g., Europe/London). All timestamps in the response are in this timezone with the UTC offset embedded (e.g., +00:00 for GMT, +01:00 for BST). When a window is specified, timestamps are snapped to the window boundary. Common patterns:
  • Last hour raw data: start="-1h" (default)
  • Daily averages for a week: start="-7d", window="1d", aggregate="mean"
  • Last 24h at 15-minute intervals: start="-24h", window="15m"
For current/live values, use tacit_graphql with the currentValue { value timestamp quality } field on Point instead of this tool.

​
tacit_list_files

List documents and files associated with a site. Returns metadata for spec sheets, maintenance documents, BIM source files, 3D models, and knowledge graph data. Returns: Files grouped by category with name, size, and upload date.