Give your AI agent 776,999 licensed contractors

Connect Claude, Cursor, or any MCP client to live state-board license data across 25 states. Your agent counts contractors in any city or ZIP for free. When you want the records — phone, email, license number — it pulls them for under a dime each.

1. Get an API key

Emailed in under a minute. The key works immediately for free lookups — no card, no call.

2. Connect your client

Claude Code

claude mcp add --transport http contractorroster https://contractorroster.com/api/mcp \
  --header "Authorization: Bearer cr_live_YOUR_KEY"

Claude Desktop, Cursor, and other MCP clients

{
  "mcpServers": {
    "contractorroster": {
      "url": "https://contractorroster.com/api/mcp",
      "headers": {
        "Authorization": "Bearer cr_live_YOUR_KEY"
      }
    }
  }
}

Streamable HTTP transport, stateless — no session setup. Tool discovery works without a key; only search_contractors requires one.

3. Ask for contractors

“How many roofers are licensed around Phoenix?” → your agent calls count_contractorsand answers with the real state-board number. “Pull the top 200 with phone and email” → search_contractors delivers the records.

Tool	Cost	What it does
list_states	Free, no key	Covered states with their available trades and geo types.
list_trades	Free, no key	The 17 trade codes with display names.
count_contractors	Free	Count matches for a state × trade × city/ZIP query, with the exact cost to pull them.
search_contractors	Per record	Enriched records — phone, email, license number, address. Debits your prepaid balance; dry_run previews cost.
get_usage	Free	Balance, price tier, and your 20 most recent transactions.

Pricing

Records cost 10¢ each, debited from a prepaid balance. Top up from $50 via Stripe — your agent gets the checkout link itself when the balance runs short. Counting and discovery are always free.

Every record traces to a state license board, so your buyers can verify any contractor against the public registry. Volume pricing for resellers: partner program.

Prefer plain REST? The same key works on the HTTP API.