Skip to content

MCP Server Beta

The Archilogic MCP (Model Context Protocol) Server allows AI assistants and agents to access Archilogic resources directly through a standardized protocol.

WARNING

This is currently in closed beta. Breaking changes are to be expected.

Overview

The Archilogic MCP Server is a remote MCP server that supports Streamable HTTP transport. It enables AI tools like Claude to interact with your Archilogic portfolio data, including buildings, floors, spaces, and metrics.

Available Operations

The MCP Server currently provides the following operations:

OperationDescription
list_buildingsList all buildings in your portfolio
list_floorsList all floors across your portfolio
get_floor_metricsGet detailed metrics for a specific floor or floors
list_spaces_by_floorList all spaces on a specific floor

Setup

The Archilogic MCP Server is a remote MCP server that can be used with any MCP client that supports remote MCP connections via Streamable HTTP.

Claude Desktop

To use the Archilogic MCP Server with Claude Desktop, add the following configuration to your MCP settings:

json
{
  "mcpServers": {
    "archilogic": {
      "command": "npx",
      "args": ["mcp-remote", <MCP-SERVER-URL>]
    }
  }
}

This configuration uses mcp-remote to connect to the Archilogic remote MCP server via Streamable HTTP.

Other MCP Clients

You can use the Archilogic MCP Server endpoint with any MCP client that supports remote Streamable HTTP connections. Refer to your client's documentation for configuration instructions.

Authentication

The MCP Server authenticates users via Archilogic's OAuth 2.0 mechanism. When you first connect to the MCP server, you will be prompted to authorize access through Archilogic's OAuth flow. This grants the MCP server permission to access your portfolio data on your behalf.

Example Usage

Once configured, you can ask the MCP client to interact with your Archilogic data:

List all buildings in my portfolio

Show me the floors in building X

Get the metrics for floor Y

The AI assistant will use the appropriate MCP operations to fetch and display the requested information.