ATTOM API MCP Server

by nkbud

2 267 downloads Not rated yet
GitHub

About

The ATTOM API MCP Server is an MCP (Model Context Protocol) server that acts as middleware, exposing ATTOM API endpoints for real estate data as MCP tools. It allows AI agents to access property data, valuations, assessments, and sales information via the MCP protocol.

Explore

- MCP interface for ATTOM API endpoints
- Comprehensive API coverage for property data, valuations, assessments, and sales
- Structured error handling and logging
- Configurable via environment variables
- Packaged as a Python CLI tool for easy deployment

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name ATTOM API MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

- Python 3.11 or higher
- uv for dependency management
- An ATTOM API key

{
"mcpServers": {
"attom-api": {
"command": "uvx",
"args": ["mcp-server-attom"],
"env": {"ATTOM_API_KEY": "your_api_key_here"}
}
}
}

Start the server using the mcp-server-attom command:


mcp-server-attom --port 8000 --host 0.0.0.0

Start the server during development:

bash
python -m src.server

This will start the server using stdio transport for MCP communication.

bash
uv run pytest
```

This MCP server provides complete 1:1 coverage of ATTOM's Data API with 55+ endpoints across all major categories. For detailed API coverage mapping, see ATTOM_API_COVERAGE.md.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "attom api mcp server": {
            "mcp-server-attom": {
                "command": "uvx",
                "args": [
                    "mcp-server-attom",
                    "--help"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-server-attom": {
        "command": "uvx",
        "args": [
            "mcp-server-attom",
            "--help"
        ]
    }
}

An MCP server for the ATTOM API, providing real estate data via the MCP protocol. This server acts as middleware, exposing the ATTOM API endpoints as MCP tools that can be used by AI agents.

Features

- MCP interface for ATTOM API endpoints
- Comprehensive API coverage for property data, valuations, assessments, and sales
- Structured error handling and logging
- Configurable via environment variables
- Packaged as a Python CLI tool for easy deployment

Prerequisites

- Python 3.11 or higher
- uv for dependency management
- An ATTOM API key

Installation

Using UVX (Recommended)

The easiest way to install and run the ATTOM API MCP Server is via uvx:

uvx mcp-server-attom --help

This will download and run the tool directly without requiring a permanent installation.

To install it permanently:

uv tool install mcp-server-attom

Local Development

1. Clone this repository:

git clone https://github.com/nkbud/mcp-server-attom.git
cd mcp-server-attom

2. Install dependencies:

uv sync --locked --all-extras --dev

3. Create a .env file with your ATTOM API key:

```bash
cp .env.example .env

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.