Give your AI agent 798,511 licensed contractors

Connect Claude, Cursor, or any MCP client to live state-board license data across 28 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.