> For the complete documentation index, see [llms.txt](https://docs.buildings.ability.abb/collection/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buildings.ability.abb/collection/for-developers/mcp.md).

# MCP

Connect AI clients to BuildingPro Suites through MCP.

The BuildingPro Suites MCP server connects compatible AI clients to platform tools. Use it to inspect building data or manage supported settings from an AI client.

{% hint style="warning" %}
MCP is not fully available yet. \
At the moment it is only available on our **demo system** at:

`https://demo.buildings.ability.abb/suites-demo/mcp`
{% endhint %}

{% hint style="warning" %}
It is possible to **change and delete data** (e.g. dashboard configurations, asset setpoints) through our MCP server.

While our tool definitions hint at the intended usage and potential impact of each operation ,according to [best practices](https://modelcontextprotocol.io/specification/2026-07-28/server/tools) of the Model Context Protocol, it is the responsibility of the client to ensure that any changes made through MCP are correct and intended.

**Exercise caution** and **confirm** the intended changes of your AI Agent before performing any write operations. An API key with write access has essentially system admin rights and thus full control over the resources it can access.

We are not responsible for any unintended changes or consequences resulting from the use of MCP.
{% endhint %}

## What MCP does

Model Context Protocol (MCP) lets an AI client call tools provided by another service. The BuildingPro Suites MCP server exposes selected tools for your tenant.

The [Data Agent](https://docs.buildings.ability.abb/collection/copilot-assistant/agent-modes/data-agent.md) in Copilot Assistant focuses on retrieving and analyzing data for your tenant it can not yet change data. MCP is a separate connection for compatible AI clients that you can use directly to have the Language Model(s) interact with your tenant's assets, their data and supported platform features.

## Access

Connect your MCP client to `https://buildings.ability.abb/suites/mcp`.

Your API key determines which tenant and platform resources the server can access. Signing in to BuildingPro Suites with Microsoft SSO does not sign an MCP client in. MCP currently uses an API key and not an individual user sign-in to authenticate.

{% hint style="info" %}
Only an administrator can create an API key. Each key currently grants either read access or read/write access. We plan to overhaul API keys with finer-grained role-based access and dedicated MCP keys.
{% endhint %}

[Toolset selection](https://docs.buildings.ability.abb/collection/for-developers/mcp/connect-your-client.md#choose-tools) controls which tools the client can discover.

## Current capabilities

| Task                                                                                                                                              | What you can do                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Important limits                                                                                                                                                                |
| ------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Find assets](https://docs.buildings.ability.abb/collection/mandatory-base/assets.md)                                                             | Search assets, inspect their [details](https://docs.buildings.ability.abb/collection/mandatory-base/assets/asset-details.md), and browse [physical/locational and functional relationships](https://docs.buildings.ability.abb/collection/mandatory-base/assets/structuring-assets.md).                                                                                                                                                                                                                                                                                                                               | Names can be ambiguous. Confirm the correct asset via its unique identifiers (e.g. `gai`, `asset_id`) before changing it.                                                       |
| [Read and analyze data](https://docs.buildings.ability.abb/collection/mandatory-base/assets/asset-data.md)                                        | Read [current values and historical data](https://docs.buildings.ability.abb/collection/mandatory-base/assets/asset-data.md), compare trends, and use configured unit conversions optionally.                                                                                                                                                                                                                                                                                                                                                                                                                         | Some attributes have no historical readings. Missing readings are not zero. When comparing values from different assets be mindful that their units and meaning are compatible. |
| [Review alarms](https://docs.buildings.ability.abb/collection/platform/alert-center/alarms.md)                                                    | List current or historical alarms and acknowledge an alarm.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Current results can include cleared alarms awaiting acknowledgement.                                                                                                            |
| [Manage alarm rules](https://docs.buildings.ability.abb/collection/platform/alarms-rules-and-escalations/rules/create-a-rule.md)                  | List, inspect, create, update, or delete supported alarm rules.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Resolve the asset and enabled attribute first. MCP does not support every field available in BuildingPro Suites.                                                                |
| [Manage calculations](https://docs.buildings.ability.abb/collection/mandatory-base/assets/attribute-functions/calculate-values-the-calculator.md) | List, inspect, create, update, or delete attribute calculations.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | A calculation uses either a formula or a supported filter, not both. Lists are tenant-wide or filtered by rule ID.                                                              |
| [Build dashboards](https://docs.buildings.ability.abb/collection/platform/live-cockpit/create-a-new-dashboard.md)                                 | Find and read dashboards, create dashboards, inspect widget types, and [manage widgets](https://docs.buildings.ability.abb/collection/platform/live-cockpit/add-widgets-to-the-dashboard.md).                                                                                                                                                                                                                                                                                                                                                                                                                         | Without browser access or screenshots an Agent can only see the raw, saved configuration and can not confirm how the dashboard looks in the interface.                          |
| [Manage building setup](https://docs.buildings.ability.abb/collection/mandatory-base/assets.md)                                                   | Manage [assets](https://docs.buildings.ability.abb/collection/mandatory-base/assets.md), [asset types](https://docs.buildings.ability.abb/collection/mandatory-base/platform-core/asset-core/configure-attributes.md), [tags](https://docs.buildings.ability.abb/collection/mandatory-base/platform-core/workspace-and-identity/tags.md), and [sites](https://docs.buildings.ability.abb/collection/getting-started/2.-configure-edge-and-connect-via-openbos/associate-site.md). List [users and roles](https://docs.buildings.ability.abb/collection/mandatory-base/platform-core/workspace-and-identity/roles.md). | User and role tools are read-only. Tags cannot be deleted. Deleting an asset can also delete its attached data.                                                                 |
| [Write data](https://docs.buildings.ability.abb/collection/mandatory-base/assets/asset-data.md#add-new-data-entry)                                | Write supported values to asset attributes.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | The API key must allow writes. Writing to an output attribute can control equipment.                                                                                            |

## Potential future capabilities

The following areas are under consideration for future MCP support.

| Area                    | Possible capability                                                                           |
| ----------------------- | --------------------------------------------------------------------------------------------- |
| Insight Analytics       | Create and manage saved analyses, then evaluate them for a selected period.                   |
| Smart Views             | Create and manage views, their elements, and their data bindings.                             |
| Tickets                 | Find and manage tickets, including assignment, comments, and status changes.                  |
| Smart Logic rule chains | Create and manage rule chains.                                                                |
| Reports and scripts     | Work with reports or scripts (e.g. reviewing reports, helping with script creation).          |
| Modules and Apps        | Connect supported module services and potentially apps, such as anomaly detection or booking. |

## Connect your client

<a href="https://docs.buildings.ability.abb/collection/for-developers/mcp/connect-your-client.md" class="button secondary">Connect your client</a>

## Try an example

The [workflows and prompts](https://docs.buildings.ability.abb/collection/for-developers/mcp/workflows-and-prompts.md) page includes prompts you can copy or open in a supported AI provider. Connect your client before sending a prompt.

{% prompt description="Check current temperature readings" openInAIProviders="true" defaultExpanded="full" %}

```markdown
Use the BuildingPro Suites MCP tools to find temperature sensors in [building].
Ask me to choose if more than one building matches.
Show each sensor's current reading, unit, and timestamp.
List missing readings separately. Do not change anything.
```

{% endprompt %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.buildings.ability.abb/collection/for-developers/mcp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
