HaulierScope
Comprobaciones de licencias de operador del Reino Unido para empresas de transporte de mercancías y autocares: estado, vehículos, cambios, audiencias públicas. Sin inicio de sesión.
Servidor MCP alojado
npx add-mcp 'https://haulierscope.co.uk/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
API de licencias de operador y servidor MCP
API JSON gratuita y servidor MCP para datos de licencias de operador de Gran Bretaña: búsqueda, licencias, empresas, cambios y audiencias públicas para aplicaciones y asistentes de IA.
Fuente: datos de licencias de operador de DVSA, archivo con fecha 7 de octubre de 2026 (https://www.data.gov.uk/dataset/2a67d1ee-8f1b-43a3-8bc6-e8772d162a3c/traffic-commissioners-goods-and-public-service-vehicle-operator-licence-records).
Desarrolladores y asistentes de IA
Consulte cualquier licencia de operador de vehículos de mercancías o PSV de Gran Bretaña desde su propio código o desde un asistente de IA. La API JSON y el servidor MCP son gratuitos, no requieren clave y devuelven los mismos registros que este sitio web, con la fecha del archivo de DVSA y la fuente en cada resultado.
De un vistazo
- Servidor MCP (HTTP transmisible) https://haulierscope.co.uk/mcp
- API JSON https://haulierscope.co.uk/api/v1
- OpenAPI 3.1 https://haulierscope.co.uk/openapi.json
- Datos: archivo de DVSA con fecha 7 de octubre de 2026
Los datos son el archivo de licencias de operador que DVSA publica como datos abiertos, leído cada vez que DVSA publica un nuevo archivo (generalmente semanalmente), con contexto de Companies House, reconocimiento de DVSA y comisarios de tráfico. Lea la metodología para saber qué significa cada campo y el estado de los datos para conocer la fecha de cada fuente.
Servidor MCP
El Protocolo de Contexto de Modelo (MCP) permite que un asistente de IA llame a herramientas en otro servicio. Nuestro servidor MCP brinda a asistentes como Claude, ChatGPT, Cursor y VS Code acceso directo y estructurado a los datos de licencias de operador. Haga una pregunta en palabras sencillas, por ejemplo "¿Es válida OF2071131 y cuántos vehículos autoriza?", y el asistente llamará a la herramienta adecuada y citará la fecha del archivo de DVSA.
- Dirección:
https://haulierscope.co.uk/mcp - Transporte: HTTP transmisible. Cada solicitud se responde con JSON; no hay sesiones que gestionar.
- Inicio de sesión: ninguno. Todas las herramientas son de solo lectura.
- Tarjeta de servidor: https://haulierscope.co.uk/mcp/server-card
Conecte su asistente
Claude Code
claude mcp add --transport http haulierscope https://haulierscope.co.uk/mcp
Agregue --scope user para usarlo en cada proyecto, o --scope project para compartirlo a través de .mcp.json.
Claude (claude.ai y Claude Desktop)
Abra Configuración, luego Conectores, y elija Agregar conector personalizado. Asígnele el nombre HaulierScope, pegue https://haulierscope.co.uk/mcp como URL y elija sin inicio de sesión. En los planes Team y Enterprise, un propietario agrega el conector para la organización primero.
Cursor
Agregue HaulierScope a Cursor, o agregue esto a ~/.cursor/mcp.json:
{
"mcpServers": {
"haulierscope": {
"url": "https://haulierscope.co.uk/mcp"
}
}
}
VS Code (GitHub Copilot)
Agregue HaulierScope a VS Code, o agregue esto a .vscode/mcp.json:
{
"servers": {
"haulierscope": {
"type": "http",
"url": "https://haulierscope.co.uk/mcp"
}
}
}
ChatGPT
Active el modo de desarrollador (Configuración, luego Seguridad e inicio de sesión) y luego agregue un nuevo conector con la URL https://haulierscope.co.uk/mcp y sin autenticación. El servidor también tiene las herramientas search y fetch que utiliza la investigación profunda.
OpenAI Codex, CLI de Gemini y otros
codex mcp add haulierscope --url https://haulierscope.co.uk/mcp
gemini mcp add --transport http haulierscope https://haulierscope.co.uk/mcp
Cualquier cliente que admita servidores MCP remotos a través de HTTP transmisible puede usar la misma dirección. Los clientes más antiguos pueden hacer un puente con npx mcp-remote https://haulierscope.co.uk/mcp.
Pruébelo desde una 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
Herramientas MCP
Cada herramienta es de solo lectura y devuelve contenido estructurado con un esquema de salida publicado, además del mismo JSON como texto.
| Herramienta | Argumentos | Qué devuelve |
|---|---|---|
search_operators | query, filters?, limit? | Encuentre operadores por nombre de empresa, número de licencia o número de empresa. Filtros: área de tráfico, mercancías o PSV, estado, tipo de licencia, en el archivo más reciente. |
get_licence | licence_number | El registro completo de una licencia: titular, tipo, estado, vehículos, remolques, fecha de continuación, centros de operación, estado en Companies House, reconocimiento, audiencias públicas, decisiones e historial de cambios. |
get_company | company_number | Todas las licencias de una empresa, con totales y su contexto de Companies House, Gaceta y comisarios de tráfico. |
area_stats | area | Licencias, operadores, vehículos, combinación de licencias, operadores más grandes y pueblos para una de las ocho áreas de tráfico. |
recent_changes | release?, area?, change_type?, limit?, offset? | Lo que cambió entre un archivo de DVSA y el anterior, con valores antes y después. |
upcoming_public_inquiries | area? | Audiencias públicas que los comisarios de tráfico han programado para empresas, con fecha, lugar, motivos y el aviso oficial. |
insolvency_watch | area?, limit? | Titulares de licencias que Companies House muestra en liquidación, administración o administración judicial, con avisos de insolvencia de la Gaceta. |
filing_watch | area?, limit? | Titulares de licencias cuyas cuentas estaban vencidas en la fecha del registro de Companies House. |
new_licences | month?, area?, limit? | Nuevas licencias de operador otorgadas en un mes, de los boletines semanales de los comisarios de tráfico. |
licences_ended | month?, area?, limit? | Licencias publicadas como revocadas, renunciadas o terminadas en un mes, con el encabezado y boletín oficiales para cada una. |
tc_decisions | area?, outcome?, limit? | Decisiones regulatorias de los comisarios de tráfico, con resultado, fechas, estado de apelación y el documento de decisión. |
biggest_operators | kind, area? | Las empresas de transporte de mercancías o de autobuses y autocares más grandes por vehículos autorizados, a nivel nacional o en un área de tráfico. |
data_status | none | La fecha y antigüedad de cada fuente, y cada archivo de DVSA que tenemos. |
search, fetch | query / id | El par de búsqueda y recuperación que utilizan la investigación profunda y el conocimiento de empresas de ChatGPT. fetch devuelve la versión Markdown de una página. |
API JSON
Solicitudes HTTPS GET simples, respuestas JSON, sin clave. La descripción completa está en openapi.json (OpenAPI 3.1), que los generadores de código y las herramientas de API pueden leer directamente.
| Solicitud | Devuelve |
|---|---|
GET /api/v1/search?q=wincanton | Búsqueda por nombre, número de licencia o número de empresa. Opcional: área, categoría, estado, licence_type, in_current_file, límite. |
GET /api/v1/licences/{licence_number} | Una licencia. |
GET /api/v1/companies/{company_number} | Una empresa y todas sus licencias. |
GET /api/v1/areas | Las ocho áreas de tráfico con recuentos de licencias y vehículos. |
GET /api/v1/areas/{area} | Estadísticas para un área de tráfico (slug, letra o nombre). |
GET /api/v1/changes?release=YYYY-MM-DD | Cambios en un archivo de DVSA. Opcional: área, tipo, límite, desplazamiento. |
GET /api/v1/public-inquiries?area=scotland | Próximas audiencias públicas para empresas. |
GET /api/v1/insolvency-watch?area=wales | Titulares de licencias en liquidación, administración o administración judicial, con avisos de la Gaceta. |
GET /api/v1/filing-watch?area=wales | Titulares de licencias con cuentas vencidas en Companies House. |
GET /api/v1/new-licences?month=YYYY-MM | Nuevas licencias de operador otorgadas en un mes. Opcional: área, límite. |
GET /api/v1/licences-ended?month=YYYY-MM | Licencias revocadas, renunciadas o terminadas en un mes, en la redacción oficial. Opcional: área, límite. |
GET /api/v1/tc-decisions?area=wales | Decisiones de los comisarios de tráfico. Opcional: resultado, límite. |
GET /api/v1/rankings/haulage-companies?area=wales | Operadores más grandes por vehículos autorizados (empresas de transporte de mercancías o de autobuses y autocares). |
GET /api/v1/earned-recognition?area=wales | Operadores con reconocimiento de DVSA, por área de tráfico. |
GET /api/v1/status | Fechas de fuentes y los archivos de DVSA que tenemos. |
curl https://haulierscope.co.uk/api/v1/licences/of2071131
Un número de licencia tiene dos letras y siete dígitos. La primera letra es O para vehículos de mercancías o P para autobuses y autocares; la segunda letra es el área de tráfico. Mayúsculas o minúsculas funcionan igual.
Qué contiene cada respuesta
Cada respuesta de API y cada resultado de herramienta MCP incluye source, file_date (la fecha del archivo de DVSA que describen los datos), canonical_url (la página en este sitio), markdown_url y attribution. Cite la fecha del archivo y enlace la URL canónica cuando muestre los datos.
{
"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"
}
}
Los errores usan códigos de estado HTTP (400, 404, 429, 503) y un cuerpo JSON con un error.code y un error.message en inglés sencillo.
Versiones Markdown de las páginas
Cada página pública tiene una versión Markdown limpia para modelos de lenguaje. Agregue .md a la dirección, por ejemplo /area/scotland.md o /index.md para la página de inicio, o solicite la dirección normal con el encabezado Accept: text/markdown. Cada versión comienza con una respuesta de un párrafo y la fuente y fecha, y enlaza a las páginas normales. Los navegadores y motores de búsqueda siempre reciben la página normal.
curl -H "Accept: text/markdown" https://haulierscope.co.uk/guides/vet-a-haulier
Archivos de descubrimiento
- /llms.txt: un mapa breve del sitio para modelos de lenguaje.
- /llms-full.txt: las guías, metodología y documentación de datos en un solo archivo.
- /okf/index.md: el mismo conocimiento como un paquete de Formato de Conocimiento Abierto de archivos Markdown enlazados.
- /openapi.json y /.well-known/api-catalog: la descripción de la API y su entrada de catálogo.
- /mcp/server-card y /.well-known/ai-catalog.json: la tarjeta del servidor MCP y el catálogo de IA del sitio.
Reglas para usar los datos
- Atribución. Los datos de licencias son datos abiertos bajo la Licencia de Gobierno Abierto v3.0. Muestre "Contiene información del sector público bajo la Licencia de Gobierno Abierto v3.0." junto con ellos, y "Contiene datos de Companies House." cuando muestre hechos de empresas.
- Privacidad. Nunca tenemos nombres de directores, socios o gerentes de transporte, ni direcciones de correspondencia. Los autónomos y las sociedades colectivas son personas: nunca se les nombra aquí, solo se les encuentra por número de licencia exacto, y sus registros son mínimos. No use los datos para identificarlos. Consulte el aviso de privacidad.
- Redacción. Una licencia que no está en el archivo más reciente de DVSA está "no en el archivo de DVSA con fecha" de esa fecha: el archivo no dice por qué. El estado "no asignado" no es válido. La fecha de continuación no es una fecha de vencimiento.
- Independencia. HaulierScope es independiente y no es el registro oficial. Para el registro oficial, use el servicio de GOV.UK "Encontrar operadores de camiones o autobuses".
Límites de velocidad y almacenamiento en caché
Cada conexión puede hacer 60 solicitudes a la vez, luego una solicitud por segundo. Los encabezados de respuesta X-RateLimit-Limit y X-RateLimit-Remaining muestran dónde se encuentra; al superar el límite, recibe HTTP 429 con un encabezado Retry-After. Las licencias de autónomos y sociedades colectivas tienen un límite horario más bajo, igual que sus páginas web. La mayoría de las respuestas se pueden almacenar en caché durante cinco minutos; los datos cambian cuando DVSA publica un nuevo archivo, por lo que almacenar en caché durante más tiempo está bien para la mayoría de los usos.
¿Necesita volúmenes más altos, una verificación de listas masivas o alertas cuando cambia una licencia? Para eso está el monitoreo. Preguntas: contáctenos.
Página canónica: https://haulierscope.co.uk/developers
Contiene información del sector público bajo la Licencia de Gobierno Abierto v3.0. Contiene datos de Companies House.
HaulierScope es un servicio independiente, no afiliado a DVSA ni a los comisarios de tráfico. Se actualiza cuando DVSA publica un nuevo archivo, generalmente semanalmente.