Connect your AI assistant to Kaiterra with MCP (Beta)

Beta feature. Kaiterra MCP is in beta. Tools and capabilities may change at any time, and behavior may vary between AI assistants.

The Kaiterra MCP server lets AI assistants read your building air quality data directly. Claude, Microsoft Copilot, Cursor, and other Model Context Protocol clients can connect. Ask questions in plain language instead of opening dashboards or exporting data.

The assistant only sees what your Kaiterra account can see. Your existing roles and permissions apply to every request.

Server URL

https://app.kaiterra.com/ai/mcp

The server is hosted by Kaiterra and uses the Streamable HTTP transport. There is nothing to install or run yourself.

What you can ask it to do

The server provides 27 tools across these areas:

Area	What you can do
Buildings	List buildings, inspect floors, spaces, and devices, run a traffic-light health check
Air quality and trends	Time-within-target breakdowns, time series across devices and floors, before and after comparisons, occupancy from CO₂, outdoor air quality
Investigation	Detect statistical anomalies and step changes, deep-dive a single device's history
Compliance	WELL v2 scoring: preconditions, optimizations, and failures
Device health	Signal strength and data staleness across a building's sensors
HVAC	List AHUs and OAUs with their in-duct sensors, view airflow, filter lifetime, and PM reduction
Floorplans	Spatial adjacency and interactive floorplan room data with live metrics
Alerts	Create, list, and delete threshold watches, and review alert history
Organization	Rename, place, and move devices, create and update spaces
Charts	Build validated chart specs from your data

Most tools are read-only. Six tools write changes: creating and deleting alerts, updating and moving devices, and creating and updating spaces. These follow the same permissions as making those changes in the Kaiterra web app.

All tool names are prefixed kaiterra_ so they never collide with other MCP servers you have connected.

Before you start

You need an active Kaiterra account with access to your organization's buildings.

Kaiterra accounts are scoped to a single organization. One account accesses one organization at a time, exactly as in the Kaiterra Data Platform. If you have access to more than one organization, you use a separate email address or alias for each, and signing in to one signs you out of any other. The assistant sees only the organization you are currently signed in to.

If your organization uses Single Sign-On, you sign in through your identity provider during setup. See Single Sign-On for the Kaiterra Data Platform. If your organization has enabled Login with SSO only, everyone must connect through your IdP, and users without an organizational email address won't be able to connect.

Connect your assistant

Most assistants connect over OAuth. You add the server URL once, sign in with your Kaiterra account in a browser window, and that's it.

Claude (web and desktop app)

Go to Settings → Connectors → Browse →Add custom connector.
Enter a name, such as Kaiterra, and the server URL: https://app.kaiterra.com/ai/mcp
Select Add, then Connect, and sign in with your Kaiterra account.

Claude Code

claude mcp add --transport http kaiterra https://app.kaiterra.com/ai/mcp

Then run /mcp and authenticate when prompted.

Claude Desktop (config file method)

Add this block to claude_desktop_config.json via Settings → Developer → Edit Config, then restart Claude Desktop:

json

{   "mcpServers": {     "kaiterra": {       "command": "npx",       "args": ["-y", "mcp-remote", "https://app.kaiterra.com/ai/mcp"]     }   } }

A browser window opens for you to sign in.

Cursor

Go to Customize → + New MCP Server.
If the config file is empty, paste this exactly:

json

{   "mcpServers": {     "kaiterra": {       "url": "https://app.kaiterra.com/ai/mcp"     }   } }

If the file already lists other connections, add only the kaiterra block alongside them, and make sure there is a comma between each entry.

Press Cmd+S (Mac) or Ctrl+S (Windows). Cursor picks up the change right away.
Select Authenticate and sign in with your Kaiterra account.

Microsoft Copilot

Copilot connects through Copilot Studio and needs a few extra OAuth steps. See Connect Kaiterra MCP to Microsoft Copilot.

Other clients

Any client supporting remote MCP servers over Streamable HTTP can connect to the server URL. Clients that only support local (stdio) servers can bridge to it using mcp-remote, as shown in the Claude Desktop example.

Example prompts

Getting oriented

"What buildings do I have access to?"
"Show me the floors and spaces in the Shanghai office."

Checking air quality

"How's the air quality in the London office right now?"
"Give me a health check for [building]."
"What's the CO₂ trend on the 3rd floor this week?"
"Compare PM2.5 across all floors in [building]."

Investigating issues

"Why did CO₂ spike in [building] last Tuesday?"
"Are there any anomalies in [building] over the last 7 days?"
"Which devices have weak signal or are offline?"

Compliance and HVAC

"Is [building] WELL v2 compliant this quarter?"
"What's blocking us from passing the ventilation precondition?"
"How are the air handling units performing in [building]?"
"Which filters are near end of life?"

Analysis and charts

"Compare CO₂ before and after we changed the HVAC schedule on [date]."
"Chart the CO₂ trend for [building] over the last 30 days."

Taking action

"Alert me when CO₂ in the main conference room goes above 1000 ppm."
"What alerts do I currently have set up?"

Security and privacy

Your permissions apply. The assistant can only access buildings and data your Kaiterra account is authorized to see, including for write operations.

Data goes to your AI provider. Building data returned by the tools is sent to your AI assistant's provider, such as Anthropic or Microsoft, to generate responses. Follow your organization's data handling policies when using the server.

Troubleshooting

Problem	What to do
Sign-in window doesn't appear, or the connection fails	Confirm the server URL is exactly `https://app.kaiterra.com/ai/mcp`, then reconnect from your client's connector settings.
"No access" or empty results	Check that your Kaiterra account has access to the building in the Kaiterra Data Platform. The assistant sees only what you can.
SSO users can't connect	Confirm your organization has SSO configured and your account is provisioned through your identity provider. See the SSO guide. For identity provider issues, contact your IT team.
You expected to see a different organization's buildings	Each account accesses one organization at a time. Sign in with the account or alias tied to the organization you need.
Session stops working after a while	Your access token expired. Most clients refresh automatically. If yours doesn't, reconnect the server.
Config changes aren't picked up	Restart your AI client after editing its MCP config.
Requests start failing after heavy use	Rate limits protect the platform. Wait a moment and try again.

For anything else, please contact Kaiterra Support.

Related articles