LoadSnap

Referencia del servidor MCP

Todo lo necesario para conectar un asistente de IA a una cuenta de LoadSnap, y lo que puede leer una vez conectado.

Endpoint

https://app.loadsnap.co.uk/api/mcp

Un servidor remoto del Protocolo de Contexto de Modelo (MCP) que utiliza el transporte HTTP Streamable: JSON-RPC 2.0 a través de un único POST. El servidor no tiene estado, por lo que no hay cabecera de sesión ni flujo de eventos iniciado por el servidor, y un GET devuelve 405.

Añádelo a Claude, Claude Code, ChatGPT, Cursor o cualquier otro cliente compatible con MCP como conector personalizado o remoto, usando esa URL. No hay ninguna clave API que pegar.

Autenticación

OAuth 2.1: código de autorización con PKCE, más Registro Dinámico de Clientes, de modo que un cliente se registra solo sin configuración manual. El descubrimiento funciona de la manera habitual: una solicitud no autenticada devuelve 401 con una cabecera WWW-Authenticate que apunta a los metadatos del recurso protegido.

Metadatos del recurso protegido	/.well-known/oauth-protected-resource
Metadatos del servidor de autorización	/.well-known/oauth-authorization-server
Registro dinámico de clientes	/api/oauth/register
Autorización	/oauth/authorize
Token	/api/oauth/token

La persona inicia sesión en LoadSnap y aprueba la conexión en una pantalla que nombra al cliente y a su organización. Los tokens de acceso duran una hora y se renuevan con un token de actualización, de modo que la conexión sigue funcionando sin volver a iniciar sesión.

El acceso se autoriza como persona, no como clave. La pertenencia a la organización y el plan se vuelven a comprobar en cada solicitud, de modo que eliminar a alguien de una organización también pone fin a su acceso al conector.

Alcance del acceso

Cada consulta está filtrada estrictamente a la organización del usuario autorizado, resuelta en el servidor a partir del token. El cliente nunca proporciona una organización, por lo que no puede solicitar datos de otra empresa. La seguridad a nivel de fila aplica el mismo límite en la base de datos subyacente.

15 de las 21 herramientas solo leen. Las 6 cuyos nombres comienzan con create_ añaden un registro y nada más: ninguna edita, elimina, presenta archivos a DEFRA, firma una nota de transferencia, emite una factura ni otorga un inicio de sesión de oficina. Cada una está marcada como de escritura en sus anotaciones, de modo que el cliente pregunta a la persona antes de ejecutarla.

La única excepción al alcance de la organización es find_waste_codes, que busca en el Catálogo Europeo de Residuos publicado (la misma lista nacional para todos, y no los datos propios de nadie).

Herramientas

21 herramientas, cada una limitada a la organización autorizada. Cada una se enumera a continuación con la descripción que recibe un cliente y los argumentos que acepta. Una herramienta marcada como escribe añade un registro; el resto solo lee.

find_movements

Buscar movimientos de residuos

Listar o buscar los registros de movimientos de residuos de esta organización (Notas de Transferencia de Residuos) y trabajos, por nombre de productor, cliente o transportista y/o un rango de fechas de recogida. Úsalo para «¿hemos hecho movimientos para X?», «¿qué recogimos de Y en mayo?» o «¿qué movimos la semana pasada?» sin ningún nombre.

name	opcional	Nombre del productor, cliente o transportista a buscar. Omítelo para listar todo en el rango de fechas.
date_from	opcional	Fecha ISO opcional (AAAA-MM-DD) límite inferior
date_to	opcional	Fecha ISO opcional (AAAA-MM-DD) límite superior

find_receipts

Buscar recibos de entrada

Listar o buscar los recibos de entrada de esta organización (residuos que llegan a su propia instalación) por nombre de transportista o productor y/o un rango de fechas de recepción. Omite el nombre para listar todo lo recibido en el rango.

name	opcional	Nombre del transportista o productor. Omítelo para listar todo.
date_from	opcional	Fecha ISO opcional (AAAA-MM-DD) límite inferior
date_to	opcional	Fecha ISO opcional (AAAA-MM-DD) límite superior

count_movements

Contar movimientos de residuos

Contar los movimientos de residuos de esta organización en un rango de fechas y totalizar su peso, opcionalmente divididos en entrantes o salientes. Úsalo para «¿cuántas cargas hicimos el mes pasado?», «¿cuántos residuos gestionamos este año?», «¿cuántas recogidas esta semana?». Cuenta por fecha de recogida.

date_from	opcional	Fecha ISO (AAAA-MM-DD) límite inferior en la fecha de recogida
date_to	opcional	Fecha ISO (AAAA-MM-DD) límite superior en la fecha de recogida
direction	opcional	inbound = residuos recibidos en la instalación propia de esta org, outbound = residuos que su camión retiró o envió. Omítelo para todos.

defra_filings

Presentaciones a DEFRA

Contar y listar las presentaciones de seguimiento de residuos a DEFRA de esta organización en un rango de fechas, y listar los registros que aún están pendientes de presentar. Úsalo para «¿cuántas presentaciones a DEFRA hemos hecho esta semana?», «¿falló algo con DEFRA?», «¿qué sigue pendiente?».

date_from	opcional	Fecha ISO (AAAA-MM-DD) límite inferior en la fecha de presentación
date_to	opcional	Fecha ISO (AAAA-MM-DD) límite superior en la fecha de presentación
include_outstanding	opcional	También devolver los registros que aún no se han presentado a DEFRA. El valor predeterminado es true.

find_parties

Buscar transportistas e instalaciones

Resolver un nombre de empresa o instalación a los transportistas e instalaciones conocidos de la organización.

name	obligatorio	Nombre de la empresa o instalación

find_jobs

Buscar trabajos programados

Listar o buscar los trabajos de esta organización (trabajo reservado, en curso o finalizado) por nombre de cliente y/o un rango de fechas programadas. Úsalo para «¿qué hacemos mañana?», «¿está reservado el trabajo de Carter?», «¿qué sigue sin asignar?». Lee hacia adelante desde la fecha más temprana, porque una lista de trabajos es una agenda.

name	opcional	Nombre del cliente a buscar. Omítelo para listar todo en el rango.
status	opcional	Estado del trabajo para filtrar, por ejemplo draft, scheduled, in_progress, completed, cancelled.
date_from	opcional	Fecha ISO opcional (AAAA-MM-DD) límite inferior
date_to	opcional	Fecha ISO opcional (AAAA-MM-DD) límite superior

find_invoices

Facturas y dinero adeudado

Listar las facturas de esta organización y totalizar lo que aún se debe, opcionalmente solo las impagadas. Úsalo para «¿quién nos debe dinero?», «¿cuánto está pendiente?», «¿está pagada la factura de Carter?», «¿qué está vencido?». Los totales están en la moneda de la factura.

name	opcional	Nombre de la empresa a la que se facturó. Omítelo para listar todo en el rango.
status	opcional	Estado de la factura para filtrar, por ejemplo draft, issued, paid, void.
only_unpaid	opcional	Solo facturas con saldo pendiente de pago. El valor predeterminado es false.
date_from	opcional	Fecha ISO opcional (AAAA-MM-DD) límite inferior
date_to	opcional	Fecha ISO opcional (AAAA-MM-DD) límite superior

find_vehicles

Vehículos y su documentación

Listar los vehículos de esta organización con su vencimiento de ITV, impuesto y seguro, y marcar los que hayan caducado. Úsalo para «¿qué hay en la flota?», «¿hay algo sin ITV?», «¿cuándo vence el impuesto de VX19 ABC?». La ITV y el impuesto provienen de la DVLA y solo están tan actualizados como la última comprobación.

name	opcional	Matrícula o descripción a buscar. Omítelo para listar todo en el rango.
include_inactive	opcional	También devolver vehículos retirados de la flota. El valor predeterminado es false.

find_people

El equipo y lo que pueden usar

Listar las personas del equipo de esta organización y cuál de las tres vías de acceso tiene cada una: un inicio de sesión de oficina, la aplicación del conductor, la aplicación de báscula. Úsalo para «¿quién conduce para nosotros?», «¿tiene Dave la aplicación del conductor?», «¿quién está en el equipo?».

name	opcional	Nombre o correo electrónico de la persona a buscar. Omítelo para listar todo en el rango.
drivers_only	opcional	Solo personas que tengan la aplicación del conductor. El valor predeterminado es false.

compliance_status

Certificados, permisos y registros

Listar los certificados, permisos y registros que esta organización tiene registrados, con sus fechas de vencimiento, e indicar cuáles ya han caducado. Úsalo para «¿sigue siendo válido nuestro registro de transportista de residuos?», «¿qué vence este año?», «¿tenemos un certificado ISO archivado?».

expired_only	opcional	Solo los que ya han caducado. El valor predeterminado es false.

find_documents

Buscar un documento

Buscar los documentos almacenados de esta organización (notas de transferencia de residuos, notas de consignación, permisos, documentación subida) por tipo y/o fecha, con un enlace a cada uno. Úsalo para «envíame la nota de transferencia de esa carga», «¿qué documentación tenemos sobre este trabajo?».

document_type	opcional	Tipo de documento para filtrar, por ejemplo wtn, hwcn, annex_vii, permit, upload.
movement_id	opcional	Solo documentos adjuntos a este movimiento de residuos.
job_id	opcional	Solo documentos adjuntos a este trabajo.
date_from	opcional	Fecha ISO opcional (AAAA-MM-DD) límite inferior
date_to	opcional	Fecha ISO opcional (AAAA-MM-DD) límite superior

container_stock

Contenedores y volquetes

Qué contenedores tiene esta organización y dónde están: los que se rastrean uno a uno con un número de activo y estado, y los tipos que se mantienen como total acumulado. Úsalo para «¿cuántos volquetes de 8 yardas tenemos libres?», «¿dónde está el volquete 214?», «¿qué está alquilado?».

container_type	opcional	Tipo de contenedor para filtrar, por ejemplo skip, roro, bin.
container_size	opcional	Tamaño del contenedor para filtrar, por ejemplo 8yd.
state	opcional	Estado de un contenedor rastreado individualmente, por ejemplo in_yard, on_site, in_transit.

find_contracts

Contratos y abonos

Listar los acuerdos permanentes de esta organización: contratos y abonos, qué residuos cubre cada uno, las fechas de vigencia y si ambas partes han firmado. Úsalo para «¿qué tenemos bajo contrato?», «¿se ha firmado ese abono?», «¿qué vence este mes?».

site_id	opcional	Solo acuerdos para esta instalación.
active_only	opcional	Solo acuerdos aún en vigor. El valor predeterminado es false.

consignee_returns

Declaraciones trimestrales de destinatario

Las declaraciones trimestrales de destinatario de esta organización para residuos peligrosos recibidos: el trimestre, qué vence y cuándo, cuántas consignaciones y qué peso, y si se ha enviado. Úsalo para «¿está hecha nuestra declaración de destinatario?», «¿qué vence este trimestre?». Solo destinatarios; un transportista no tiene ninguna.

quarter	opcional	Una etiqueta de trimestre, por ejemplo «Q1 2026».
status	opcional	Estado para filtrar: not_started, generated, reviewed o submitted.

find_waste_codes

Consultar un código de residuo

Buscar en el Catálogo Europeo de Residuos (CER) por código o por qué es el residuo, e indicar si cada código es peligroso o una entrada espejo. Úsalo para «¿qué código es el cartón-yeso?», «¿es peligroso el 17 05 03?». Esta es la lista nacional publicada, no los datos propios de esta organización.

query	obligatorio	Un código o parte de uno («17 05»), o palabras que describan el residuo («cartón-yeso»).
hazardous_only	opcional	Solo códigos peligrosos. El valor predeterminado es false.

create_customer

Añadir un clienteescribe

Añadir un cliente (una instalación de recogida de la que la organización recoge residuos). Responde con lo que aún se necesita si falta algo obligatorio, y no escribe nada. Si ya existe un cliente con ese nombre y código postal, devuelve ese en lugar de crear un segundo.

name	obligatorio	La empresa o persona a la que pertenecen los residuos
address	obligatorio	Dónde se recogen los residuos
postcode	obligatorio	Código postal de la dirección de recogida
producer_type	opcional	Si los residuos provienen de una empresa o de un hogar. El valor predeterminado es business.
contact_name	obligatorio	A quién preguntar en la instalación
contact_email	opcional	Su dirección de correo electrónico
contact_phone	opcional	Su número de teléfono
sic_code	opcional	El código SIC del productor, si se conoce

create_receiving_site

Añadir una instalación de recepciónescribe

Añadir una instalación de recepción (un vertedero, una estación de transferencia o una instalación de reciclaje a la que se llevan los residuos). Responde con lo que aún se necesita si falta algo obligatorio, y no escribe nada.

nombre	obligatorio	El nombre del sitio
dirección	obligatorio	La dirección del sitio
código postal	obligatorio	Código postal del sitio
número_de_permiso	opcional	Número de permiso ambiental o de exención
nombre_de_contacto	opcional	A quién preguntar en la puerta
correo_de_contacto	opcional	Su dirección de correo electrónico
teléfono_de_contacto	opcional	Su número de teléfono
es_sitio_propio	opcional	Verdadero solo si es el sitio propio de la organización en lugar del de otra persona. El valor predeterminado es falso.

create_carrier

Añadir un transportista o intermediarioescribe

Añade un transportista, intermediario o distribuidor con el que trabaja la organización. Responde con lo que aún se necesita si falta algo obligatorio y no escribe nada.

nombre_de_empresa	obligatorio	El nombre de la empresa del transportista o intermediario
número_de_registro	opcional	Su número de registro de transportista de residuos, si se conoce
nombre_de_contacto	opcional	Con quién hablar
correo_de_contacto	opcional	Su dirección de correo electrónico
teléfono_de_contacto	opcional	Su número de teléfono
dirección	opcional	Su dirección
código postal	opcional	Su código postal
notas	opcional	Cualquier cosa que valga la pena registrar sobre ellos

create_vehicle

Añadir un vehículoescribe

Añade un vehículo a la flota. Responde con lo que aún se necesita si falta algo obligatorio y no escribe nada. Una matrícula que ya está en la flota devuelve ese vehículo en lugar de crear uno segundo.

matrícula	obligatorio	La placa de matrícula
marca	opcional	Quién lo fabricó
descripción	opcional	Modelo o descripción
tipo_de_vehículo	opcional	Qué tipo de vehículo es, por ejemplo, camión de volquete o volquete
vencimiento_de_ITV	opcional	Cuándo caduca la ITV (AAAA-MM-DD)
vencimiento_de_impuesto	opcional	Cuándo caduca el impuesto (AAAA-MM-DD)
peso_máximo_en_toneladas	opcional	Peso bruto en toneladas

create_driver

Añadir un conductorescribe

Añade un conductor para que pueda recibir trabajos y firmar notas de transferencia en la aplicación de conductores. Utiliza una de las asignaciones de conductores del plan y se niega si todas están en uso. No da a nadie un inicio de sesión de oficina: eso se entrega en la página de Equipo por un propietario o un administrador. Alguien que ya está en el equipo recibe la aplicación de conductores añadida al registro que ya tiene.

nombre	obligatorio	Su nombre completo
correo electrónico	obligatorio	Su dirección de correo electrónico, a donde va la invitación a la aplicación de conductores
número_de_teléfono	opcional	Su número de teléfono
rol	opcional	Qué hace, por ejemplo, conductor de HGV
dirección	opcional	Su dirección de casa
código postal	opcional	Su código postal de casa
vencimiento_de_licencia	opcional	Cuándo caduca su licencia (AAAA-MM-DD)
nombre_de_contacto_de_emergencia	opcional	A quién llamar en una emergencia
teléfono_de_contacto_de_emergencia	opcional	El número de teléfono de esa persona

create_enquiry

Registrar una solicitud de recogidaescribe

Registra una solicitud de recogida (una consulta) de un cliente, para que la oficina pueda cotizarla. Responde con lo que aún se necesita si falta algo obligatorio y no escribe nada.

nombre_de_empresa	obligatorio	La empresa que pregunta
nombre_de_contacto	obligatorio	Quién se puso en contacto
correo_de_contacto	obligatorio	Su dirección de correo electrónico
teléfono_de_contacto	obligatorio	Su número de teléfono
dirección_del_sitio	obligatorio	Dónde están los residuos
código postal	opcional	Código postal de esa dirección
descripción_de_residuos	obligatorio	Qué son los residuos, en sus palabras
tipo_de_servicio	opcional	Qué están pidiendo, por ejemplo, un contenedor o una carga de agarre
peso_estimado	opcional	Aproximadamente cuánto, en toneladas
fecha_preferida	opcional	Cuándo les gustaría (AAAA-MM-DD)
notas_de_acceso	opcional	Cualquier cosa sobre cómo acceder al sitio

Escritura

Las 6 herramientas create_ añaden un cliente, un sitio receptor, un transportista o intermediario, un vehículo, un conductor y una solicitud de recogida. Son cómo alguien introduce datos en LoadSnap describiéndolos en una conversación en lugar de rellenar un formulario o preparar una hoja de cálculo.

Nada se escribe a medias. Una llamada a la que le falta algo obligatorio no escribe nada y responde con la lista de lo que aún se necesita, formulada como preguntas, para que el asistente lo pida y vuelva a llamar. Una llamada para un registro que ya existe devuelve el registro que está allí en lugar de crear uno segundo, por lo que ejecutar la misma solicitud dos veces no puede dejar un duplicado.

Un conductor añadido de esta manera utiliza una de las asignaciones de conductores del plan y se le rechaza cuando todas están en uso, exactamente como en la página de Equipo, y se compara con las personas que ya están en el equipo para que alguien que ya trabaja allí reciba la aplicación de conductores añadida al registro que tiene. A nadie se le da un inicio de sesión de oficina: eso es un asiento de pago y una vía de acceso al negocio, y se entrega en Equipo por un propietario o un administrador.

Presentar a DEFRA, firmar una nota de transferencia, emitir una factura y eliminar cualquier cosa están deliberadamente ausentes aquí. Son cosas que una persona hace en LoadSnap, con su nombre en ellas.

Panel interactivo

El servidor publica un panel interactivo como recurso MCP en ui://loadsnap/panel, y cada herramienta apunta a él. Un cliente que admite la extensión de aplicaciones dibuja la respuesta como un panel en la conversación: una tabla de registros, una tarjeta para el registro recién añadido o una lista de verificación de lo que aún se necesita antes de que algo pueda guardarse.

Es un documento autónomo sin datos propios, sin token y sin nada obtenido de la red. El cliente pasa la respuesta de la herramienta a él. Cada herramienta también devuelve esa respuesta como texto, por lo que un cliente que no dibuja paneles muestra exactamente lo que siempre mostró.

Límites y formatos

Los pesos se devuelven en kilogramos a menos que un nombre de campo diga toneladas. Las fechas están en ISO (AAAA-MM-DD). Una búsqueda devuelve las 25 coincidencias más relevantes; count_movements lee hasta 1,000 filas e informa count_is_capped cuando alcanza ese límite, por lo que una cifra limitada nunca se presenta como un total exacto. Lo mismo se aplica al dinero adeudado en find_invoices, que informa totals_are_capped. Los registros sembrados como muestras se excluyen de todos los resultados.

Requisitos

Una cuenta de LoadSnap en el plan Pro o superior, y un inicio de sesión que pertenezca a una organización de LoadSnap. Todos los que se conectan usan su propio inicio de sesión, porque la conexión está autorizada como ellos.

¿Preguntas sobre el conector? Envía un correo a info@loadsnap.co.uk, o lee la descripción general del conector.