contractorroster

Tools

Token cost is the o200k count of the tools list JSON, including schemas, before any tool is called.

• list_states

  List supported US states with their available geo types and per-trade availability. Free; no auth required.

• list_trades

  List supported trade codes with display names. Free; no auth required.

• count_contractors

  Count contractors matching a state × trade × geo query, without charging. Use to qualify a query before calling search_contractors. Returns total count and estimated cost in cents at the caller's pric

• search_contractors

  Fetch enriched contractor records for a state × trade × geo query. Charges the partner balance at price_per_record_cents × records_delivered. Set dry_run:true for a free cost preview. Returns structur

• get_usage

  Return the partner's current balance, pricing, and the 20 most recent transactions (top-ups + api calls). No charge.