MCP Server

DealMachine runs a remote MCP server at:

1https://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:

1Authorization: Bearer dm_sk_live_xxx

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

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

Connect Claude Code

12claude 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:

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

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

Direct HTTP Check

1234curl -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.