contractor-license-mcp-server

Verificación de licencias de contratistas en tiempo real en 45 estados de EE. UU. Un servidor MCP que permite a Claude Desktop, Cursor y cualquier agente de IA compatible con MCP verificar la licencia, el estado, la fecha de caducidad y el historial disciplinario de un contratista directamente en los portales de las juntas de licencias estatales.

Envíe {state, license_number, trade} y obtenga la validez, el nombre del titular, la fecha de caducidad, el estado y cualquier acción disciplinaria registrada. Los resultados se obtienen en vivo desde los portales estatales oficiales (sin exportaciones nocturnas obsoletas) y se almacenan en caché durante 24 horas cuando están activos.

Por qué este servidor

• 45 estados cubiertos a través de portales oficiales de juntas de licencias estatales, no agregadores de datos de terceros

• Consultas en vivo: cada verificación accede al portal oficial, por lo que las fechas de caducidad y las acciones disciplinarias están tan actualizadas como los propios datos de la junta

• Verificación por lotes: hasta 25 licencias por llamada, ejecutadas en paralelo

• Historial disciplinario: se devuelve cuando el portal lo expone

• Respaldado por TradesAPI, una API HTTP alojada a la que también puede acceder directamente

Inicio rápido

Claude Desktop

Agregue esto a su configuración de Claude Desktop:

• 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"
      }
    }
  }
}

Reinicie Claude Desktop después de guardar.

Obtención de una clave API

1. Vaya a www.tradesapi.com y haga clic en Sign up free (Registrarse gratis)

2. Ingrese su correo electrónico: recibirá un enlace mágico

3. Haga clic en el enlace y llegará a su panel de control, donde le espera su clave API

Las cuentas nuevas comienzan con 50 créditos de verificación gratuitos, sin necesidad de tarjeta de crédito. Puede comprar paquetes de crédito adicionales desde el panel de control cuando necesite más.

Instalación directa

npm install -g contractor-license-mcp-server

Herramientas

clv_verify_license

Verifica una licencia de contratista individual en un portal de una junta de licencias estatal.

Resultado de ejemplo:

## License Verification: VALID

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

clv_batch_verify

Verifica hasta 25 licencias en una sola llamada. Cada verificación se ejecuta de forma independiente: los fallos parciales no bloquean el lote.

clv_list_supported_states

Enumera todos los estados admitidos, incluidas las URL de los portales y los oficios disponibles. Úselo para ver qué estados y oficios puede consultar.

Estados admitidos

La cobertura se expande continuamente. Ejecute clv_list_supported_states desde su agente para obtener la lista actual, o consulte la cuadrícula de estados en vivo en www.tradesapi.com.

Configuración

Créditos

Cada verificación de licencia consume 1 crédito, independientemente de si el resultado es nuevo o está en caché. Las cuentas nuevas reciben 50 créditos gratuitos. Se pueden comprar paquetes de crédito adicionales desde el panel de control en www.tradesapi.com.

Desarrollo

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

Licencia

MIT