LoadSnap

oficial

Consulta tus registros de cumplimiento de residuos del Reino Unido desde cualquier asistente de IA. Acceso de solo lectura a tus propias notas de transferencia de residuos, recibos, tonelaje y envíos de Seguimiento Digital de Residuos de DEFRA.

¿Qué puedes hacer con LoadSnap MCP?

  • Buscar movimientos de residuos — Solicite notas de transferencia de residuos o trabajos por transportista, productor o nombre de cliente y rango de fechas mediante find_movements.
  • Revisar recibos del sitio — Liste los recibos de residuos entrantes en su propio sitio, filtrados por transportista, productor o rango de fechas con find_receipts.
  • Resumir totales de movimientos — Obtenga recuentos de movimientos y peso total durante un período, opcionalmente dividido por dirección de entrada/salida, usando count_movements.
  • Verificar estado de presentación ante DEFRA — Cuente y liste los envíos de Digital Waste Tracking, incluidos los registros pendientes, con defra_filings.
  • Resolver nombres de empresas — Coincida un nombre de empresa o sitio con sus transportistas y sitios conocidos usando find_parties.

Documentación

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 una solicitud 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 clave de 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 por sí mismo 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, por lo 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 se filtra 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.

El servidor es de solo lectura. No existe ninguna herramienta que cree, edite o elimine nada.

Herramientas

find_movements

Lista o busca registros de movimientos de residuos (Notas de Transferencia de Residuos) y trabajos.

nameopcionalNombre del productor, cliente o transportista. Omítelo para listar todo en el rango de fechas.
date_fromopcionalFecha ISO (AAAA-MM-DD) como límite inferior de la fecha de recogida.
date_toopcionalFecha ISO (AAAA-MM-DD) como límite superior de la fecha de recogida.

find_receipts

Lista o busca recibos de residuos que llegan al sitio propio de la organización.

nameopcionalNombre del transportista o productor. Omítelo para listar todo lo recibido en el rango.
date_fromopcionalFecha ISO (AAAA-MM-DD) como límite inferior de la fecha de recepción.
date_toopcionalFecha ISO (AAAA-MM-DD) como límite superior de la fecha de recepción.

count_movements

Cuenta movimientos en un período y totaliza su peso, opcionalmente dividido por dirección.

date_fromopcionalFecha ISO (AAAA-MM-DD) como límite inferior de la fecha de recogida.
date_toopcionalFecha ISO (AAAA-MM-DD) como límite superior de la fecha de recogida.
directionopcionalinbound, outbound o all. Inbound es residuo recibido en el sitio propio de la organización.

defra_filings

Cuenta y lista los envíos de Seguimiento Digital de Residuos de DEFRA, y los registros que aún están pendientes de presentar.

date_fromopcionalFecha ISO (AAAA-MM-DD) como límite inferior de la fecha de envío.
date_toopcionalFecha ISO (AAAA-MM-DD) como límite superior de la fecha de envío.
include_outstandingopcionalTambién devuelve registros aún no presentados. El valor predeterminado es true.

find_parties

Resuelve un nombre de empresa o sitio a los transportistas y sitios conocidos de la organización.

nameobligatorioNombre de la empresa o sitio.

Límites y formatos

Los pesos se devuelven en kilogramos a menos que un nombre de campo indique toneladas. Las fechas son ISO (AAAA-MM-DD). Las dos herramientas de búsqueda devuelven las 25 coincidencias más recientes; count_movements lee hasta 1.000 filas e informa count_is_capped cuando alcanza ese límite, de modo que una cifra limitada nunca se presenta como un total exacto. 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. Cada persona que se conecta usa su propio inicio de sesión, porque la conexión se autoriza como esa persona.

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