HaulierScope

Verificações de licença de operador no Reino Unido para transportadoras e empresas de ônibus: status, veículos, alterações, audiências públicas. Sem necessidade de login.

Ver em haulierscope.co.uk

Servidor MCP hospedado

npx add-mcp 'https://haulierscope.co.uk/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

API de licenças de operador e servidor MCP

API JSON gratuita e servidor MCP para dados de licenças de operador do Reino Unido (GB): pesquisa, licenças, empresas, alterações e audiências públicas para aplicativos e assistentes de IA.

Fonte: dados de licenças de operador da DVSA, arquivo datado de 7 de outubro de 2026 (https://www.data.gov.uk/dataset/2a67d1ee-8f1b-43a3-8bc6-e8772d162a3c/traffic-commissioners-goods-and-public-service-vehicle-operator-licence-records).

Desenvolvedores e assistentes de IA

Consulte qualquer licença de operador de veículos de mercadorias ou PSV do Reino Unido (GB) a partir do seu próprio código ou de um assistente de IA. A API JSON e o servidor MCP são gratuitos, não exigem chave e retornam os mesmos registros deste site, com a data do arquivo da DVSA e a fonte em cada resultado.

Resumo

Servidor MCP (Streamable HTTP) https://haulierscope.co.uk/mcp
API JSON https://haulierscope.co.uk/api/v1
OpenAPI 3.1 https://haulierscope.co.uk/openapi.json
Dados: arquivo DVSA datado de 7 de outubro de 2026

Os dados são o arquivo de licenças de operador que a DVSA publica como dados abertos, lido sempre que a DVSA publica um novo arquivo (geralmente semanalmente), com contexto da Companies House, do reconhecimento de mérito da DVSA e dos Comissários de Tráfego. Leia a metodologia para saber o que cada campo significa e o status dos dados para a data de cada fonte.

Servidor MCP

O Model Context Protocol (MCP) permite que um assistente de IA chame ferramentas em outro serviço. Nosso servidor MCP dá a assistentes como Claude, ChatGPT, Cursor e VS Code acesso direto e estruturado aos dados de licenças de operador. Faça uma pergunta em linguagem simples, por exemplo "A licença OF2071131 é válida e quantos veículos ela autoriza?", e o assistente chama a ferramenta certa e cita a data do arquivo da DVSA.

Endereço: https://haulierscope.co.uk/mcp
Transporte: Streamable HTTP. Cada solicitação é respondida com JSON; não há sessões para gerenciar.
Login: nenhum. Todas as ferramentas são somente leitura.
Cartão do servidor: https://haulierscope.co.uk/mcp/server-card

Conecte seu assistente

Claude Code

claude mcp add --transport http haulierscope https://haulierscope.co.uk/mcp

Adicione --scope user para usar em todos os projetos, ou --scope project para compartilhar via .mcp.json.

Claude (claude.ai e Claude Desktop)

Abra Configurações, depois Conectores, e escolha Adicionar conector personalizado. Nomeie-o como HaulierScope, cole https://haulierscope.co.uk/mcp como URL e escolha sem login. Nos planos Team e Enterprise, um proprietário adiciona o conector para a organização primeiro.

Cursor

Adicione HaulierScope ao Cursor, ou adicione isto a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "haulierscope": {
      "url": "https://haulierscope.co.uk/mcp"
    }
  }
}

VS Code (GitHub Copilot)

Adicione HaulierScope ao VS Code, ou adicione isto a .vscode/mcp.json:

{
  "servers": {
    "haulierscope": {
      "type": "http",
      "url": "https://haulierscope.co.uk/mcp"
    }
  }
}

ChatGPT

Ative o modo de desenvolvedor (Configurações, depois Segurança e login) e adicione um novo conector com a URL https://haulierscope.co.uk/mcp e sem autenticação. O servidor também tem as ferramentas search e fetch que a pesquisa aprofundada usa.

OpenAI Codex, Gemini CLI e outros

codex mcp add haulierscope --url https://haulierscope.co.uk/mcp
gemini mcp add --transport http haulierscope https://haulierscope.co.uk/mcp

Qualquer cliente que suporte servidores MCP remotos via Streamable HTTP pode usar o mesmo endereço. Clientes mais antigos podem fazer a ponte com npx mcp-remote https://haulierscope.co.uk/mcp.

Teste a partir de um terminal

npx @modelcontextprotocol/inspector --cli https://haulierscope.co.uk/mcp --transport http --method tools/list
npx @modelcontextprotocol/inspector --cli https://haulierscope.co.uk/mcp --transport http \
  --method tools/call --tool-name get_licence --tool-arg licence_number=OF2071131

Ferramentas MCP

Toda ferramenta é somente leitura e retorna conteúdo estruturado com um esquema de saída publicado, além do mesmo JSON como texto.

Ferramenta	Argumentos	O que retorna
`search_operators`	`query, filters?, limit?`	Encontra operadores por nome da empresa, número da licença ou número da empresa. Filtros: área de tráfego, mercadorias ou PSV, status, tipo de licença, no arquivo mais recente.
`get_licence`	`licence_number`	O registro completo de uma licença: titular, tipo, status, veículos, reboques, data de continuação, centros operacionais, status na Companies House, reconhecimento de mérito, audiências públicas, decisões e histórico de alterações.
`get_company`	`company_number`	Todas as licenças de uma empresa, com totais e contexto da Companies House, Gazette e Comissários de Tráfego.
`area_stats`	`area`	Licenças, operadores, veículos, mix de licenças, maiores operadores e cidades para uma das oito áreas de tráfego.
`recent_changes`	`release?, area?, change_type?, limit?, offset?`	O que mudou entre um arquivo da DVSA e o anterior, com valores antes e depois.
`upcoming_public_inquiries`	`area?`	Audiências públicas que os Comissários de Tráfego listaram para empresas, com data, local, fundamentos e o aviso oficial.
`insolvency_watch`	`area?, limit?`	Titulares de licença que a Companies House mostra em liquidação, administração ou recepção judicial, com avisos de insolvência na Gazette.
`filing_watch`	`area?, limit?`	Titulares de licença cujas contas estavam atrasadas na data do registro da Companies House.
`new_licences`	`month?, area?, limit?`	Novas licenças de operador concedidas em um mês, a partir dos boletins semanais dos Comissários de Tráfego.
`licences_ended`	`month?, area?, limit?`	Licenças publicadas como revogadas, renunciadas ou encerradas em um mês, com o título oficial e o boletim de cada uma.
`tc_decisions`	`area?, outcome?, limit?`	Decisões regulatórias dos Comissários de Tráfego, com resultado, datas, status de recurso e o documento de decisão.
`biggest_operators`	`kind, area?`	As maiores empresas de transporte rodoviário ou operadores de ônibus e vans por veículos autorizados, nacionalmente ou em uma área de tráfego.
`data_status`	`none`	A data e a idade de cada fonte, e todos os arquivos da DVSA que possuímos.
`search, fetch`	`query / id`	O par de busca-e-busca que a pesquisa aprofundada do ChatGPT e o conhecimento da empresa usam. fetch retorna a versão Markdown de uma página.

API JSON

Solicitações HTTPS GET simples, respostas JSON, sem chave. A descrição completa está em openapi.json (OpenAPI 3.1), que geradores de código e ferramentas de API podem ler diretamente.

Solicitação	Retorna
`GET /api/v1/search?q=wincanton`	Pesquisa por nome, número da licença ou número da empresa. Opcional: área, categoria, status, licence_type, in_current_file, limit.
`GET /api/v1/licences/{licence_number}`	Uma licença.
`GET /api/v1/companies/{company_number}`	Uma empresa e todas as suas licenças.
`GET /api/v1/areas`	As oito áreas de tráfego com contagens de licenças e veículos.
`GET /api/v1/areas/{area}`	Estatísticas para uma área de tráfego (slug, letra ou nome).
`GET /api/v1/changes?release=YYYY-MM-DD`	Alterações em um arquivo da DVSA. Opcional: área, tipo, limit, offset.
`GET /api/v1/public-inquiries?area=scotland`	Próximas audiências públicas para empresas.
`GET /api/v1/insolvency-watch?area=wales`	Titulares de licença em liquidação, administração ou recepção judicial, com avisos da Gazette.
`GET /api/v1/filing-watch?area=wales`	Titulares de licença com contas atrasadas na Companies House.
`GET /api/v1/new-licences?month=YYYY-MM`	Novas licenças de operador concedidas em um mês. Opcional: área, limit.
`GET /api/v1/licences-ended?month=YYYY-MM`	Licenças revogadas, renunciadas ou encerradas em um mês, na redação oficial. Opcional: área, limit.
`GET /api/v1/tc-decisions?area=wales`	Decisões dos Comissários de Tráfego. Opcional: resultado, limit.
`GET /api/v1/rankings/haulage-companies?area=wales`	Maiores operadores por veículos autorizados (empresas de transporte rodoviário ou operadores de ônibus e vans).
`GET /api/v1/earned-recognition?area=wales`	Operadores com reconhecimento de mérito da DVSA, por área de tráfego.
`GET /api/v1/status`	Datas das fontes e os arquivos da DVSA que possuímos.

curl https://haulierscope.co.uk/api/v1/licences/of2071131

Um número de licença tem duas letras e sete dígitos. A primeira letra é O para veículos de mercadorias ou P para ônibus e vans; a segunda letra é a área de tráfego. Maiúsculas ou minúsculas funcionam.

O que toda resposta contém

Toda resposta da API e todo resultado de ferramenta MCP carrega source, file_date (a data do arquivo da DVSA que os dados descrevem), canonical_url (a página neste site), markdown_url e attribution. Cite a data do arquivo e vincule a URL canônica ao exibir os dados.

{
  "source": "DVSA operator licence data (Traffic Commissioners' goods and public service vehicle operator licence records)",
  "file_date": "2026-10-07",
  "canonical_url": "https://haulierscope.co.uk/licence/of2071131",
  "markdown_url": "https://haulierscope.co.uk/licence/of2071131.md",
  "attribution": "Contains public sector information licensed under the Open Government Licence v3.0. Contains Companies House data.",
  "data": {
    "licence_number": "OF2071131",
    "licence_type": "Standard International",
    "status": "valid",
    "in_current_file": true,
    "vehicles_authorised": 2641,
    "trailers_authorised": 3497,
    "continuation_date": "2029-01-31",
    "holder": {
      "type": "company",
      "name": "WINCANTON HOLDINGS LIMITED",
      "company_number": "02155951",
      "operator_type": "Limited Company",
      "company_url": "https://haulierscope.co.uk/company/wincanton-holdings-limited-02155951"
    },
    "traffic_area": "East of England",
    "…": "operating centres, Companies House, earned recognition, inquiries, decisions, history"
  }
}

Erros usam códigos de status HTTP (400, 404, 429, 503) e um corpo JSON com um error.code e um error.message em linguagem simples.

Versões Markdown das páginas

Toda página pública tem uma versão Markdown limpa para modelos de linguagem. Adicione .md ao endereço, por exemplo /area/scotland.md ou /index.md para a página inicial, ou solicite o endereço normal com o cabeçalho Accept: text/markdown. Cada versão começa com uma resposta de um parágrafo e a fonte e a data, e vincula às páginas normais. Navegadores e mecanismos de busca sempre recebem a página normal.

curl -H "Accept: text/markdown" https://haulierscope.co.uk/guides/vet-a-haulier

Arquivos de descoberta

/llms.txt: um mapa curto do site para modelos de linguagem.
/llms-full.txt: os guias, a metodologia e a documentação de dados em um único arquivo.
/okf/index.md: o mesmo conhecimento como um pacote Open Knowledge Format de arquivos Markdown vinculados.
/openapi.json e /.well-known/api-catalog: a descrição da API e sua entrada de catálogo.
/mcp/server-card e /.well-known/ai-catalog.json: o cartão do servidor MCP e o catálogo de IA do site.

Regras para usar os dados

Atribuição. Os dados de licenças são dados abertos sob a Open Government Licence v3.0. Mostre "Contains public sector information licensed under the Open Government Licence v3.0." junto com eles, e "Contains Companies House data." ao exibir fatos de empresas.
Privacidade. Nunca guardamos nomes de diretores, sócios ou gerentes de transporte, nem endereços de correspondência. Empresários individuais e sociedades são pessoas: nunca são nomeados aqui, são encontrados apenas pelo número exato da licença, e seus registros são mínimos. Não use os dados para identificá-los. Veja o aviso de privacidade.
Redação. Uma licença que não está no arquivo mais recente da DVSA é "não está no arquivo da DVSA datado" daquela data: o arquivo não diz o motivo. O status "unmapped" não é válido. A data de continuação não é uma data de expiração.
Independência. HaulierScope é independente e não é o registro oficial. Para o registro oficial, use o serviço GOV.UK "Find lorry or bus operators".

Limites de taxa e cache

Cada conexão pode fazer 60 solicitações de uma vez, depois uma solicitação por segundo. Os cabeçalhos de resposta X-RateLimit-Limit e X-RateLimit-Remaining mostram onde você está; acima do limite, você recebe HTTP 429 com um cabeçalho Retry-After. Licenças de empresários individuais e sociedades têm um limite horário menor, igual ao de suas páginas web. A maioria das respostas pode ser armazenada em cache por cinco minutos; os dados mudam quando a DVSA publica um novo arquivo, então armazenar por mais tempo é aceitável para a maioria dos usos.

Precisa de volumes maiores, verificação de listas em massa ou alertas quando uma licença muda? É para isso que serve o monitoramento. Perguntas: fale conosco.

Página canônica: https://haulierscope.co.uk/developers

Contains public sector information licensed under the Open Government Licence v3.0. Contains Companies House data.

HaulierScope é um serviço independente, não afiliado à DVSA ou aos Comissários de Tráfego. É atualizado quando a DVSA publica um novo arquivo, geralmente semanalmente.