license-verify

Verificação de Licença de Contratante + Fiança + Seguro (MCP, pagável por agente)

A única verificação de licença nativa MCP que retorna FIANÇA OFICIAL + SEGURO a partir de dados estaduais — não apenas status ativo/inativo. Pague por sucesso: $0,03 resultado completo, $0,01 apenas status, GRÁTIS em erro. WA ativo (L&I oficial), CA beta (CSLB).

Ferramentas: verify_license, list_supported_jurisdictions.

Início 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	Preço
Completo (status + fiança + seguro)	$0,03
Apenas status (sem correspondência de fiança/seguro, ou statusOnly: true)	$0,01
Erro (found: false)	GRÁTIS

---

Jurisdições

Estado	Status	Fonte	Fiança + Seguro
WA	✅ Ativo	Dados abertos WA L&I (data.wa.gov)	✅ Dados reais (conjuntos de dados bzff-4fmt + ciwg-agsx)
CA	⚠️ Beta	HTML CSLB (cslb.ca.gov)	✅ Analisado quando CSLB está disponível

Washington é a jurisdição confiável e pronta para produção. Os dados abertos oficiais do WA L&I são servidos via JSON Socrata — sem scraping, sem limites de taxa, dados de fiança e seguro incluídos de conjuntos de dados dedicados.

Califórnia está em beta. A CSLB não publica uma API aberta; o provedor busca a página de detalhes HTML diretamente. A CSLB limita a taxa ou retorna 503 para solicitações automatizadas intermitentemente. Quando indisponível, verify_license retorna um SESSION_ERROR limpo — você nunca é cobrado por falhas na fonte. Não dependa da CA para fluxos de trabalho de produção até que uma execução estável do CSLB no servidor seja confirmada.

---

Ator Apify

Elegível para pagamentos agênticos — preço por evento + permissões limitadas + sem modo Standby.

Preços

Evento	Preço
license-verification	$0,03 — resultado completo (status + fiança + seguro)
status-only-result	$0,01 — status encontrado, sem correspondência de fiança/seguro (ou statusOnly: true)

Cobrado apenas em found: true. Erros de validação, resultados não encontrados e falhas na fonte não são cobrados.

Entrada

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

Campo	Tipo	Obrigatório	Observações
jurisdiction	"WA" | "CA"	✅	WA = ativo; CA = beta
license_number	string	um de ↓	WA: alfanumérico. CA: numérico, ≤8 dígitos
business_name	string	um de ↑	Somente WA. Correspondência parcial, pode retornar matches[]

Saída (conjunto de dados padrão)

{
  "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 é sempre um de: active | expired | suspended | revoked | unknown.

Em falha: { "found": false, "error": "SESSION_ERROR|NETWORK_ERROR|...", "message": "..." } — nunca uma falha, nunca uma cobrança.

Teste 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 uso com Claude Desktop, Smithery ou qualquer agente compatível com MCP.

Ferramentas

verify_license — verifica o status da licença de um contratante.

• jurisdiction (obrigatório): "WA" ou "CA"
• license_number e/ou business_name (pelo menos um obrigatório)

list_supported_jurisdictions — lista todos os estados com seu status e fonte de dados.

Configuração (Claude Desktop)

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

Execução

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

---

Adicionando um Estado

1. Crie src/providers/<CODE>.ts implementando a interface Provider ({ info, verify() })
2. Registre-o em src/providers/index.ts

Nenhuma outra alteração é necessária no servidor ou no Ator.

Licença

MIT