home / mcp / building mcp server

Building MCP Server

Provides building and office address data, including fuzzy searches, address details, address stats, and building queries via MCP.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "handaas-building-mcp-server": {
      "url": "http://127.0.0.1:8000/mcp",
      "headers": {
        "SECRET_ID": "your_secret_id",
        "SECRET_KEY": "your_secret_key",
        "INTEGRATOR_ID": "your_integrator_id"
      }
    }
  }
}

This MCP server provides comprehensive building and office address data, enabling you to search corporate offices, analyze address distributions, and query building information for geographic and occupancy insights.

How to use

Connect your MCP client to the locally running server to perform fuzzy company searches, fetch office addresses, analyze address stats, and query building information. Use the available tools to retrieve data in pages, filter by region, and inspect details such as city distributions and building occupancy.

How to install

Prerequisites: Python 3.10 or newer.

Set up a dedicated Python environment and install dependencies.

git clone https://github.com/handaas/building-mcp-server
cd building-mcp-server

python -m venv mcp_env && source mcp_env/bin/activate
pip install -r requirements.txt

Additional setup and usage notes

Create and configure environment variables for your MCP session to authenticate with the MCP platform.

cp .env.example .env
```

Edit the .env file to include your credentials:

```
INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key

Start the local streamable HTTP server

Launch the server in streamable HTTP mode. The service will be reachable at the default local URL.

python server/mcp_server.py streamable-http

Cursor / Cherry Studio MCP configuration for local use

Configure Cursor or Cherry Studio to connect to the local MCP server via a streamable HTTP URL.

{
  "mcpServers": {
    "handaas-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

Available tools

building_bigdata_fuzzy_search

Performs fuzzy search for companies based on keywords like company name, brand, product, or executive names. Returns a list of matching enterprises with pagination options.

building_bigdata_office_address_details

Queries office address details for a given enterprise using matchKeyword and optional filters such as address, keywordType, and pageSize. Returns total results and a detailed list of addresses.

building_bigdata_office_address_stats

Returns statistics on office addresses for a specified enterprise, including city-level distributions.

building_bigdata_building_query

Queries building information by keyword and location, returning building names, aliases, addresses, types, and occupancy counts.