Integration

DealMachine integration

DealMachine is a US real estate data and direct-mail platform. Search and count properties and people (owners, residents, renters) by location and filters, look up properties and people by id, enrich by address, parcel number, coordinates, email, phone or name, check Do Not Call status, validate addresses, find comparable sales, export to CSV, and manage lists, prospects with their notes, tags, files and photos, tasks, recorded drives, webhooks and postcard mail campaigns with their designs and return addresses. Lookups, enrichment, searches, exports, address validation and DNC checks spend DealMachine data credits and return personal contact data (names, phone numbers, emails, home addresses) of property owners and residents; counts and cost estimates are free. Launching a campaign or adding properties to one mails physical postcards charged to the mail wallet. Not exposed: sign-up, OAuth and device login, plan checkout and wallet top-ups, creating a webhook or rotating its signing secret (the secret is shown only once and would land in run logs), the two-step prospect file upload, and the deprecated coordinate and location-autocomplete aliases. Authentication is a DealMachine API key (dm_sk_live_...) created in DealMachine's Developer Settings, sent as a Bearer token; every key is live, there is no sandbox.

Connect DealMachine How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in DealMachine.Built from the 122 DealMachine tools below, on the connection you add once.

What you can do with DealMachine

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Id, 13 operations

cancel_campaignCancel campaignDELETECancels a campaign. A draft is cancelled; a ready, active or paused one ends as with end_campaign and its unsent mail stops. Mail already printed or with the carrier still arrives.
delete_designDelete designDELETEDeletes a postcard design. A design used by an active campaign cannot be deleted.
delete_return_addressDelete return addressDELETEDeletes a saved return address. The default address cannot be deleted: set another one as default first.
delete_webhookDelete webhookDELETEDeletes a webhook and its delivery log; nothing more is sent to its URL.
get_campaignGet campaignGETReturns one mail campaign with its steps, audience, status, return address and the contact details printed on its postcards.
get_designGet designGETReturns one postcard design with its front and back HTML, size, orientation, layout, theme, status and preview image URLs.
get_people_by_idsGet people by idsPOSTReturns up to 250 people by DealMachine person id with personal contact data (phones, emails, home address) and optionally their properties. Spends 1 people credit each unless enrich is false.
get_properties_by_idsGet properties by idsPOSTReturns up to 250 properties by DealMachine property id with their data and, by default, owner contacts (names, phones, emails). Spends property and people credits unless enrich is false.
get_return_addressGet return addressGETReturns one saved return address with its label, name, street, city, state, ZIP, validation state and whether it is the default.
get_webhookGet webhookGETReturns one webhook subscription with its URL, event types, batch size, contact opt-in, active state and delivery health.
update_campaignUpdate campaignPATCHUpdates a draft campaign: name, audience (exactly one of property_ids, contact_ids or list_ids), steps (the whole set is replaced) and the contact details on the card. Only drafts can be updated.
update_designUpdate designPATCHUpdates a design's name, front or back HTML, layout or theme. Changes go to the draft; publish=true copies the draft to the published (active) design.
update_return_addressUpdate return addressPATCHUpdates a saved return address. Changed address fields are validated again with USPS.

Tag, 9 operations

add_prospect_tagAdd prospect tagPOSTAdds one tag to a prospect. Returns whether it is assigned and whether anything changed.
create_tagCreate tagPOSTCreates a workspace tag (name unique per workspace, at most 200 tags) with an optional description, badge color and sort order.
delete_tagDelete tagDELETEDeletes a workspace tag. Fails while prospects carry it unless force=true, which removes it from them first.
get_tagGet tagGETReturns one tag with its name, description, badge color, built-in flag, active flag, sort order and how many prospects carry it.
list_prospect_tagsList prospect tagsGETLists every workspace tag with an assigned flag saying whether this prospect carries it.
list_tagsList tagsGETLists built-in and workspace tags with how many prospects carry each. include_inactive=true also returns archived tags.
remove_prospect_tagRemove prospect tagDELETERemoves one tag from a prospect. Returns whether anything changed.
set_prospect_tagsSet prospect tagsPUTReplaces a prospect's tags with exactly the given tag ids (an empty array clears them). Returns the tags and which were added and removed.
update_tagUpdate tagPATCHRenames, describes, recolors, reorders or archives (is_active=false) a workspace tag. Built-in tags cannot be changed.

Prospect, 6 operations

add_prospectsAdd prospectsPOSTStarts tracking 1 to 1,000 properties, people or companies as prospects. Existing prospects come back unchanged and archived ones return to active, so it is safe to repeat.
get_prospectGet prospectGETReturns one prospect with its record summary (address or name), lifecycle, star, source, tags, and note and file counts.
list_prospectsList prospectsGETLists the workspace's prospects (tracked properties or people) by lifecycle, source, list, tag, star or search text, with record summary, tags and note and file counts.
move_prospectsMove prospectsPATCHMoves the prospects of up to 1,000 records to active, opportunity or archived in one call. Archiving ends their mail. Records that are not prospects, or already there, are skipped and counted.
remove_prospectRemove prospectDELETEArchives a prospect and ends its mail; notes, files and activity are kept and it can be added again. With cascade=false its list memberships and open opportunities stay.
update_prospectUpdate prospectPATCHMoves a prospect between active, opportunity and archived, or stars it. Archiving ends its mail and, unless cascade is false, removes it from lists and closes open opportunities.

Export, 5 operations

export_listExport listPOSTStarts a CSV export of every record on a completed list and returns its export id (read the download links with get_export). Spends data credits per exported record.
export_peopleExport peoplePOSTExports matching people to CSV (up to 1,000,000 rows) and returns signed download links; the files hold personal contact data. Spends people credits per exported person. Answers when the file is ready.
export_propertiesExport propertiesPOSTExports matching properties to CSV (up to 1,000,000 rows, one row per property, contact, phone or email) and returns signed download links. Spends property credits, plus people credits for contacts.
get_exportGet exportGETReturns one CSV export with its status, progress, record count, file size, signed download links and expiry date.
list_exportsList exportsGETLists the workspace's CSV exports with status, progress, record count, file size, download links and expiry. Exported files can hold contact data of property owners.

List, 5 operations

create_listCreate listPOSTCreates a saved property or people list: empty, filled with up to 250 record ids, or built in the background from filters and locations (then poll get_list until status is completed).
delete_listDelete listDELETEDeletes a saved list and all its items. This cannot be undone.
get_listGet listGETReturns one saved list with its source type, build status, progress and record count. Poll it after create_list, build_list or import_list_records until status is completed.
list_listsList listsGETLists the workspace's saved property or people lists with build status, progress and record count. Search by name, filter by source type and sort.
rename_listRename listPATCHRenames a saved list. The name is the only field this call changes.

Note, 5 operations

add_prospect_noteAdd prospect notePOSTAdds a note of up to 10,000 characters to a prospect.
delete_prospect_noteDelete prospect noteDELETEDeletes a note from a prospect.
get_prospect_noteGet prospect noteGETReturns one note on a prospect with its text, author and timestamps.
list_prospect_notesList prospect notesGETLists the notes on a prospect, newest first, with their text, author and timestamps.
update_prospect_noteUpdate prospect notePATCHReplaces the text of a note on a prospect (1 to 10,000 characters).

Task, 5 operations

create_taskCreate taskPOSTCreates a task, optionally assigned to a user, due on a date, and linked to an opportunity, property or person.
delete_taskDelete taskDELETEDeletes a task from the workspace task list.
get_taskGet taskGETReturns one task with its title, description, due date, completion state, assignee and linked records.
list_tasksList tasksGETLists the workspace's tasks with title, description, due date, completion state, assignee and linked opportunity, property or person. Filter by status, title or assignee.
update_taskUpdate taskPATCHUpdates a task's title, description, links, assignee, due date or order; is_completed=true marks it done and false reopens it.

Count, 3 operations

count_peopleCount peoplePOSTCounts the people and properties matching people filters and locations without returning records. Spends no credits and works without a paid plan.
count_propertiesCount propertiesPOSTCounts the properties and people matching property filters and locations without returning records. Spends no credits and works without a paid plan.
count_prospectsCount prospectsGETCounts prospects by lifecycle (active, opportunity, archived) and record type, for the whole workspace or one list.

Item, 3 operations

add_list_itemsAdd list itemsPOSTAdds 1 to 10,000 internal property or person ids to a list. They also become prospects unless add_as_prospects is false. Returns how many were added.
list_list_itemsList list itemsGETReturns a page of the records on a list: internal property id, internal person id, DealMachine person id and when each was added.
remove_list_itemsRemove list itemsDELETERemoves 1 to 10,000 internal property or person ids from a list. Returns how many were removed.

Photo, 3 operations

add_prospect_photoAdd prospect photoPOSTAttaches a photo to a property prospect from a public https URL (up to 10 MB) or base64 data (request under 1 MB), with type, caption and location. Needs an API key created by a user.
delete_prospect_photoDelete prospect photoDELETEDeletes a photo from a property prospect.
list_prospect_photosList prospect photosGETLists the photos of a property prospect, newest first: URL, type, caption, size, dimensions and where each was taken. Property prospects only.

Search, 3 operations

search_activitySearch activityPOSTSearches the workspace's history of searches, enrichments and exports by free text, activity type, date range or returned entity ids. Spends no credits.
search_peopleSearch peoplePOSTSearches people (owners, residents, renters) with people filters and locations and returns personal data: names, phones, emails, home address. Spends 1 people credit per person; estimate_cost=true is free.
search_propertiesSearch propertiesPOSTSearches US properties by location and property filters, with owner contacts (names, phones, emails) by default. Spends 1 property credit per property and 1 people credit per contact; estimate_cost=true previews the cost free.

Campaign, 2 operations

create_campaignCreate campaignPOSTCreates a postcard campaign (1 to 5 steps, each a design or a design prompt) for properties, contacts or saved lists. launch=true starts mailing physical postcards at once, charged to the mail wallet.
list_campaignsList campaignsGETLists postcard mail campaigns with status (draft, ready, active, paused, ended), audience, steps and settings. Filter by status, name, or campaigns that accept new properties now.

Design, 2 operations

create_designCreate designPOSTCreates a postcard design from your own front and back HTML, or from a text prompt that an AI turns into HTML at once. Either prompt or html_front is required.
list_designsList designsGETLists postcard designs with status, size, orientation, layout, theme, preview image URLs and their front and back HTML. Filter by status, size or name.

Drive, 2 operations

get_driveGet driveGETReturns one recorded drive with its route, GPS events, property visits and the prospects added during it: location history of the team member who drove. Requires the Driving app.
list_drivesList drivesGETLists recorded drives (mobile driving sessions and web routes) with driver, timing, distance and how many prospects were added. Requires the Driving app on the DealMachine account.

File, 2 operations

delete_prospect_fileDelete prospect fileDELETEDeletes a file attached to a prospect, including the stored file.
list_prospect_filesList prospect filesGETLists the files attached to a prospect: name, size, content type, who uploaded it and when.

Property, 2 operations

add_campaign_propertiesAdd campaign propertiesPOSTAdds up to 5,000 properties to a ready, active or paused campaign that accepts properties. Mails physical postcards: pieces going out today are charged to the wallet now, later ones as they go out.
get_propertyGet propertyGETReturns one property by DealMachine property id with its details (value, equity, sale and loan data) and, by default, owner contacts (names, phones, emails). Spends 1 property credit plus people credits unless enrich is false.

Return address, 2 operations

create_return_addressCreate return addressPOSTSaves a postcard return address after validating it with USPS (an invalid address is refused); it can be made the default. Returns whether USPS corrected it.
list_return_addressesList return addressesGETLists the workspace's postcard return addresses, the default first, with whether USPS validated each.

Setting, 2 operations

get_mail_settingsGet mail settingsGETReturns the workspace mail defaults for new campaigns: postcard size, sender name, minimum days between mailings to one contact, QR code URL and signature image URL.
update_mail_settingsUpdate mail settingsPATCHChanges one or more workspace mail defaults (postcard size, sender name, contact frequency limit, QR code URL, signature image URL). Fields left out are not changed.

Account, 1 operation

get_accountGet accountGETReturns the DealMachine organization (id, name, slug), the calling user's id and auth type, and the plan with its data-credit caps, remaining credits and billing cycle dates.

Activity, 1 operation

list_prospect_activityList prospect activityGETLists everything that happened to a prospect's record, newest first: lifecycle changes, notes, tags, files, lists, mail, CRM and driving events, with who did it.

Activity id, 1 operation

get_activityGet activityGETReturns one activity record (a past search, enrichment or export) with its full original request, a result and credit summary, and the property and person ids it returned, paginated.

Address, 1 operation

enrich_by_addressEnrich by addressPOSTLooks up properties by street address (up to 250) and returns property data. Set contact_audience to also get contacts (names, phones, emails). Spends 1 property credit per match plus 1 people credit per contact.

Analytic, 1 operation

get_campaign_analyticsGet campaign analyticsGETReturns delivery and engagement totals for one campaign: recipients, sent, delivered, bounced, responses, delivery rate and response rate.

Apn, 1 operation

enrich_by_apnEnrich by apnPOSTLooks up properties by Assessor's Parcel Number (up to 250), optionally within a state, county or ZIP. Set contact_audience to also get contacts (names, phones, emails). Spends 1 property credit per match plus 1 people credit per contact.

Autocomplete, 1 operation

autocomplete_addressesAutocomplete addressesGETSuggests up to 10 US street addresses from DealMachine property data for a partial address, each with its DealMachine property id and normalized city or county.

Balance, 1 operation

get_wallet_balanceGet wallet balanceGETReturns the mail wallet balance in cents: balance, available amount, pending charges, lifetime credits and spend, and the auto-reload settings.

Build, 1 operation

build_listBuild listPOSTAdds the records matching the given filters and locations to an existing list in the background; records already on it stay. The list comes back building: poll get_list until status is completed.

By record, 1 operation

get_prospect_by_recordGet prospect by recordGETReturns the prospect that tracks a given property, person or company record, if there is one.

Check, 1 operation

check_prospectsCheck prospectsPOSTSays, for up to 500 record ids, which are prospects and in which lifecycle. Use it to avoid duplicate adds.

Comp, 1 operation

find_comparable_propertiesFind comparable propertiesPOSTFinds comparable sales and active listings around up to 25 subject properties (by default within 1 mile), with match scores, summary statistics and value estimates. Spends 1 property credit per subject found.

Cost estimate, 1 operation

estimate_campaign_costEstimate campaign costGETEstimates the cost of launching a campaign: recipient count, price per card, total and pay-now cost, and whether the wallet balance covers it. Nothing is charged.

Default, 1 operation

set_default_return_addressSet default return addressPOSTMakes a saved return address the organization's default.

Delivery, 1 operation

list_webhook_deliveriesList webhook deliveriesGETLists one webhook's deliveries, newest first: status, attempts, response code and time, and any error. Filter by status, event type or time.

Delivery id, 1 operation

get_webhook_deliveryGet webhook deliveryGETReturns one webhook delivery with the full event payload sent or to be sent. Payloads include prospects' phones and emails when the webhook opted in to contacts.

Dnc, 1 operation

check_dnc_statusCheck dnc statusPOSTChecks up to 1,000 phone numbers against the Do Not Call registry and returns DNC status, line type and carrier for each. Spends 1 credit per matched number.

Download, 1 operation

get_prospect_file_urlGet prospect file urlGETReturns a signed download URL, valid 5 minutes, for one file attached to a prospect.

Email, 1 operation

enrich_by_emailEnrich by emailPOSTLooks up people by email address (up to 250) and returns personal data: names, phone numbers, emails, home address and, on request, their properties. Spends 1 people credit per matched person.

End, 1 operation

end_campaignEnd campaignPOSTEnds a ready, active or paused campaign for good: unsent mail stops, no properties can be added and it cannot be resumed. Printed pieces still deliver. A draft cannot be ended: use cancel_campaign.

Estimate, 1 operation

estimate_adding_campaign_propertiesEstimate adding campaign propertiesGETPreviews what adding N properties to a campaign would cost: the charge due today, the amount charged later, and whether the wallet or auto-reload covers it. Nothing is added or charged.

Event, 1 operation

list_webhook_event_typesList webhook event typesGETLists every event type a webhook can subscribe to, with its description, data fields and an example body.

Field, 1 operation

list_fieldsList fieldsGETLists the fields property or person records can return (field_id, type, group, filterable, sortable, billing category). Pass field ids in the fields parameter of searches, lookups and exports.

Filter, 1 operation

list_filtersList filtersGETLists the filters searches accept (filter_id, type, options, allowed operators, premium flag) for properties or people, for the filters parameter of searches, counts, exports and lists.

Import, 1 operation

import_list_recordsImport list recordsPOSTAdds DealMachine property or person ids to a list in the background, matching the list's source type; records already on it stay. Poll get_list until status is completed.

Location, 1 operation

search_locationsSearch locationsGETSearches US states, counties, cities and ZIP codes by name and returns their codes (state abbreviation, county FIPS, city place id, ZIP) for the locations parameter. Spends no credits.

Location id, 1 operation

get_locationGet locationGETReturns one location (state, county, city or ZIP code) by its location id, with its code, name, state and property count. Spends no credits.

Name, 1 operation

enrich_by_nameEnrich by namePOSTFinds people by name (up to 250 names, optionally within a location) and returns personal data: phones, emails, home address. Spends 1 people credit per returned person; estimate_cost=true previews it free.

Pause, 1 operation

pause_campaignPause campaignPOSTPauses an active campaign, or a ready one that accepts properties. Mail already submitted for printing is still delivered; properties added while paused wait at step 1.

Person, 1 operation

get_personGet personGETReturns one person by DealMachine person id with personal contact data: phones (with DNC flags), emails, home address and, on request, their properties. Spends 1 people credit unless enrich is false.

Phone, 1 operation

enrich_by_phoneEnrich by phonePOSTLooks up people by phone number (up to 250) and returns personal data: names, phone numbers, emails, home address and, on request, their properties. Spends 1 people credit per matched person.

Plan, 1 operation

list_workspace_plansList workspace plansGETLists the plans this workspace can buy, with prices, included data credits, features and seats, plus what the free tier allows. Buying a plan is not possible through this integration.

Pricing, 1 operation

get_mail_pricingGet mail pricingGETReturns postcard prices for the workspace plan, in cents per postcard by size, with the volume bands, current usage and billing cycle.

Recipient, 1 operation

list_campaign_recipientsList campaign recipientsGETLists the recipients enrolled in a campaign with their name, mailing address, delivery status and current step. Recipients are real property owners or residents.

Redeliver, 1 operation

redeliver_webhook_deliveryRedeliver webhook deliveryPOSTQueues one delivery to be sent again, or every delivery after a time when delivery_id is all and since is set. Returns how many were requeued.

Reorder, 1 operation

reorder_tagsReorder tagsPOSTSets the display order of workspace tags: the listed ids first, in that order; unlisted tags keep their order after them.

Resume, 1 operation

resume_campaignResume campaignPOSTResumes a paused campaign so its postcards go out again; pieces are charged to the mail wallet as they are sent. An ended campaign cannot be resumed.

Reverse geocode, 1 operation

enrich_by_coordinatesEnrich by coordinatesPOSTFinds the closest property within 300 feet of each latitude/longitude pair (up to 250). Set contact_audience to also get contacts (names, phones, emails). Spends 1 property credit per match plus 1 people credit per contact.

Send, 1 operation

launch_campaignLaunch campaignPOSTLaunches a draft campaign: checks the mail wallet, enrolls the recipients and starts printing and mailing physical postcards, charged to the wallet. Fails with 402 when the wallet cannot cover it.

Subscription, 1 operation

get_subscriptionGet subscriptionGETReturns the subscription status, plan, trial state and billing cycle, with the plan's data-credit and AI-credit caps.

Summary, 1 operation

get_mail_analytics_summaryGet mail analytics summaryGETReturns account-wide mail totals (sent, delivered, failed, opens, unique openers, average open rate) and a page of campaigns with their engagement, optionally for campaigns launched in a date range.

Test, 1 operation

test_webhookTest webhookPOSTSends one signed ping event to the webhook's URL now and returns whether it succeeded, the HTTP status, response time and a response excerpt.

Timesery, 1 operation

get_mail_analytics_timeseriesGet mail analytics timeseriesGETReturns a day-by-day or week-by-week series for one mail metric (sent, delivered, scans or open_rate) over the last N days or a date range, with empty buckets filled with zeroes.

Transaction, 1 operation

list_wallet_transactionsList wallet transactionsGETLists mail wallet transactions (purchases, spends, refunds, adjustments, expirations, bonuses, auto reloads) with amounts in cents and the balance after each.

Usage, 1 operation

get_credit_usageGet credit usageGETReturns data-credit usage for the current billing cycle: included, used and remaining credits (monthly and additional), overage, and a breakdown by entity type.

Webhook, 1 operation

list_webhooksList webhooksGETLists the workspace's webhook subscriptions: URL, event types, batch size, contact opt-in, active state and delivery health. include_zapier=true also lists the Zapier app's.

Showing the first 120 of 122 endpoints. The rest are in the product, searchable from the workflow builder and from chat.

Use DealMachine from Claude Code, Cursor or Codex

Connect DealMachine in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its DealMachine operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect DealMachine

Create your workspace
Sign up free. Nothing to install.
Connect DealMachine once
Add your DealMachine connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.