MCP Server

DealMachine runs a remote MCP server at:

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:

Authorization: Bearer dm_sk_live_xxx

Get an API key from Developer Settings. OAuth-aware MCP clients can also discover authorization metadata from:

https://mcp.dealmachine.com/.well-known/oauth-protected-resource

Connect Claude Code

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:

{
  "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:

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

Direct HTTP Check

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.

Getting Started

Searching

Data & Fields

Responses

Usage

CLI

Reference

AI Assistants

MCP Server

MCP Server

Authentication

Connect Claude Code

Connect Claude Desktop

Connect Cursor

Direct HTTP Check

MCP Tools

Enrichment

Search, Export, Comps, And Locations

Discovery And Account

Parameters Added Across MCP Tools

Credit-Safe Agent Defaults

​MCP Server

​Authentication

​Connect Claude Code

​Connect Claude Desktop

​Connect Cursor

​Direct HTTP Check

​MCP Tools

​Enrichment

​Search, Export, Comps, And Locations

​Discovery And Account

​Parameters Added Across MCP Tools

​Credit-Safe Agent Defaults

MCP Server

Authentication

Connect Claude Code

Connect Claude Desktop

Connect Cursor

Direct HTTP Check

MCP Tools

Enrichment

Search, Export, Comps, And Locations

Discovery And Account

Parameters Added Across MCP Tools

Credit-Safe Agent Defaults