Johnson Controls Metasys

Johnson Controls Metasys MCP Connector for Claude

A+

Johnson Controls Metasys building automation as an MCP: browse the object tree, live alarms with annotations, equipment, network devices and spaces — official REST API v4 with bearer JWT auth.

8 tools Official Updated Oct 1, 2026 Official Vinkius Partner

Metasys — Johnson Controls' building automation system (BAS) — and its official REST API v4 as a single MCP server.

What you can do

  • Browse the object tree — every device, point and node on the site, with attributes, present values and hierarchy children
  • Alarms — live and historical alarms (fire, security, HVAC) with operator annotations
  • Equipment — chillers, AHUs, RTUs with their pointsUrl
  • Network devices — controllers (NAE, MBC...) with firmware and topology
  • Spaces — rooms, zones and floors for comfort monitoring
  • Activities & audits — who changed what, and when

Authentication (from the official Metasys REST API docs)

  1. Requires a Metasys Site (v11+) with the REST API enabled and an account whose Access Type is "API" (Active Directory accounts: {name}@{domain})
  2. The MCP logs in at POST /api/v4/login and receives a Bearer JWT access token
  3. Token expiry follows the Metasys profile — the official guidance is to refresh before 60 minutes, which this MCP does automatically

Who is this for?

Building operations teams, energy managers, fault-detection analytics, systems integrators and AI agents monitoring JCI/Metasys buildings.

johnson-controlsmetasysbuilding-automationhvacbassmart-buildings

8 tools expose this connector's capabilities to your AI agent.

get_object

), object type, and URLs for children/alarms. Use UUIDs from list_objects. Get one Metasys object: attributes, present values, status and hierarchy links

list_objects

Returns objectId (UUID) with name, description and type. Children of an object: get_object_children. Paging via page/size. List Metasys objects (BACnet-ish tree: devices, points, equipment nodes)

get_object_children

Children may be paginated via the returned pages links. List the children of a Metasys object (browse down the building tree)

list_alarms

Filter by object with the object query, or browse pages. Each alarm supports annotations (get via /alarms/{id}/annotations). List Metasys alarms (fire, security, HVAC alarms across the site)

get_alarm_annotations

Get operator annotations/notes on an alarm

list_equipment

Equipment groups physical devices regardless of the network topology. List equipment in the Metasys site (chillers, AHUs, RTUs...)

list_network_devices

) with firmware versions and their equipment/pointsUrl. The network topology view. List network devices: controllers and field buses connected to Metasys

list_spaces

Useful for comfort monitoring per room. List spaces (rooms, zones, floors) with their temperature/humidity links

See how to talk to your AI agent using Johnson Controls Metasys.

Show me active alarms in the building

🚨 **Metasys alarms (page 0)** - AHU-3 Supply Fan Failure — alarm, 2026-09-07 06:14 - Chiller 1 Low Refrigerant — alarm, 2026-09-06 22:41 - VAV-201 Temperature High — warning, ongoing 2 have operator annotations. Want the full attribute detail of any alarm?

Browse what devices are on my Metasys site

🌳 **Metasys object tree (page 0)** Root: Building A → NAE-1 (network device) → AHU-1, VAV-101..VAV-230, FCU devices... Each node exposes children via get_object_children — I can walk down to individual sensor points and read their present values.

What equipment do I have and which controllers manage them?

⚙️ **Equipment & network devices** Equipment: Chiller-1, AHU-2, Boiler-1 (each with pointsUrl) Network devices: NAE-1 (v9.0.2), MBC-B1 (v14.1) — with firmware versions I can map each equipment to its managing controller and pull any point's present value.

A Metasys Site (ADS/OTI server) running Metasys v11+ with the REST API enabled, and an account whose Access Type is set to 'API' (created in the Metasys UI). Active Directory users format the username as name@domain.

Related Connectors