Tracerfy

Check Balance

Show the account's available Tracerfy credit balance. Free to call — use it to tell the user how many credits they have before running paid lookups or building a lead list. Returns only the credit balance; don't surface internal usage stats to the user.

Dnc Check

Check a U.S. phone number for calling compliance before you cold-call a lead. Returns whether the number is on the Federal Do-Not-Call registry (`national_dnc`) or a state registry (`state_dnc`, with `state_dnc_list` naming which states), and whether it belongs to a known TCPA litigator (`litigator`), plus `is_clean` (true = no flags, safe to call). Billed per lookup.

Dnc Check Batch

Check 2–15 U.S. phone numbers for DNC/TCPA compliance in one v2 request. Prefer this over repeated `dnc_check` calls when the user supplies multiple numbers. The response stays in input order. For more than 15, submit sequential chunks of at most 15; do not launch chunks concurrently.

Lead Lookup

Build a full lead dossier for a single U.S. address: property details (value, equity, year built, characteristics) plus the owner's skip-traced phones and emails. This endpoint accepts exactly one property per call and has no synchronous batch mode. This is the richer, combined lookup — billed per hit against your Tracerfy credits.

Preview Lead List

Count how many leads match a set of filters BEFORE spending any credits — free to call. `geography` selects the area, e.g. {"mode": "states", "states": ["TX"]} or {"mode": "cities", "cities": [{"city": "Dallas", "state": "TX"}]} or {"mode": "zips", "zips": ["75201"]}. `strategy` is a named preset (call `list_strategies` to see the valid names and their filters) or "custom". `filter_overrides` is a dict of filter key → value, merged on top of the strategy: • Boolean

Execute Lead List

Start building a lead list in the background and return right away. This does NOT return leads immediately — it queues a batch job and returns a `lead_list_id` with a pending status. Billed 5 credits per delivered row, so call `preview_lead_list` first to size it. After calling this: 1) poll `get_lead_list_status(lead_list_id)` until it reports complete, then 2) tell the user the list is ready (with the row count) and ASK whether they want the results — do NOT c

Get Lead List Status

Check the progress of a lead list started with `execute_lead_list`. Returns whether it is still building or complete, plus row counts. Poll this until it reports complete. When it's complete, tell the user (with the row count) and ASK whether they want to see the results — do NOT fetch rows automatically. Free to call.

Get Lead List Rows

Fetch the rows (leads) of a completed lead list, paginated. Call this ONLY after the user has explicitly asked to see or download the results — don't fetch rows on your own right after a list finishes. Each row includes the property details and the owner's contact data. If the list is still building you'll get a "still building" message — check `get_lead_list_status` first. Rows were already billed when the list was executed. `per_page` max is 500.

List Strategies

List the available lead-list strategy presets (probate, vacant, high-equity absentee, tired landlord, pre-foreclosure, and many more) with their labels and default filters, plus the filter keys you can pass in `filter_overrides`. Free to call — use it to pick a valid `strategy` name and valid filter keys for `preview_lead_list` / `execute_lead_list` (those endpoints reject unknown strategy names).

Trace Lookup

Skip trace a U.S. property address and return the owner's name, phone numbers, and emails from our property database. By default it finds the property owner (no name needed). To trace a specific person at the address instead, pass both `first_name` and `last_name`. Billed per hit against your Tracerfy credits — a miss costs nothing.

Trace Lookup Batch

Skip trace 2–15 addresses in one request and return results in input order. Use this instead of making repeated `trace_lookup` calls when the user provides multiple addresses. Each item independently chooses owner discovery (`find_owner=true`) or a named person (`find_owner=false` with first and last name). For more than 15 records, submit sequential chunks of at most 15; do not launch chunks concurrently.

Enhanced Trace Lookup

Find enhanced owner or person context, including possible relatives and address history. For address-only owner discovery, set `find_owner` to true; no name is needed. To target a specific person, leave `find_owner` false and pass both `first_name` and `last_name` with the associated address. Billed per hit against your Tracerfy credits; a miss costs nothing.

Enhanced Trace Lookup Batch

Run 2–15 enhanced owner/person traces in one request, preserving input order. Use this when the user supplies multiple enhanced lookups. Every item may independently use address-only owner discovery or a named-person search. For more than 15 records, submit sequential chunks of at most 15; do not launch chunks concurrently.

Phone Verification

Verify a U.S. phone number and return line/compliance metadata plus light person context.

Phone Verification Batch

Verify 2–15 U.S. phone numbers in one request, preserving input order. Prefer this over repeated `phone_verification` calls when checking multiple numbers. For more than 15, submit sequential chunks of at most 15; do not launch chunks concurrently.

Parcel Lookup

Look up a property owner and their contact info by parcel number (APN), given the county and state. Useful when you have a parcel ID from county records but not a clean mailing address. Billed per hit — a miss costs nothing.

Parcel Lookup Batch

Look up 2–15 parcel owners in one request and return results in input order. Prefer this over repeated `parcel_lookup` calls when the user supplies multiple APNs. For more than 15, submit sequential chunks of at most 15; do not launch chunks concurrently.

Ping

Health check. Returns 'pong' to confirm the Tracerfy MCP server is reachable.