LoadSnap

MCP-Server-Referenz

Alles, was nötig ist, um einen KI-Assistenten mit einem LoadSnap-Konto zu verbinden, und was er nach der Verbindung lesen kann.

Endpunkt

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

Ein Remote-Model-Context-Protocol-Server, der den Streamable-HTTP-Transport verwendet: JSON-RPC 2.0 über ein einzelnes POST. Der Server ist zustandslos, es gibt also keinen Session-Header und keinen vom Server initiierten Ereignisstrom, und ein GET gibt 405 zurück.

Fügen Sie ihn zu Claude, Claude Code, ChatGPT, Cursor oder einem anderen MCP-kompatiblen Client als benutzerdefinierten oder Remote-Connector hinzu, und verwenden Sie diese URL. Es gibt keinen API-Schlüssel zum Einfügen.

Authentifizierung

OAuth 2.1: Autorisierungscode mit PKCE, plus Dynamic Client Registration, sodass sich ein Client ohne manuelle Einrichtung selbst anmeldet. Die Erkennung funktioniert auf die übliche Weise: Eine nicht authentifizierte Anfrage gibt 401 mit einem WWW-Authenticate-Header zurück, der auf die Metadaten der geschützten Ressource verweist.

Metadaten der geschützten Ressource	/.well-known/oauth-protected-resource
Metadaten des Autorisierungsservers	/.well-known/oauth-authorization-server
Dynamische Client-Registrierung	/api/oauth/register
Autorisierung	/oauth/authorize
Token	/api/oauth/token

Die Person meldet sich bei LoadSnap an und genehmigt die Verbindung auf einem Bildschirm, der den Client und ihre Organisation nennt. Zugriffstokens halten eine Stunde und werden mit einem Refresh-Token erneuert, sodass die Verbindung ohne erneute Anmeldung weiter funktioniert.

Der Zugriff wird als Person autorisiert, nicht als Schlüssel. Organisationsmitgliedschaft und Plan werden bei jeder Anfrage erneut geprüft. Wenn also jemand aus einer Organisation entfernt wird, endet damit auch sein Connector-Zugriff.

Zugriffsumfang

Jede Abfrage ist hart auf die Organisation des autorisierten Benutzers gefiltert, die serverseitig aus dem Token aufgelöst wird. Der Client liefert niemals eine Organisation, sodass er keine Daten eines anderen Unternehmens anfordern kann. Zeilenebenen-Sicherheit erzwingt dieselbe Grenze in der darunterliegenden Datenbank.

15 der 21 Tools lesen nur. Die 6, deren Namen mit create_ beginnen, fügen einen Datensatz hinzu und sonst nichts: Keines bearbeitet, löscht, meldet an DEFRA, unterschreibt einen Transfernote, stellt eine Rechnung aus oder vergibt einen Büro-Login. Jedes ist in seinen Annotationen als schreibend markiert, sodass ein Client die Person fragt, bevor es eines ausführt.

Die eine Ausnahme von der Organisationsbegrenzung ist find_waste_codes, das den veröffentlichten Europäischen Abfallkatalog durchsucht – dieselbe nationale Liste für alle und niemandes eigene Daten.

Tools

21 Tools, jedes auf die autorisierte Organisation begrenzt. Jedes ist unten mit der Beschreibung aufgeführt, die ein Client erhält, und den Argumenten, die es akzeptiert. Ein als schreibend markiertes Tool fügt einen Datensatz hinzu; der Rest liest nur.

find_movements

Abfallbewegungen finden

Abfallbewegungsdatensätze (Waste Transfer Notes) und Aufträge dieser Organisation auflisten oder durchsuchen, nach Erzeuger-, Kunden- oder Beförderername und/oder einem Abholdatumsbereich. Verwenden Sie dies für „Haben wir Bewegungen für X durchgeführt“, „Was haben wir im Mai von Y gesammelt“ oder „Was haben wir letzte Woche bewegt“ ohne Namen.

name	optional	Erzeuger-, Kunden- oder Beförderername, nach dem gesucht werden soll. Weglassen, um alles im Datumsbereich aufzulisten.
date_from	optional	Optionales ISO-Datum (JJJJ-MM-TT) als untere Grenze
date_to	optional	Optionales ISO-Datum (JJJJ-MM-TT) als obere Grenze

find_receipts

Eingangsbelege finden

Eingangsbelege dieser Organisation (Abfall, der an ihrem eigenen Standort ankommt) auflisten oder durchsuchen, nach Beförderer- oder Erzeugername und/oder einem Eingangsdatumsbereich. Den Namen weglassen, um alles im Bereich aufzulisten.

name	optional	Beförderer- oder Erzeugername. Weglassen, um alle aufzulisten.
date_from	optional	Optionales ISO-Datum (JJJJ-MM-TT) als untere Grenze
date_to	optional	Optionales ISO-Datum (JJJJ-MM-TT) als obere Grenze

count_movements

Abfallbewegungen zählen

Abfallbewegungen dieser Organisation über einen Datumsbereich zählen und ihr Gewicht summieren, optional aufgeteilt nach eingehend oder ausgehend. Verwenden Sie dies für „Wie viele Ladungen haben wir letzten Monat gemacht“, „Wie viel Abfall haben wir dieses Jahr behandelt“, „Wie viele Abholungen diese Woche“. Zählt nach Abholdatum.

date_from	optional	ISO-Datum (JJJJ-MM-TT) als untere Grenze für das Abholdatum
date_to	optional	ISO-Datum (JJJJ-MM-TT) als obere Grenze für das Abholdatum
direction	optional	inbound = Abfall, der am eigenen Standort dieser Organisation angenommen wurde, outbound = Abfall, den ihr LKW weggebracht oder versendet hat. Weglassen für alle.

defra_filings

DEFRA-Meldungen

DEFRA-Abfallverfolgungsübermittlungen dieser Organisation über einen Datumsbereich zählen und auflisten, und die Datensätze auflisten, die noch auf die Meldung warten. Verwenden Sie dies für „Wie viele DEFRA-Übermittlungen haben wir diese Woche eingereicht“, „Ist etwas bei DEFRA fehlgeschlagen“, „Was ist noch offen“.

date_from	optional	ISO-Datum (JJJJ-MM-TT) als untere Grenze für das Übermittlungsdatum
date_to	optional	ISO-Datum (JJJJ-MM-TT) als obere Grenze für das Übermittlungsdatum
include_outstanding	optional	Gibt auch die Datensätze zurück, die noch nicht bei DEFRA eingereicht wurden. Standard ist true.

find_parties

Beförderer und Standorte finden

Einen Firmen- oder Standortnamen zu den bekannten Beförderern und Standorten der Organisation auflösen.

name	erforderlich	Firmen- oder Standortname

find_jobs

Geplante Aufträge finden

Aufträge dieser Organisation auflisten oder durchsuchen – gebuchte, laufende oder abgeschlossene Arbeiten – nach Kundennamen und/oder einem geplanten Datumsbereich. Verwenden Sie dies für „Was machen wir morgen“, „Ist der Carter-Auftrag gebucht“, „Was ist noch nicht zugewiesen“. Liest vorwärts ab dem frühesten Datum, weil eine Auftragsliste ein Tagebuch ist.

name	optional	Kundennamen, nach dem gesucht werden soll. Weglassen, um alles im Bereich aufzulisten.
status	optional	Auftragsstatus, nach dem gefiltert werden soll, z. B. draft, scheduled, in_progress, completed, cancelled.
date_from	optional	Optionales ISO-Datum (JJJJ-MM-TT) als untere Grenze
date_to	optional	Optionales ISO-Datum (JJJJ-MM-TT) als obere Grenze

find_invoices

Rechnungen und geschuldete Beträge

Rechnungen dieser Organisation auflisten und summieren, was noch geschuldet ist, optional nur die unbezahlten. Verwenden Sie dies für „Wer schuldet uns Geld“, „Wie viel ist offen“, „Ist die Carter-Rechnung bezahlt“, „Was ist überfällig“. Summen sind in der Rechnungswährung.

name	optional	Name des Unternehmens, an das die Rechnung gestellt wurde. Weglassen, um alles im Bereich aufzulisten.
status	optional	Rechnungsstatus, nach dem gefiltert werden soll, z. B. draft, issued, paid, void.
only_unpaid	optional	Nur Rechnungen mit einem noch zu zahlenden Saldo. Standard ist false.
date_from	optional	Optionales ISO-Datum (JJJJ-MM-TT) als untere Grenze
date_to	optional	Optionales ISO-Datum (JJJJ-MM-TT) als obere Grenze

find_vehicles

Fahrzeuge und ihre Papiere

Fahrzeuge dieser Organisation mit ihrem MOT-, Steuer- und Versicherungsablauf auflisten und alle kennzeichnen, die abgelaufen sind. Verwenden Sie dies für „Was ist in der Flotte“, „Ist etwas ohne MOT“, „Wann ist die Steuer für VX19 ABC fällig“. MOT und Steuer kommen von der DVLA und sind nur so aktuell wie die letzte Prüfung.

name	optional	Kennzeichen oder Beschreibung, nach der gesucht werden soll. Weglassen, um alles im Bereich aufzulisten.
include_inactive	optional	Gibt auch Fahrzeuge zurück, die aus der Flotte genommen wurden. Standard ist false.

find_people

Das Team und was es nutzen kann

Die Personen im Team dieser Organisation auflisten und welche der drei Zugangswege jede hat: ein Büro-Login, die Fahrer-App, die Waagen-App. Verwenden Sie dies für „Wer fährt für uns“, „Hat Dave die Fahrer-App“, „Wer ist im Team“.

name	optional	Name oder E-Mail einer Person, nach der gesucht werden soll. Weglassen, um alles im Bereich aufzulisten.
drivers_only	optional	Nur Personen mit der Fahrer-App. Standard ist false.

compliance_status

Zertifikate, Genehmigungen und Registrierungen

Die Zertifikate, Genehmigungen und Registrierungen auflisten, die diese Organisation erfasst hat, mit ihren Ablaufdaten, und sagen, welche bereits abgelaufen sind. Verwenden Sie dies für „Ist unsere Abfallbeförderer-Registrierung noch gültig“, „Was läuft dieses Jahr ab“, „Haben wir ein ISO-Zertifikat in den Unterlagen“.

expired_only	optional	Nur die bereits abgelaufenen. Standard ist false.

find_documents

Ein Dokument finden

Gespeicherte Dokumente dieser Organisation finden – Abfalltransfernotizen, Konsignationsnotizen, Genehmigungen, hochgeladene Unterlagen – nach Typ und/oder Datum, mit einem Link zu jedem. Verwenden Sie dies für „Senden Sie mir die Transfernote für diese Ladung“, „Welche Unterlagen haben wir zu diesem Auftrag“.

document_type	optional	Dokumenttyp, nach dem gefiltert werden soll, z. B. wtn, hwcn, annex_vii, permit, upload.
movement_id	optional	Nur Dokumente, die an dieser Abfallbewegung hängen.
job_id	optional	Nur Dokumente, die an diesem Auftrag hängen.
date_from	optional	Optionales ISO-Datum (JJJJ-MM-TT) als untere Grenze
date_to	optional	Optionales ISO-Datum (JJJJ-MM-TT) als obere Grenze

container_stock

Container und Mulden

Welche Container diese Organisation hält und wo sie sind: die einzeln mit einer Asset-Nummer und einem Zustand verfolgten sowie die Typen, die als laufende Summe geführt werden. Verwenden Sie dies für „Wie viele 8-Yard-Mulden haben wir frei“, „Wo ist Mulde 214“, „Was ist vermietet“.

container_type	optional	Containertyp, nach dem gefiltert werden soll, z. B. skip, roro, bin.
container_size	optional	Containergröße, nach der gefiltert werden soll, z. B. 8yd.
state	optional	Zustand eines einzeln verfolgten Containers, z. B. in_yard, on_site, in_transit.

find_contracts

Verträge und Saisonkarten

Die laufenden Vereinbarungen dieser Organisation auflisten: Verträge und Saisonkarten, welchen Abfall jede abdeckt, die Laufzeit und ob beide Seiten unterschrieben haben. Verwenden Sie dies für „Was haben wir unter Vertrag“, „Ist diese Saisonkarte unterschrieben“, „Was läuft diesen Monat aus“.

site_id	optional	Nur Vereinbarungen für diesen Standort.
active_only	optional	Nur noch gültige Vereinbarungen. Standard ist false.

consignee_returns

Vierteljährliche Empfängermeldungen

Die vierteljährlichen Empfängermeldungen dieser Organisation für erhaltenen gefährlichen Abfall: das Quartal, was wann fällig ist, wie viele Sendungen und welches Gewicht, und ob es gesendet wurde. Verwenden Sie dies für „Ist unsere Empfängermeldung erledigt“, „Was ist dieses Quartal fällig“. Nur für Empfänger; ein Beförderer hat keine.

quarter	optional	Eine Quartalsbezeichnung, z. B. „Q1 2026“.
status	optional	Status, nach dem gefiltert werden soll: not_started, generated, reviewed oder submitted.

find_waste_codes

Einen Abfallcode nachschlagen

Den Europäischen Abfallkatalog (EWC) nach Code oder nach dem, was der Abfall ist, durchsuchen und sagen, ob jeder Code gefährlich oder ein Spiegel-Eintrag ist. Verwenden Sie dies für „Welcher Code ist Gipskarton“, „Ist 17 05 03 gefährlich“. Dies ist die veröffentlichte nationale Liste, nicht die eigenen Daten dieser Organisation.

query	erforderlich	Ein Code oder ein Teil davon („17 05“) oder Wörter, die den Abfall beschreiben („Gipskarton“).
hazardous_only	optional	Nur gefährliche Codes. Standard ist false.

create_customer

Einen Kunden hinzufügenschreibend

Einen Kunden hinzufügen (einen Sammelstandort, von dem die Organisation Abfall sammelt). Antwortet mit dem, was noch benötigt wird, wenn etwas Erforderliches fehlt, und schreibt nichts. Wenn ein Kunde mit diesem Namen und dieser Postleitzahl bereits existiert, wird dieser zurückgegeben, statt einen zweiten anzulegen.

name	erforderlich	Das Unternehmen oder die Person, dem/der der Abfall gehört
address	erforderlich	Wo der Abfall gesammelt wird
postcode	erforderlich	Postleitzahl der Sammeladresse
producer_type	optional	Ob der Abfall von einem Unternehmen oder einem Haushalt stammt. Standard ist business.
contact_name	erforderlich	Wen man vor Ort fragen soll
contact_email	optional	Ihre E-Mail-Adresse
contact_phone	optional	Ihre Telefonnummer
sic_code	optional	Der SIC-Code des Erzeugers, falls bekannt

create_receiving_site

Einen Annahmestandort hinzufügenschreibend

Einen Annahmestandort hinzufügen (eine Deponie, Umladestation oder Recyclinganlage, zu der Abfall gebracht wird). Antwortet mit dem, was noch benötigt wird, wenn etwas Erforderliches fehlt, und schreibt nichts.

name	required	Der Name der Anlage
address	required	Die Adresse der Anlage
postcode	required	Postleitzahl der Anlage
permit_number	optional	Umweltgenehmigungs- oder Ausnahmenummer
contact_name	optional	Ansprechpartner am Tor
contact_email	optional	Deren E-Mail-Adresse
contact_phone	optional	Deren Telefonnummer
is_own_site	optional	Nur wahr, wenn dies die eigene Anlage der Organisation ist und nicht die eines anderen. Standardmäßig falsch.

create_carrier

Einen Entsorger oder Makler hinzufügenschreibt

Fügt einen Entsorger, Makler oder Händler hinzu, mit dem die Organisation zusammenarbeitet. Antwortet mit dem, was noch benötigt wird, wenn etwas Pflichtfeld fehlt, und schreibt nichts.

company_name	required	Firmenname des Entsorgers oder Maklers
registration_number	optional	Deren Abfallentsorgungs-Registrierungsnummer, falls bekannt
contact_name	optional	Ansprechpartner
contact_email	optional	Deren E-Mail-Adresse
contact_phone	optional	Deren Telefonnummer
address	optional	Deren Adresse
postcode	optional	Deren Postleitzahl
notes	optional	Alles, was es wert ist, über sie festgehalten zu werden

create_vehicle

Ein Fahrzeug hinzufügenschreibt

Fügt ein Fahrzeug zur Flotte hinzu. Antwortet mit dem, was noch benötigt wird, wenn etwas Pflichtfeld fehlt, und schreibt nichts. Ein bereits in der Flotte vorhandenes Kennzeichen gibt dieses Fahrzeug zurück, anstatt ein zweites anzulegen.

registration	required	Das Kennzeichen
make	optional	Wer es hergestellt hat
description	optional	Modell oder Beschreibung
vehicle_type	optional	Um welche Art von Fahrzeug es sich handelt, z. B. Absetzkipper oder Kipper
mot_expiry	optional	Wann die HU abläuft (JJJJ-MM-TT)
tax_expiry	optional	Wann die Steuer abläuft (JJJJ-MM-TT)
max_weight_tonnes	optional	Gesamtgewicht in Tonnen

create_driver

Einen Fahrer hinzufügenschreibt

Fügt einen Fahrer hinzu, damit ihm Aufträge zugewiesen werden können und er Übernahmescheine in der Fahrer-App unterschreiben kann. Verwendet eine der Fahrerkontingente des Tarifs und lehnt ab, wenn alle aufgebraucht sind. Vergibt niemandem einen Büro-Login: Dieser wird auf der Team-Seite von einem Eigentümer oder Administrator ausgegeben. Jemand, der bereits im Team ist, erhält die Fahrer-App zu seinem vorhandenen Datensatz hinzugefügt.

name	required	Deren vollständiger Name
email	required	Deren E-Mail-Adresse, an die die Einladung zur Fahrer-App geht
phone_number	optional	Deren Telefonnummer
role	optional	Was sie tun, z. B. LKW-Fahrer
address	optional	Deren Privatadresse
postcode	optional	Deren private Postleitzahl
licence_expiry	optional	Wann deren Führerschein abläuft (JJJJ-MM-TT)
emergency_contact_name	optional	Wen man im Notfall anrufen soll
emergency_contact_phone	optional	Die Telefonnummer dieser Person

create_enquiry

Eine Abholanfrage protokollierenschreibt

Protokolliert eine Abholanfrage (eine Anfrage) von einem Kunden, damit das Büro ein Angebot erstellen kann. Antwortet mit dem, was noch benötigt wird, wenn etwas Pflichtfeld fehlt, und schreibt nichts.

company_name	required	Das anfragende Unternehmen
contact_name	required	Wer Kontakt aufgenommen hat
contact_email	required	Deren E-Mail-Adresse
contact_phone	required	Deren Telefonnummer
site_address	required	Wo der Abfall liegt
postcode	optional	Postleitzahl dieser Adresse
waste_description	required	Was der Abfall ist, in deren Worten
service_type	optional	Was sie anfragen, z. B. ein Container oder eine Greiferladung
estimated_weight	optional	Ungefähr wie viel, in Tonnen
preferred_date	optional	Wann sie es gerne hätten (JJJJ-MM-TT)
access_notes	optional	Alles über den Zugang zur Anlage

Schreiben

Die 6 create_-Tools fügen einen Kunden, eine Annahmeanlage, einen Entsorger oder Makler, ein Fahrzeug, einen Fahrer und eine Abholanfrage hinzu. So gelangen Daten in LoadSnap, indem jemand sie in einem Gespräch beschreibt, anstatt ein Formular auszufüllen oder eine Tabelle vorzubereiten.

Es wird nie etwas halb geschrieben. Ein Aufruf, dem etwas Pflichtfeld fehlt, schreibt überhaupt nichts und antwortet mit der Liste dessen, was noch benötigt wird, als Fragen formuliert, damit der Assistent danach fragt und erneut aufruft. Ein Aufruf für einen Datensatz, der bereits existiert, gibt den vorhandenen Datensatz zurück, anstatt einen zweiten anzulegen, sodass eine doppelte Ausführung derselben Anfrage kein Duplikat hinterlassen kann.

Ein auf diese Weise hinzugefügter Fahrer verwendet eines der Fahrerkontingente des Tarifs und wird abgelehnt, wenn alle aufgebraucht sind, genau wie auf der Team-Seite, und wird mit den bereits im Team befindlichen Personen abgeglichen, sodass jemand, der dort bereits arbeitet, die Fahrer-App zu seinem vorhandenen Datensatz erhält. Niemandem wird ein Büro-Login gegeben: Das ist ein kostenpflichtiger Platz und ein Zugang zum Unternehmen, und er wird auf Team von einem Eigentümer oder Administrator ausgegeben.

Die Meldung an DEFRA, das Unterschreiben eines Übernahmescheins, das Erstellen einer Rechnung und das Löschen von etwas sind bewusst nicht hier. Das sind Dinge, die eine Person in LoadSnap tut, mit ihrem Namen darauf.

Interaktives Panel

Der Server veröffentlicht ein interaktives Panel als MCP-Ressource unter ui://loadsnap/panel, und jedes Tool verweist darauf. Ein Client, der die Apps-Erweiterung unterstützt, zeichnet die Antwort als Panel im Gespräch: eine Tabelle von Datensätzen, eine Karte für den gerade hinzugefügten Datensatz oder eine Checkliste dessen, was noch benötigt wird, bevor etwas gespeichert werden kann.

Es ist ein eigenständiges Dokument ohne eigene Daten, ohne Token und ohne etwas, das aus dem Netzwerk geholt wird. Der Client übergibt die Antwort des Tools hinein. Jedes Tool gibt diese Antwort auch als Text zurück, sodass ein Client, der keine Panels zeichnet, genau das zeigt, was er immer gezeigt hat.

Grenzen und Formate

Gewichte werden in Kilogramm zurückgegeben, es sei denn, ein Feldname sagt Tonnen. Daten sind im ISO-Format (JJJJ-MM-TT). Eine Suche gibt die 25 relevantesten Treffer zurück; count_movements liest bis zu 1.000 Zeilen und meldet count_is_capped, wenn diese Obergrenze erreicht wird, sodass eine gedeckelte Zahl nie als exakte Gesamtsumme dargestellt wird. Dasselbe gilt für den geschuldeten Betrag bei find_invoices, das totals_are_capped meldet. Als Beispieldaten angelegte Datensätze werden aus jedem Ergebnis ausgeschlossen.

Anforderungen

Ein LoadSnap-Konto im Pro-Tarif oder höher und ein Login, das zu einer LoadSnap-Organisation gehört. Jeder, der sich verbindet, verwendet sein eigenes Login, da die Verbindung als diese Person autorisiert ist.

Fragen zum Connector? E-Mail an info@loadsnap.co.uk, oder lesen Sie die Connector-Übersicht.