> ## Documentation Index
> Fetch the complete documentation index at: https://api.docs.dealmachine.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Connect AI agents to DealMachine with the remote Model Context Protocol server

# MCP Server

DealMachine runs a remote MCP server at:

```text theme={null}
https://mcp.dealmachine.com
```

Use it when an AI agent needs live property intelligence, owner contact data, comps, property and people search, exports, account usage, or location lookup.

## Authentication

MCP clients authenticate with a DealMachine API key in the `Authorization` header:

```text theme={null}
Authorization: Bearer dm_sk_live_xxx
```

Get an API key from [Developer Settings](https://next.dealmachine.com/settings/developer). OAuth-aware MCP clients can also discover authorization metadata from:

```text theme={null}
https://mcp.dealmachine.com/.well-known/oauth-protected-resource
```

## Connect Claude Code

```bash theme={null}
claude mcp add dealmachine --transport http https://mcp.dealmachine.com \
  --header "Authorization: Bearer dm_sk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
```

## Connect Claude Desktop

Add this to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json theme={null}
{
  "mcpServers": {
    "dealmachine": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.dealmachine.com",
        "--header",
        "Authorization: Bearer dm_sk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
      ]
    }
  }
}
```

## Connect Cursor

Add this to `.cursor/mcp.json`:

```json theme={null}
{
  "mcpServers": {
    "dealmachine": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.dealmachine.com",
        "--header",
        "Authorization: Bearer dm_sk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
      ]
    }
  }
}
```

## Direct HTTP Check

```bash theme={null}
curl -X POST https://mcp.dealmachine.com \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer dm_sk_live_YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}'
```

## MCP Tools

DealMachine currently exposes 21 MCP Tools.

### Enrichment

| MCP Tool                     | Description                                          | Cost                                                                               |
| ---------------------------- | ---------------------------------------------------- | ---------------------------------------------------------------------------------- |
| `dealmachine_enrich_address` | Look up a property by street address.                | 1 property data credit per match                                                   |
| `dealmachine_enrich_latlng`  | Look up the closest property by GPS coordinates.     | 1 property data credit per match                                                   |
| `dealmachine_enrich_apn`     | Look up a property by Assessor's Parcel Number.      | 1 property data credit per match                                                   |
| `dealmachine_enrich_email`   | Look up a person by email address.                   | 1 people data credit per matched person                                            |
| `dealmachine_enrich_phone`   | Look up a person by phone number.                    | 1 people data credit per matched person                                            |
| `dealmachine_enrich_name`    | Look up people by name. Always narrow with location. | Free with `estimate_cost=true`. Otherwise 1 people data credit per person returned |

### Search, Export, Comps, And Locations

| MCP Tool                        | Description                                                       | Cost                                               |
| ------------------------------- | ----------------------------------------------------------------- | -------------------------------------------------- |
| `dealmachine_property_search`   | Search properties by location and filters.                        | Credit-consuming unless `estimate_cost=true`       |
| `dealmachine_property_count`    | Count matching properties before a search or export.              | Free                                               |
| `dealmachine_property_export`   | Export matching property-owner contacts as CSV.                   | Credit-consuming export                            |
| `dealmachine_property_get`      | Fetch one property by ID.                                         | 1 property data credit unless `enrich=false`       |
| `dealmachine_property_get_many` | Fetch up to 25 properties by ID.                                  | 1 property data credit per property unless deduped |
| `dealmachine_comps`             | Find comparable sales and active listings for subject properties. | 1 property data credit per subject found           |
| `dealmachine_people_search`     | Search people by location and filters.                            | Credit-consuming unless `estimate_cost=true`       |
| `dealmachine_people_count`      | Count matching people before a search or export.                  | Free                                               |
| `dealmachine_people_get`        | Fetch one person by ID.                                           | Credit-consuming unless deduped                    |
| `dealmachine_people_get_many`   | Fetch up to 25 people by ID.                                      | Credit-consuming unless deduped                    |
| `dealmachine_location_search`   | Look up FIPS codes, ZIP codes, and location IDs by name.          | Free                                               |

### Discovery And Account

| MCP Tool              | Description                                                       | Cost |
| --------------------- | ----------------------------------------------------------------- | ---- |
| `dealmachine_filters` | List available search filters with types, operators, and options. | Free |
| `dealmachine_fields`  | List available result fields.                                     | Free |
| `dealmachine_usage`   | Get credit usage for the current billing cycle.                   | Free |
| `dealmachine_whoami`  | Check the authenticated account and organization.                 | Free |

Address autocomplete is intentionally not exposed as an MCP Tool. Use
`dealmachine_location_search` to normalize a city, county, state, or ZIP, and use
`dealmachine_enrich_address` for a property address.

### Parameters Added Across MCP Tools

| MCP Tools                                                  | Parameters and output                                                            |
| ---------------------------------------------------------- | -------------------------------------------------------------------------------- |
| `dealmachine_property_get`                                 | Accepts `fields` and `contact_audience`, including `none` for property-only data |
| Property enrichment tools                                  | Accept `fields` and `contact_audience`, including `none`                         |
| Email, phone, and name enrichment                          | Accept `fields` and return free `property_count` metadata                        |
| `dealmachine_people_get` and `dealmachine_people_get_many` | Accept `fields` and `property_limit`, default 20 and max 100                     |

Phone output types use `wireless`, `landline`, `voip`, or `unknown`.
`dealmachine_enrich_name` estimates include associated property totals and page-aware property
credits when both `estimate_cost=true` and `include_properties=true` are passed.

## Credit-Safe Agent Defaults

* Call `dealmachine_filters` and `dealmachine_fields` before constructing searches.
* Call `dealmachine_property_count` or `dealmachine_people_count` before any large search or export.
* Call `dealmachine_usage` before batch work.
* Use `contact_audience: "none"` for property lookup or enrichment when contacts are not needed.
* Confirm with the user before exporting or returning a large credit-consuming result set.
* Default property exports to owner contact rows unless the user explicitly asks for property-only rows.