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

The MCP Server is currently in beta. Breaking changes may occur.

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:

Building & Floor Discovery

Operation	Description
list_buildings	Lists all buildings with their floors, addresses, and areas
list_floors	Lists floors with filtering options (by name, area, seat capacity, space count, or space properties)

Space & Metrics Analysis

Operation	Description
list_spaces_by_floor	Returns detailed space data grouped by floor. Includes area, category, subcategory, and assets
get_floor_space_metrics	Comprehensive area metrics broken down by space category (work, meet, care, socialize, circulate, support), seat capacity, and space counts
get_floor_element_metrics	Furniture/asset counts (workstations, lighting, seating, tables, storage) and building element data (windows, doors, walls)

Floor Plan Intelligence

Operation	Description
get_floor_filter_options	Discovers all filterable attribute values on a floor (categories, subCategories, custom attributes)
export_floor_pdf	Generates a styled PDF floor plan with optional color-coded highlighting by category, subcategory, area, or custom attributes. Supports byFilter rules for conditional styling

Custom Operations via Extensions

You can dynamically add discoverable MCP operations by creating an Extension of type worker. Worker extensions are automatically exposed as operations for your organization by the MCP Server. See how to create a worker extension to get started.

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:

{
  "mcpServers": {
    "archilogic": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.archilogic.com/mcp"]
    }
  }
}

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.

Extensions

The MCP Server's functionality can be extended by creating custom worker extensions. Worker extensions are automatically exposed as additional MCP operations for your organization, making them discoverable by any connected AI assistant.

To learn how to create and deploy a worker extension, see the Extension SDK guide.