contractor-license-mcp-server

Echtzeit-Überprüfung von Auftragnehmerlizenzen in 45 US-Bundesstaaten. Ein MCP-Server, der es Claude Desktop, Cursor und jedem MCP-kompatiblen KI-Agenten ermöglicht, die Lizenz, den Status, das Ablaufdatum und die Disziplinarhistorie eines Auftragnehmers direkt über die Portale der staatlichen Lizenzbehörden zu überprüfen.

Senden Sie {state, license_number, trade} — und erhalten Sie Gültigkeit, Namen des Lizenznehmers, Ablaufdatum, Status und alle vorliegenden Disziplinarmaßnahmen zurück. Die Ergebnisse werden live von offiziellen staatlichen Portalen abgerufen (keine veralteten nächtlichen Exporte) und bei Aktivität für 24 Stunden zwischengespeichert.

Warum dieser Server

• 45 Bundesstaaten abgedeckt über offizielle Portale der staatlichen Lizenzbehörden, keine Daten-Aggregatoren von Drittanbietern

• Live-Abfragen — jede Überprüfung greift auf das maßgebliche Portal zu, sodass Ablaufdaten und Disziplinarmaßnahmen so aktuell sind wie die Daten der Behörde selbst

• Stapelverarbeitung — bis zu 25 Lizenzen pro Aufruf, parallel ausgeführt

• Disziplinarhistorie — wird zurückgegeben, wenn das Portal sie bereitstellt

• Unterstützt durch TradesAPI, eine gehostete HTTP-API, die Sie auch direkt ansprechen können

Schnellstart

Claude Desktop

Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration hinzu:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tradesapi": {
      "command": "npx",
      "args": ["-y", "contractor-license-mcp-server"],
      "env": {
        "CLV_API_URL": "https://www.tradesapi.com",
        "CLV_API_KEY": "your-api-key-here"
      }
    }
  }
}

Starten Sie Claude Desktop nach dem Speichern neu.

Erhalt eines API-Schlüssels

1. Gehen Sie zu www.tradesapi.com und klicken Sie auf Sign up free

2. Geben Sie Ihre E-Mail-Adresse ein — Sie erhalten einen Magic Link

3. Klicken Sie auf den Link und gelangen Sie zu Ihrem Dashboard, wo Ihr API-Schlüssel auf Sie wartet

Neue Konten beginnen mit 50 kostenlosen Verifizierungsguthaben, keine Kreditkarte erforderlich. Sie können bei Bedarf zusätzliche Guthabenpakete über das Dashboard erwerben.

Direkte Installation

npm install -g contractor-license-mcp-server

Tools

clv_verify_license

Überprüft eine einzelne Auftragnehmerlizenz bei einem Portal einer staatlichen Lizenzbehörde.

Beispielergebnis:

## License Verification: VALID

| Field      | Value                    |
|------------|--------------------------|
| Name       | ANDERSON, ORIN RAE       |
| License #  | TACLA00000103C           |
| State      | TX                       |
| Trade      | hvac                     |
| Status     | Active                   |
| Expiration | 05/12/2026               |

clv_batch_verify

Überprüft bis zu 25 Lizenzen in einem einzigen Aufruf. Jede Überprüfung läuft unabhängig — Teilfehler blockieren den Stapel nicht.

clv_list_supported_states

Listet alle unterstützten Bundesstaaten auf, einschließlich Portal-URLs und verfügbarer Gewerke. Verwenden Sie dies, um zu sehen, welche Bundesstaaten und Gewerke Sie abfragen können.

Unterstützte Bundesstaaten

Die Abdeckung wird kontinuierlich erweitert. Führen Sie clv_list_supported_states von Ihrem Agenten aus, um die aktuelle Liste zu erhalten, oder sehen Sie sich das Live-Raster der Bundesstaaten unter www.tradesapi.com an.

Konfiguration

Guthaben

Jede Lizenzüberprüfung verbraucht 1 Guthaben, unabhängig davon, ob das Ergebnis neu oder zwischengespeichert ist. Neue Konten erhalten 50 kostenlose Guthaben. Zusätzliche Guthabenpakete können über das Dashboard unter www.tradesapi.com erworben werden.

Entwicklung

git clone https://github.com/jackunderwood/Contractor-License-Verification.git
cd Contractor-License-Verification/mcp-server
npm install
npm run build
npm test

Lizenz

MIT