license-verify

Verifica la licencia, fianza y seguro de un contratista de EE. UU. a partir de datos oficiales estatales — pagadero por el agente, pago por éxito, nativo de MCP. WA en vivo, CA en beta.

GitHub

Documentación

Verificación de Licencia de Contratista + Fianza + Seguro (MCP, pagadero por agente)

La única verificación nativa de MCP que devuelve FIANZA + SEGURO oficiales de datos estatales — no solo estado activo/inactivo. Pago por éxito: $0.03 resultado completo, $0.01 solo estado, GRATIS si no hay coincidencia. WA en vivo (L&I oficial), CA beta (CSLB).

Herramientas: verify_license, list_supported_jurisdictions.

Inicio rápido

// Call
{ "tool": "verify_license", "jurisdiction": "WA", "license_number": "ECOSTSC758NN" }

// Response (abridged)
{
  "found": true,
  "result": {
    "status": "active",
    "bonded":  { "is_bonded": true, "details": "Surety: NORTH RIVER INSURANCE COMPANY THE; Amount: $30,000" },
    "insured": { "has_insurance": true, "details": "Carrier: State National Ins Co Inc; Coverage: $1,000,000" }
  }
}

Resultado	Precio
Completo (estado + fianza + seguro)	$0.03
Solo estado (sin coincidencia de fianza/seguro, o `statusOnly: true`)	$0.01
Sin coincidencia (`found: false`)	GRATIS

Jurisdicciones

Estado	Estado	Fuente	Fianza + Seguro
WA	✅ En vivo	Datos abiertos de WA L&I (data.wa.gov)	✅ Datos reales (conjuntos de datos bzff-4fmt + ciwg-agsx)
CA	⚠️ Beta	HTML de CSLB (cslb.ca.gov)	✅ Analizado cuando CSLB está disponible

Washington es la jurisdicción confiable y lista para producción. Los datos abiertos oficiales de WA L&I se sirven mediante JSON de Socrata — sin scraping, sin límites de tasa, datos de fianza y seguro incluidos de conjuntos de datos dedicados.

California está en beta. CSLB no publica una API abierta; el proveedor obtiene la página de detalle HTML directamente. CSLB limita la tasa o devuelve 503 a solicitudes automatizadas de forma intermitente. Cuando no está disponible, verify_license devuelve un SESSION_ERROR limpio — nunca se le cobra por fallas de la fuente. No confíe en CA para flujos de trabajo de producción hasta que se confirme una ejecución estable de CSLB del lado del servidor.

Actor de Apify

Elegible para pagos agénticos — precios por evento + permisos limitados + sin modo Standby.

Precios

Evento	Precio
`license-verification`	$0.03 — resultado completo (estado + fianza + seguro)
`status-only-result`	$0.01 — estado encontrado, sin coincidencia de fianza/seguro (o `statusOnly: true`)

Se cobra solo en found: true. Errores de validación, resultados no encontrados y fallas de fuente no se cobran.

Entrada

{
  "jurisdiction": "WA",
  "license_number": "ECOSTSC758NN"
}

Campo	Tipo	Requerido	Notas
`jurisdiction`	`"WA" \| "CA"`	✅	WA = en vivo; CA = beta
`license_number`	string	uno de ↓	WA: alfanumérico. CA: numérico, ≤8 dígitos
`business_name`	string	uno de ↑	Solo WA. Coincidencia parcial, puede devolver `matches[]`

Salida (conjunto de datos predeterminado)

{
  "found": true,
  "jurisdiction": "WA",
  "query": { "license_number": "ECOSTSC758NN" },
  "result": {
    "license_number": "ECOSTSC758NN",
    "business_name": "!ECO STAR C G CONSTRUCTION LLC",
    "status": "active",
    "license_type": "CONSTRUCTION CONTRACTOR",
    "bonded": {
      "is_bonded": true,
      "details": "Surety: NORTH RIVER INSURANCE COMPANY THE; Bond #: 46CF842686; Amount: $30,000; Effective: 2025-08-05; Expires: Until Canceled"
    },
    "insured": {
      "has_insurance": true,
      "details": "Carrier: State National Ins Co Inc; Policy: NXT9PTHTLT-01-GL; Coverage: $1,000,000; Agency: Next Insurance Inc; Effective: 2026-06-12; Expires: 2027-06-12"
    },
    "effective_date": "2025-08-15",
    "expiration_date": "2027-08-15"
  },
  "source_url": "https://data.wa.gov/resource/m8qx-ubtq",
  "retrieved_at": "2026-06-26T01:34:37.598Z",
  "raw": { ... }
}

status es siempre uno de: active | expired | suspended | revoked | unknown.

En caso de falla: { "found": false, "error": "SESSION_ERROR|NETWORK_ERROR|...", "message": "..." } — nunca un bloqueo, nunca un cargo.

Prueba local

npm install
npm run build
echo '{"jurisdiction":"WA","license_number":"ECOSTSC758NN"}' \
  > storage/key_value_stores/default/INPUT.json
npx apify run

Servidor MCP (stdio)

Para usar con Claude Desktop, Smithery o cualquier agente compatible con MCP.

Herramientas

verify_license — verifica el estado de licencia de un contratista.

jurisdiction (requerido): "WA" o "CA"
license_number y/o business_name (al menos uno requerido)

list_supported_jurisdictions — lista todos los estados con su estado y fuente de datos.

Configuración (Claude Desktop)

{
  "mcpServers": {
    "license-verify": {
      "command": "node",
      "args": ["/absolute/path/to/license-verify-mcp/dist/index.js"]
    }
  }
}

Ejecución

npm install && npm run build
npm run start:mcp   # stdio MCP server
npm run smoke       # hit real WA + CA endpoints, must be 8/8 PASS

Agregar un Estado

Cree src/providers/<CODE>.ts implementando la interfaz Provider ({ info, verify() })
Regístrelo en src/providers/index.ts

No se necesitan otros cambios en el servidor o Actor.

Licencia

MIT