com.contractorroster/contractorroster

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Verified US licensed-contractor data: 879k+ state-board records, metered per record, free discovery.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "contractorroster": {
      "url": "https://contractorroster.com/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (5)

• list_states

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_trades

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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 price tier.

  Parameters:

  • state (required) — string
  • trade (required) — string
  • geo_type (required) — string
  • geo_value (required) — string
  • active_only — boolean

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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 structured shortfall info on insufficient balance so the agent can prompt the user to top up.

  Parameters:

  • state (required) — string
  • trade (required) — string
  • geo_type (required) — string
  • geo_value (required) — string
  • limit — integer
  • dry_run — boolean
  • active_only — boolean

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_usage

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.