LeO — Prospect Intelligence

Start an async contact-enrichment job. To enrich the exact prospects you got from search_prospects, pass their IDs as one filter group per prospect — filters: [{ prospectId: <id1> }, { prospectId: <id2> }] — so enrichment targets those companies instead of re-deriving name/attribute filters (which can match unrelated companies). Reserves 1 credit per prospect upfront (max 100); only rows that yield a contact with a usable email are billed (the rest are refunded). Returns a taskId — poll with get_enrichment_job until completed. When enriching by attributes rather than IDs, use narrow filters for better match rates. Note: the returned contacts include phone-only contacts (officers, Form 5500 signatories, etc.) that have no email — a prospect with such a roster but no discoverable email comes back with enrichmentStatus "no_email" (i.e. not billed) yet still lists those contacts.

enrich_prospects

Return account details for the authenticated user: email, tenant ID, and plan entitlements (API access, MCP access).

get_account_info

Check available credits, reserved amount, and plan type. Use only when the user explicitly asks about their balance — do not call this on your own before enrich_prospects; insufficient-credit cases are reported automatically when enrichment runs.

get_credit_balance

Fetch full firmographic and insurance intelligence for one prospect by numeric ID. Returns the same field set as search_prospects, including benefitsRedFlags and dotRedFlags (transportation triggers) descriptions when a flag is triggered, and insurance.dot intrastate/interstate when entitled.

get_prospect

List all available search filter fields, types, and allowed values from the LeO API. Call before search_prospects to discover filters.

get_filter_schema

Poll a contact-enrichment job by taskId. Call every 15–30s until status is "completed" or "failed". Completed response includes per-prospect enrichmentStatus, one of: "enriched" (at least one contact with a usable email was found — billed), "no_email" (no contact with a usable email was found — NOT billed, but any known contacts on file, e.g. phone-only officers or Form 5500 signatories, are still returned in `contacts`), or "failed" (enrichment error). Only "enriched" rows are billed.

get_enrichment_job

Search 7M+ US business prospects using 120+ filters (industry, revenue, location, insurance, OSHA, DOT, IRS, 38 Benefits Red Flags, 42 DOT Red Flags (Transportation Triggers), Intrastate/Interstate). Returns paginated firmographic/insurance intelligence including Red Flag risk indicators and explanations when entitled. Call get_filter_schema first to discover available filters.

search_prospects