LoadSnap

Référence du serveur MCP

Tout ce qu'il faut pour connecter un assistant IA à un compte LoadSnap, et ce qu'il peut lire une fois connecté.

Point de terminaison

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

Un serveur de protocole Model Context Protocol distant utilisant le transport HTTP Streamable : JSON-RPC 2.0 sur un seul POST. Le serveur est sans état, donc il n'y a pas d'en-tête de session ni de flux d'événements initié par le serveur, et un GET renvoie 405.

Ajoutez-le à Claude, Claude Code, ChatGPT, Cursor ou tout autre client compatible MCP comme connecteur personnalisé ou distant, en utilisant cette URL. Il n'y a pas de clé API à coller.

Authentification

OAuth 2.1 : code d'autorisation avec PKCE, plus enregistrement dynamique du client, afin qu'un client s'intègre lui-même sans configuration manuelle. La découverte fonctionne de la manière habituelle, une requête non authentifiée renvoyant 401 avec un en-tête WWW-Authenticate pointant vers les métadonnées de la ressource protégée.

Métadonnées de la ressource protégée	/.well-known/oauth-protected-resource
Métadonnées du serveur d'autorisation	/.well-known/oauth-authorization-server
Enregistrement dynamique du client	/api/oauth/register
Autorisation	/oauth/authorize
Jeton	/api/oauth/token

La personne se connecte à LoadSnap et approuve la connexion sur un écran nommant le client et son organisation. Les jetons d'accès durent une heure et sont renouvelés avec un jeton d'actualisation, de sorte que la connexion continue de fonctionner sans se reconnecter.

L'accès est autorisé en tant que personne, et non en tant que clé. L'appartenance à l'organisation et le plan sont revérifiés à chaque requête, donc retirer quelqu'un d'une organisation met fin à son accès au connecteur en même temps.

Portée de l'accès

Chaque requête est strictement filtrée sur l'organisation de l'utilisateur autorisé, résolue côté serveur à partir du jeton. Le client ne fournit jamais d'organisation, il ne peut donc pas demander les données d'une autre entreprise. La sécurité au niveau des lignes applique la même limite dans la base de données sous-jacente.

15 des 21 outils sont en lecture seule. Les 6 dont les noms commencent par create_ ajoutent un enregistrement et rien d'autre : aucun ne modifie, ne supprime, ne déclare à DEFRA, ne signe un bordereau de transfert, n'émet une facture ou ne fournit un identifiant de bureau. Chacun est marqué comme écriture dans ses annotations, afin qu'un client demande à la personne avant de l'exécuter.

La seule exception au filtrage par organisation est find_waste_codes, qui recherche le catalogue européen des déchets publié — la même liste nationale pour tout le monde, et aucune donnée propre à personne.

Outils

21 outils, chacun limité à l'organisation autorisée. Chacun est listé ci-dessous avec la description donnée à un client et les arguments qu'il accepte. Un outil marqué écriture ajoute un enregistrement ; les autres sont en lecture seule.

find_movements

Trouver les mouvements de déchets

Lister ou rechercher les enregistrements de mouvements de déchets de cette organisation (bordereaux de transfert de déchets) et les travaux, par nom de producteur, de client ou de transporteur et/ou une plage de dates de collecte. Utilisez ceci pour « avons-nous fait des mouvements pour X », « qu'avons-nous collecté chez Y en mai », ou « qu'avons-nous déplacé la semaine dernière » sans aucun nom.

name	facultatif	Nom du producteur, du client ou du transporteur à rechercher. Omettre pour tout lister dans la plage de dates.
date_from	facultatif	Date ISO facultative (AAAA-MM-JJ) borne inférieure
date_to	facultatif	Date ISO facultative (AAAA-MM-JJ) borne supérieure

find_receipts

Trouver les bons de réception

Lister ou rechercher les bons de réception de cette organisation (déchets arrivant sur leur propre site) par nom de transporteur ou de producteur et/ou une plage de dates de réception. Omettre le nom pour tout lister dans la plage.

name	facultatif	Nom du transporteur ou du producteur. Omettre pour tout lister.
date_from	facultatif	Date ISO facultative (AAAA-MM-JJ) borne inférieure
date_to	facultatif	Date ISO facultative (AAAA-MM-JJ) borne supérieure

count_movements

Compter les mouvements de déchets

Compter les mouvements de déchets de cette organisation sur une plage de dates et totaliser leur poids, éventuellement en les séparant entrants ou sortants. Utilisez ceci pour « combien de chargements avons-nous faits le mois dernier », « combien de déchets avons-nous traités cette année », « combien de collectes cette semaine ». Compte par date de collecte.

date_from	facultatif	Date ISO (AAAA-MM-JJ) borne inférieure sur la date de collecte
date_to	facultatif	Date ISO (AAAA-MM-JJ) borne supérieure sur la date de collecte
direction	facultatif	inbound = déchets pris en charge sur le site propre de cette org., outbound = déchets emportés ou envoyés par son camion. Omettre pour tout.

defra_filings

Déclarations DEFRA

Compter et lister les soumissions de suivi des déchets DEFRA de cette organisation sur une plage de dates, et lister les enregistrements encore en attente de déclaration. Utilisez ceci pour « combien de soumissions DEFRA avons-nous déposées cette semaine », « quelque chose a-t-il échoué avec DEFRA », « qu'est-ce qui est encore en attente ».

date_from	facultatif	Date ISO (AAAA-MM-JJ) borne inférieure sur la date de soumission
date_to	facultatif	Date ISO (AAAA-MM-JJ) borne supérieure sur la date de soumission
include_outstanding	facultatif	Renvoie également les enregistrements non encore déclarés à DEFRA. Par défaut : true.

find_parties

Trouver les transporteurs et les sites

Résoudre un nom d'entreprise ou de site vers les transporteurs et sites connus de l'organisation.

name	requis	Nom de l'entreprise ou du site

find_jobs

Trouver les travaux planifiés

Lister ou rechercher les travaux de cette organisation — travaux réservés, en cours ou terminés — par nom de client et/ou une plage de dates planifiées. Utilisez ceci pour « que faisons-nous demain », « le travail Carter est-il réservé », « qu'est-ce qui n'est pas encore affecté ». Lit en avant à partir de la date la plus ancienne, car une liste de travaux est un agenda.

name	facultatif	Nom du client à rechercher. Omettre pour tout lister dans la plage.
status	facultatif	Statut du travail à filtrer, par exemple draft, scheduled, in_progress, completed, cancelled.
date_from	facultatif	Date ISO facultative (AAAA-MM-JJ) borne inférieure
date_to	facultatif	Date ISO facultative (AAAA-MM-JJ) borne supérieure

find_invoices

Factures et argent dû

Lister les factures de cette organisation et totaliser ce qui est encore dû, éventuellement uniquement les impayées. Utilisez ceci pour « qui nous doit de l'argent », « combien est en attente », « la facture Carter est-elle payée », « qu'est-ce qui est en retard ». Les totaux sont dans la devise de la facture.

name	facultatif	Nom de l'entreprise facturée. Omettre pour tout lister dans la plage.
status	facultatif	Statut de la facture à filtrer, par exemple draft, issued, paid, void.
only_unpaid	facultatif	Uniquement les factures avec un solde restant à payer. Par défaut : false.
date_from	facultatif	Date ISO facultative (AAAA-MM-JJ) borne inférieure
date_to	facultatif	Date ISO facultative (AAAA-MM-JJ) borne supérieure

find_vehicles

Véhicules et leurs documents

Lister les véhicules de cette organisation avec leur expiration de contrôle technique (MOT), de taxe et d'assurance, et signaler ceux qui ont expiré. Utilisez ceci pour « quelle est la flotte », « y a-t-il quelque chose hors MOT », « quand la taxe est-elle due sur VX19 ABC ». Le MOT et la taxe proviennent de la DVLA et ne sont aussi frais que le dernier contrôle.

name	facultatif	Immatriculation ou description à rechercher. Omettre pour tout lister dans la plage.
include_inactive	facultatif	Renvoie également les véhicules retirés de la flotte. Par défaut : false.

find_people

L'équipe et ce qu'elle peut utiliser

Lister les personnes de l'équipe de cette organisation et laquelle des trois voies d'accès chacune détient : un identifiant de bureau, l'application conducteur, l'application pont-bascule. Utilisez ceci pour « qui conduit pour nous », « Dave a-t-il l'application conducteur », « qui est dans l'équipe ».

name	facultatif	Nom ou e-mail de la personne à rechercher. Omettre pour tout lister dans la plage.
drivers_only	facultatif	Uniquement les personnes détenant l'application conducteur. Par défaut : false.

compliance_status

Certificats, permis et enregistrements

Lister les certificats, permis et enregistrements que cette organisation a enregistrés, avec leurs dates d'expiration, et indiquer lesquels ont déjà expiré. Utilisez ceci pour « notre enregistrement de transporteur de déchets est-il toujours valide », « qu'est-ce qui expire cette année », « avons-nous un certificat ISO en dossier ».

expired_only	facultatif	Uniquement ceux déjà expirés. Par défaut : false.

find_documents

Trouver un document

Trouver les documents stockés de cette organisation — bordereaux de transfert de déchets, bordereaux de suivi, permis, documents téléchargés — par type et/ou date, avec un lien vers chacun. Utilisez ceci pour « envoyez-moi le bordereau de transfert pour ce chargement », « quels documents avons-nous sur ce travail ».

document_type	facultatif	Type de document à filtrer, par exemple wtn, hwcn, annex_vii, permit, upload.
movement_id	facultatif	Uniquement les documents attachés à ce mouvement de déchets.
job_id	facultatif	Uniquement les documents attachés à ce travail.
date_from	facultatif	Date ISO facultative (AAAA-MM-JJ) borne inférieure
date_to	facultatif	Date ISO facultative (AAAA-MM-JJ) borne supérieure

container_stock

Bennes et conteneurs

Quels conteneurs cette organisation détient et où ils se trouvent : ceux suivis individuellement avec un numéro d'actif et un état, et les types détenus comme total courant. Utilisez ceci pour « combien de bennes de 8 yards avons-nous de libres », « où est la benne 214 », « qu'est-ce qui est en location ».

container_type	facultatif	Type de conteneur à filtrer, par exemple skip, roro, bin.
container_size	facultatif	Taille de conteneur à filtrer, par exemple 8yd.
state	facultatif	État d'un conteneur suivi individuellement, par exemple in_yard, on_site, in_transit.

find_contracts

Contrats et abonnements

Lister les accords permanents de cette organisation : contrats et abonnements, quels déchets chacun couvre, les dates de validité et si les deux parties ont signé. Utilisez ceci pour « qu'avons-nous sous contrat », « cet abonnement a-t-il été signé », « qu'est-ce qui expire ce mois-ci ».

site_id	facultatif	Uniquement les accords pour ce site.
active_only	facultatif	Uniquement les accords encore en vigueur. Par défaut : false.

consignee_returns

Déclarations trimestrielles du destinataire

Les déclarations trimestrielles du destinataire de cette organisation pour les déchets dangereux reçus : le trimestre, ce qui est dû quand, combien de lots et quel poids, et si cela a été envoyé. Utilisez ceci pour « notre déclaration de destinataire est-elle faite », « qu'est-ce qui est dû ce trimestre ». Uniquement pour les destinataires ; un transporteur n'en a aucune.

quarter	facultatif	Une étiquette de trimestre, par exemple « Q1 2026 ».
status	facultatif	Statut à filtrer : not_started, generated, reviewed ou submitted.

find_waste_codes

Rechercher un code déchet

Rechercher le catalogue européen des déchets (CED) par code ou par ce qu'est le déchet, et indiquer si chaque code est dangereux ou une entrée miroir. Utilisez ceci pour « quel code est le placo », « 17 05 03 est-il dangereux ». C'est la liste nationale publiée, pas les données propres de cette organisation.

query	requis	Un code ou une partie de code (« 17 05 »), ou des mots décrivant le déchet (« placo »).
hazardous_only	facultatif	Uniquement les codes dangereux. Par défaut : false.

create_customer

Ajouter un clientécriture

Ajouter un client (un site de collecte dont l'organisation collecte les déchets). Répond avec ce qui manque encore si un élément requis est absent, et n'écrit rien. Si un client avec ce nom et ce code postal existe déjà, il renvoie celui-ci au lieu d'en créer un second.

name	requis	L'entreprise ou la personne à qui appartiennent les déchets
address	requis	Où les déchets sont collectés
postcode	requis	Code postal de l'adresse de collecte
producer_type	facultatif	Si les déchets proviennent d'une entreprise ou d'un ménage. Par défaut : business.
contact_name	requis	Qui demander sur le site
contact_email	facultatif	Leur adresse e-mail
contact_phone	facultatif	Leur numéro de téléphone
sic_code	facultatif	Le code SIC du producteur, si connu

create_receiving_site

Ajouter un site de réceptionécriture

Ajouter un site de réception (une décharge, une station de transfert ou une installation de recyclage où les déchets sont emmenés). Répond avec ce qui manque encore si un élément requis est absent, et n'écrit rien.

name	obligatoire	Le nom du site
address	obligatoire	L'adresse du site
postcode	obligatoire	Le code postal du site
permit_number	facultatif	Numéro de permis environnemental ou d'exemption
contact_name	facultatif	À qui demander à l'entrée
contact_email	facultatif	Leur adresse e-mail
contact_phone	facultatif	Leur numéro de téléphone
is_own_site	facultatif	Vrai uniquement s'il s'agit du propre site de l'organisation plutôt que de celui d'un tiers. Par défaut, faux.

create_carrier

Ajouter un transporteur ou un courtierécrit

Ajoute un transporteur, un courtier ou un revendeur avec lequel l'organisation travaille. Répond avec ce qui manque encore si un élément obligatoire est absent, et n'écrit rien.

company_name	obligatoire	Le nom de l'entreprise du transporteur ou du courtier
registration_number	facultatif	Leur numéro d'enregistrement de transporteur de déchets, s'il est connu
contact_name	facultatif	À qui parler
contact_email	facultatif	Leur adresse e-mail
contact_phone	facultatif	Leur numéro de téléphone
address	facultatif	Leur adresse
postcode	facultatif	Leur code postal
notes	facultatif	Tout ce qui vaut la peine d'être noté à leur sujet

create_vehicle

Ajouter un véhiculeécrit

Ajoute un véhicule à la flotte. Répond avec ce qui manque encore si un élément obligatoire est absent, et n'écrit rien. Une immatriculation déjà présente dans la flotte renvoie ce véhicule au lieu d'en créer un second.

registration	obligatoire	La plaque d'immatriculation
make	facultatif	Qui l'a fabriqué
description	facultatif	Modèle ou description
vehicle_type	facultatif	Le type de véhicule, par exemple camion-benne ou tombereau
mot_expiry	facultatif	Quand le contrôle technique expire (AAAA-MM-JJ)
tax_expiry	facultatif	Quand la taxe expire (AAAA-MM-JJ)
max_weight_tonnes	facultatif	Poids brut en tonnes

create_driver

Ajouter un conducteurécrit

Ajoute un conducteur, afin qu'il puisse recevoir des tâches et signer des bordereaux de transfert dans l'application conducteur. Utilise l'une des autorisations de conducteur du plan et refuse si elles sont toutes utilisées. Ne donne à personne un accès de connexion au bureau : celui-ci est attribué sur la page Équipe par un propriétaire ou un administrateur. Une personne déjà membre de l'équipe voit l'application conducteur ajoutée à son dossier existant.

name	obligatoire	Leur nom complet
email	obligatoire	Leur adresse e-mail, qui est l'endroit où l'invitation à l'application conducteur est envoyée
phone_number	facultatif	Leur numéro de téléphone
role	facultatif	Ce qu'ils font, par exemple conducteur de poids lourd
address	facultatif	Leur adresse personnelle
postcode	facultatif	Leur code postal personnel
licence_expiry	facultatif	Quand leur permis expire (AAAA-MM-JJ)
emergency_contact_name	facultatif	Qui appeler en cas d'urgence
emergency_contact_phone	facultatif	Le numéro de téléphone de cette personne

create_enquiry

Enregistrer une demande de collecteécrit

Enregistre une demande de collecte (une enquête) d'un client, afin que le bureau puisse établir un devis. Répond avec ce qui manque encore si un élément obligatoire est absent, et n'écrit rien.

company_name	obligatoire	L'entreprise qui demande
contact_name	obligatoire	Qui a pris contact
contact_email	obligatoire	Leur adresse e-mail
contact_phone	obligatoire	Leur numéro de téléphone
site_address	obligatoire	Où se trouvent les déchets
postcode	facultatif	Code postal de cette adresse
waste_description	obligatoire	Ce que sont les déchets, selon leurs mots
service_type	facultatif	Ce qu'ils demandent, par exemple une benne ou une charge à grappin
estimated_weight	facultatif	Approximativement combien, en tonnes
preferred_date	facultatif	Quand ils le souhaiteraient (AAAA-MM-JJ)
access_notes	facultatif	Tout ce qui concerne l'accès au site

Écriture

Les 6 outils create_ ajoutent un client, un site de réception, un transporteur ou courtier, un véhicule, un conducteur et une demande de collecte. C'est ainsi que quelqu'un introduit des données dans LoadSnap en les décrivant dans une conversation plutôt qu'en remplissant un formulaire ou en préparant une feuille de calcul.

Rien n'est jamais écrit à moitié. Un appel auquel il manque un élément obligatoire n'écrit rien du tout et répond avec la liste de ce qui manque encore, formulée sous forme de questions, afin que l'assistant le demande et rappelle. Un appel pour un enregistrement qui existe déjà renvoie l'enregistrement existant plutôt que d'en créer un second, donc exécuter deux fois la même demande ne peut pas laisser de doublon.

Un conducteur ajouté de cette façon utilise l'une des autorisations de conducteur du plan et est refusé lorsqu'elles sont toutes utilisées, exactement comme sur la page Équipe, et est mis en correspondance avec les personnes déjà membres de l'équipe afin que quelqu'un qui y travaille déjà voie l'application conducteur ajoutée à son dossier existant. Personne ne reçoit d'accès de connexion au bureau : c'est un siège payant et un accès à l'entreprise, et il est attribué sur Équipe par un propriétaire ou un administrateur.

Le dépôt auprès de la DEFRA, la signature d'un bordereau de transfert, l'émission d'une facture et la suppression de quoi que ce soit sont délibérément absents ici. Ce sont des actions qu'une personne effectue dans LoadSnap, avec son nom dessus.

Panneau interactif

Le serveur publie un panneau interactif en tant que ressource MCP à ui://loadsnap/panel, et chaque outil y pointe. Un client qui prend en charge l'extension d'applications affiche la réponse sous forme de panneau dans la conversation : un tableau d'enregistrements, une carte pour l'enregistrement tout juste ajouté, ou une liste de contrôle de ce qui manque encore avant que quelque chose puisse être enregistré.

C'est un document autonome sans données propres, sans jeton et sans rien récupéré depuis le réseau. Le client transmet la réponse de l'outil dans ce document. Chaque outil renvoie également cette réponse sous forme de texte, donc un client qui n'affiche pas de panneaux montre exactement ce qu'il montrait toujours.

Limites et formats

Les poids sont renvoyés en kilogrammes, sauf si un nom de champ indique des tonnes. Les dates sont au format ISO (AAAA-MM-JJ). Une recherche renvoie les 25 correspondances les plus pertinentes ; count_movements lit jusqu'à 1 000 lignes et signale count_is_capped lorsqu'il atteint ce plafond, donc un chiffre plafonné n'est jamais présenté comme un total exact. Il en va de même pour l'argent dû sur find_invoices, qui signale totals_are_capped. Les enregistrements créés comme exemples sont exclus de chaque résultat.

Exigences

Un compte LoadSnap au plan Pro ou supérieur, et une connexion appartenant à une organisation LoadSnap. Chaque personne qui se connecte utilise sa propre connexion, car la connexion est autorisée en son nom.

Des questions sur le connecteur ? Envoyez un e-mail à info@loadsnap.co.uk, ou lisez la vue d'ensemble du connecteur.