LoadSnap

Referensi server MCP

Semua yang diperlukan untuk menghubungkan asisten AI ke akun LoadSnap, dan apa yang dapat dibaca setelah terhubung.

Endpoint

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

Server Model Context Protocol jarak jauh yang menggunakan transport Streamable HTTP: JSON-RPC 2.0 melalui satu POST. Server bersifat stateless, sehingga tidak ada header sesi dan tidak ada aliran peristiwa yang diprakarsai server, dan GET mengembalikan 405.

Tambahkan ke Claude, Claude Code, ChatGPT, Cursor, atau klien lain yang kompatibel dengan MCP sebagai konektor khusus atau jarak jauh, menggunakan URL tersebut. Tidak ada kunci API yang perlu ditempel.

Autentikasi

OAuth 2.1: kode otorisasi dengan PKCE, plus Dynamic Client Registration, sehingga klien mendaftarkan dirinya sendiri tanpa pengaturan manual. Penemuan berfungsi dengan cara biasa, permintaan tidak terautentikasi yang mengembalikan 401 dengan header WWW-Authenticate yang menunjuk ke metadata sumber daya yang dilindungi.

Metadata sumber daya yang dilindungi	/.well-known/oauth-protected-resource
Metadata server otorisasi	/.well-known/oauth-authorization-server
Pendaftaran klien dinamis	/api/oauth/register
Otorisasi	/oauth/authorize
Token	/api/oauth/token

Orang tersebut masuk ke LoadSnap dan menyetujui koneksi di layar yang menyebutkan nama klien dan organisasi mereka. Token akses bertahan selama satu jam dan diperbarui dengan token penyegaran, sehingga koneksi tetap berfungsi tanpa masuk lagi.

Akses diotorisasi sebagai orang, bukan sebagai kunci. Keanggotaan organisasi dan paket diperiksa ulang pada setiap permintaan, sehingga menghapus seseorang dari organisasi mengakhiri akses konektor mereka.

Cakupan akses

Setiap kueri difilter secara ketat ke organisasi pengguna yang diotorisasi, diselesaikan di sisi server dari token. Klien tidak pernah menyediakan organisasi, sehingga tidak dapat meminta data perusahaan lain. Keamanan tingkat baris memberlakukan batas yang sama di database yang mendasarinya.

15 dari 21 alat hanya membaca. 6 yang namanya diawali dengan create_ menambahkan catatan dan tidak melakukan apa pun lainnya: tidak ada yang mengedit, menghapus, mengajukan ke DEFRA, menandatangani nota transfer, menerbitkan faktur, atau memberikan login kantor. Masing-masing ditandai sebagai menulis dalam anotasinya, sehingga klien meminta izin orang tersebut sebelum menjalankannya.

Satu-satunya pengecualian untuk cakupan organisasi adalah find_waste_codes, yang mencari Katalog Limbah Eropa yang diterbitkan — daftar nasional yang sama untuk semua orang, dan bukan data milik siapa pun.

Alat

21 alat, masing-masing dicakup ke organisasi yang diotorisasi. Setiap alat tercantum di bawah dengan deskripsi yang diberikan kepada klien dan argumen yang diterimanya. Alat yang ditandai menulis menambahkan catatan; sisanya hanya membaca.

find_movements

Temukan perpindahan limbah

Daftar atau cari catatan perpindahan limbah organisasi ini (Nota Transfer Limbah) dan pekerjaan, berdasarkan nama produsen, pelanggan, atau pengangkut dan/atau rentang tanggal pengumpulan. Gunakan ini untuk 'apakah kita melakukan perpindahan untuk X', 'apa yang kita kumpulkan dari Y pada bulan Mei', atau 'apa yang kita pindahkan minggu lalu' tanpa nama sama sekali.

name	opsional	Nama produsen, pelanggan, atau pengangkut untuk dicari. Lewati untuk mendaftar semua dalam rentang tanggal.
date_from	opsional	Batas bawah tanggal ISO opsional (YYYY-MM-DD)
date_to	opsional	Batas atas tanggal ISO opsional (YYYY-MM-DD)

find_receipts

Temukan tanda terima masuk

Daftar atau cari tanda terima masuk organisasi ini (limbah yang tiba di situs mereka sendiri) berdasarkan nama pengangkut atau produsen dan/atau rentang tanggal diterima. Lewati nama untuk mendaftar semua yang diterima dalam rentang.

name	opsional	Nama pengangkut atau produsen. Lewati untuk mendaftar semua.
date_from	opsional	Batas bawah tanggal ISO opsional (YYYY-MM-DD)
date_to	opsional	Batas atas tanggal ISO opsional (YYYY-MM-DD)

count_movements

Hitung perpindahan limbah

Hitung perpindahan limbah organisasi ini selama rentang tanggal dan total beratnya, opsional dipecah menjadi masuk atau keluar. Gunakan ini untuk 'berapa banyak muatan yang kita lakukan bulan lalu', 'berapa banyak limbah yang kita tangani tahun ini', 'berapa banyak koleksi minggu ini'. Dihitung berdasarkan tanggal pengumpulan.

date_from	opsional	Batas bawah tanggal ISO (YYYY-MM-DD) pada tanggal pengumpulan
date_to	opsional	Batas atas tanggal ISO (YYYY-MM-DD) pada tanggal pengumpulan
direction	opsional	inbound = limbah yang diterima di situs organisasi ini sendiri, outbound = limbah yang diangkut truknya atau dikirim keluar. Lewati untuk semua.

defra_filings

Pengajuan DEFRA

Hitung dan daftar pengajuan pelacakan limbah DEFRA organisasi ini selama rentang tanggal, dan daftar catatan yang masih menunggu untuk diajukan. Gunakan ini untuk 'berapa banyak pengajuan DEFRA yang telah kita ajukan minggu ini', 'apakah ada yang gagal dengan DEFRA', 'apa yang masih belum selesai'.

date_from	opsional	Batas bawah tanggal ISO (YYYY-MM-DD) pada tanggal pengajuan
date_to	opsional	Batas atas tanggal ISO (YYYY-MM-DD) pada tanggal pengajuan
include_outstanding	opsional	Juga kembalikan catatan yang belum diajukan ke DEFRA. Defaultnya true.

find_parties

Temukan pengangkut dan situs

Selesaikan nama perusahaan atau situs ke pengangkut dan situs yang dikenal organisasi.

name	wajib	Nama perusahaan atau situs

find_jobs

Temukan pekerjaan terjadwal

Daftar atau cari pekerjaan organisasi ini — pekerjaan yang dipesan, sedang berlangsung, atau selesai — berdasarkan nama pelanggan dan/atau rentang tanggal terjadwal. Gunakan ini untuk 'apa yang kita lakukan besok', 'apakah pekerjaan Carter sudah dipesan', 'apa yang masih belum dialokasikan'. Membaca maju dari tanggal paling awal, karena daftar pekerjaan adalah buku harian.

name	opsional	Nama pelanggan untuk dicari. Lewati untuk mendaftar semua dalam rentang.
status	opsional	Status pekerjaan untuk difilter, misalnya draft, scheduled, in_progress, completed, cancelled.
date_from	opsional	Batas bawah tanggal ISO opsional (YYYY-MM-DD)
date_to	opsional	Batas atas tanggal ISO opsional (YYYY-MM-DD)

find_invoices

Faktur dan uang yang terutang

Daftar faktur organisasi ini dan total yang masih terutang, opsional hanya yang belum dibayar. Gunakan ini untuk 'siapa yang berutang uang kepada kita', 'berapa yang masih terutang', 'apakah faktur Carter sudah dibayar', 'apa yang terlambat'. Total dalam mata uang faktur.

name	opsional	Nama bisnis yang ditagih faktur. Lewati untuk mendaftar semua dalam rentang.
status	opsional	Status faktur untuk difilter, misalnya draft, issued, paid, void.
only_unpaid	opsional	Hanya faktur dengan saldo yang masih harus dibayar. Defaultnya false.
date_from	opsional	Batas bawah tanggal ISO opsional (YYYY-MM-DD)
date_to	opsional	Batas atas tanggal ISO opsional (YYYY-MM-DD)

find_vehicles

Kendaraan dan dokumennya

Daftar kendaraan organisasi ini dengan masa berlaku MOT, pajak, dan asuransi, dan tandai yang sudah habis. Gunakan ini untuk 'apa yang ada di armada', 'apakah ada yang lewat MOT', 'kapan pajak jatuh tempo untuk VX19 ABC'. MOT dan pajak berasal dari DVLA dan hanya segar sejak pemeriksaan terakhir.

name	opsional	Registrasi atau deskripsi untuk dicari. Lewati untuk mendaftar semua dalam rentang.
include_inactive	opsional	Juga kembalikan kendaraan yang dikeluarkan dari armada. Defaultnya false.

find_people

Tim dan apa yang bisa mereka gunakan

Daftar orang di tim organisasi ini dan mana dari tiga cara masuk yang dimiliki masing-masing: login kantor, aplikasi pengemudi, aplikasi jembatan timbang. Gunakan ini untuk 'siapa yang mengemudi untuk kita', 'apakah Dave punya aplikasi pengemudi', 'siapa yang ada di tim'.

name	opsional	Nama atau email orang untuk dicari. Lewati untuk mendaftar semua dalam rentang.
drivers_only	opsional	Hanya orang yang memiliki aplikasi pengemudi. Defaultnya false.

compliance_status

Sertifikat, izin, dan registrasi

Daftar sertifikat, izin, dan registrasi yang dicatat organisasi ini, dengan tanggal kedaluwarsanya, dan sebutkan mana yang sudah habis. Gunakan ini untuk 'apakah registrasi pengangkut limbah kita masih berlaku', 'apa yang kedaluwarsa tahun ini', 'apakah kita punya sertifikat ISO di file'.

expired_only	opsional	Hanya yang sudah kedaluwarsa. Defaultnya false.

find_documents

Temukan dokumen

Temukan dokumen tersimpan organisasi ini — nota transfer limbah, nota konsinyasi, izin, dokumen yang diunggah — berdasarkan jenis dan/atau tanggal, dengan tautan ke masing-masing. Gunakan ini untuk 'kirimkan saya nota transfer untuk muatan itu', 'dokumen apa yang kita punya untuk pekerjaan ini'.

document_type	opsional	Jenis dokumen untuk difilter, misalnya wtn, hwcn, annex_vii, permit, upload.
movement_id	opsional	Hanya dokumen yang dilampirkan ke perpindahan limbah ini.
job_id	opsional	Hanya dokumen yang dilampirkan ke pekerjaan ini.
date_from	opsional	Batas bawah tanggal ISO opsional (YYYY-MM-DD)
date_to	opsional	Batas atas tanggal ISO opsional (YYYY-MM-DD)

container_stock

Skip dan kontainer

Kontainer apa yang dimiliki organisasi ini dan di mana lokasinya: yang dilacak satu per satu dengan nomor aset dan status, dan jenis yang dipegang sebagai total berjalan. Gunakan ini untuk 'berapa banyak skip 8 yard yang kita punya gratis', 'di mana skip 214', 'apa yang disewakan'.

container_type	opsional	Jenis kontainer untuk difilter, misalnya skip, roro, bin.
container_size	opsional	Ukuran kontainer untuk difilter, misalnya 8yd.
state	opsional	Status kontainer yang dilacak secara individual, misalnya in_yard, on_site, in_transit.

find_contracts

Kontrak dan tiket musiman

Daftar perjanjian tetap organisasi ini: kontrak dan tiket musiman, limbah apa yang dicakup masing-masing, tanggal berlakunya, dan apakah kedua belah pihak telah menandatangani. Gunakan ini untuk 'apa yang kita punya dalam kontrak', 'apakah tiket musiman itu sudah ditandatangani', 'apa yang berakhir bulan ini'.

site_id	opsional	Hanya perjanjian untuk situs ini.
active_only	opsional	Hanya perjanjian yang masih berlaku. Defaultnya false.

consignee_returns

Pengembalian konsinyi triwulanan

Pengembalian konsinyi triwulanan organisasi ini untuk limbah berbahaya yang diterima: triwulan, apa yang jatuh tempo kapan, berapa banyak konsinyasi dan berapa beratnya, dan apakah sudah dikirim. Gunakan ini untuk 'apakah pengembalian konsinyi kita selesai', 'apa yang jatuh tempo triwulan ini'. Hanya penerima; pengangkut tidak punya.

quarter	opsional	Label triwulan, misalnya "Q1 2026".
status	opsional	Status untuk difilter: not_started, generated, reviewed, atau submitted.

find_waste_codes

Cari kode limbah

Cari Katalog Limbah Eropa (EWC) berdasarkan kode atau berdasarkan jenis limbahnya, dan sebutkan apakah setiap kode berbahaya atau entri cermin. Gunakan ini untuk 'kode apa untuk papan gipsum', 'apakah 17 05 03 berbahaya'. Ini adalah daftar nasional yang diterbitkan, bukan data organisasi ini sendiri.

query	wajib	Kode atau bagian dari kode ("17 05"), atau kata yang menggambarkan limbah ("papan gipsum").
hazardous_only	opsional	Hanya kode berbahaya. Defaultnya false.

create_customer

Tambah pelangganmenulis

Tambah pelanggan (situs pengumpulan tempat organisasi mengumpulkan limbah). Menjawab dengan apa yang masih diperlukan jika ada yang wajib hilang, dan tidak menulis apa pun. Jika pelanggan dengan nama dan kode pos tersebut sudah ada, ia mengembalikan yang sudah ada alih-alih membuat yang kedua.

name	wajib	Perusahaan atau orang yang memiliki limbah
address	wajib	Tempat limbah dikumpulkan
postcode	wajib	Kode pos alamat pengumpulan
producer_type	opsional	Apakah limbah berasal dari bisnis atau rumah tangga. Defaultnya business.
contact_name	wajib	Siapa yang harus dihubungi di lokasi
contact_email	opsional	Alamat email mereka
contact_phone	opsional	Nomor telepon mereka
sic_code	opsional	Kode SIC produsen, jika diketahui

create_receiving_site

Tambah situs penerimamenulis

Tambah situs penerima (tempat pembuangan, stasiun transfer, atau fasilitas daur ulang tempat limbah dibawa). Menjawab dengan apa yang masih diperlukan jika ada yang wajib hilang, dan tidak menulis apa pun.

name	wajib	Nama situs
address	wajib	Alamat situs
postcode	wajib	Kode pos situs
permit_number	opsional	Nomor izin lingkungan atau pengecualian
contact_name	opsional	Siapa yang harus dihubungi di gerbang
contact_email	opsional	Alamat email mereka
contact_phone	opsional	Nomor telepon mereka
is_own_site	opsional	Benar hanya jika ini adalah situs milik organisasi sendiri, bukan milik orang lain. Defaultnya salah.

create_carrier

Menambahkan pengangkut atau perantaramenulis

Menambahkan pengangkut, perantara, atau dealer yang bekerja sama dengan organisasi. Menjawab dengan apa yang masih diperlukan jika ada yang wajib hilang, dan tidak menulis apa pun.

company_name	wajib	Nama perusahaan pengangkut atau perantara
registration_number	opsional	Nomor registrasi pengangkut limbah mereka, jika diketahui
contact_name	opsional	Siapa yang harus dihubungi
contact_email	opsional	Alamat email mereka
contact_phone	opsional	Nomor telepon mereka
address	opsional	Alamat mereka
postcode	opsional	Kode pos mereka
notes	opsional	Apa pun yang layak dicatat tentang mereka

create_vehicle

Menambahkan kendaraanmenulis

Menambahkan kendaraan ke armada. Menjawab dengan apa yang masih diperlukan jika ada yang wajib hilang, dan tidak menulis apa pun. Registrasi yang sudah ada di armada mengembalikan kendaraan itu alih-alih membuat yang kedua.

registration	wajib	Plat nomor
make	opsional	Siapa yang membuatnya
description	opsional	Model atau deskripsi
vehicle_type	opsional	Jenis kendaraan, misalnya truk kontainer atau truk jungkit
mot_expiry	opsional	Kapan MOT berakhir (YYYY-MM-DD)
tax_expiry	opsional	Kapan pajak berakhir (YYYY-MM-DD)
max_weight_tonnes	opsional	Berat kotor dalam ton

create_driver

Menambahkan pengemudimenulis

Menambahkan pengemudi, sehingga mereka dapat diberi pekerjaan dan menandatangani catatan transfer di aplikasi pengemudi. Menggunakan salah satu jatah pengemudi dari paket dan menolak jika semuanya sudah terpakai. Tidak memberikan login kantor kepada siapa pun: itu diberikan di halaman Tim oleh pemilik atau admin. Seseorang yang sudah ada di tim mendapatkan aplikasi pengemudi ditambahkan ke catatan yang sudah mereka miliki.

name	wajib	Nama lengkap mereka
email	wajib	Alamat email mereka, yang merupakan tempat undangan ke aplikasi pengemudi dikirim
phone_number	opsional	Nomor telepon mereka
role	opsional	Apa yang mereka lakukan, misalnya pengemudi HGV
address	opsional	Alamat rumah mereka
postcode	opsional	Kode pos rumah mereka
licence_expiry	opsional	Kapan lisensi mereka berakhir (YYYY-MM-DD)
emergency_contact_name	opsional	Siapa yang harus dihubungi dalam keadaan darurat
emergency_contact_phone	opsional	Nomor telepon orang itu

create_enquiry

Mencatat permintaan pengumpulanmenulis

Mencatat permintaan pengumpulan (enquiry) dari pelanggan, sehingga kantor dapat memberikan penawaran. Menjawab dengan apa yang masih diperlukan jika ada yang wajib hilang, dan tidak menulis apa pun.

company_name	wajib	Perusahaan yang bertanya
contact_name	wajib	Siapa yang menghubungi
contact_email	wajib	Alamat email mereka
contact_phone	wajib	Nomor telepon mereka
site_address	wajib	Di mana limbah berada
postcode	opsional	Kode pos alamat itu
waste_description	wajib	Apa limbahnya, dengan kata-kata mereka
service_type	opsional	Apa yang mereka minta, misalnya kontainer atau muatan grab
estimated_weight	opsional	Kira-kira berapa banyak, dalam ton
preferred_date	opsional	Kapan mereka menginginkannya (YYYY-MM-DD)
access_notes	opsional	Apa pun tentang akses ke lokasi

Penulisan

6 alat create_ menambahkan pelanggan, situs penerima, pengangkut atau perantara, kendaraan, pengemudi, dan permintaan pengumpulan. Mereka adalah cara seseorang memasukkan data ke LoadSnap dengan mendeskripsikannya dalam percakapan alih-alih mengisi formulir atau menyiapkan spreadsheet.

Tidak ada yang pernah ditulis setengah-setengah. Panggilan yang kehilangan sesuatu yang wajib tidak menulis apa pun dan menjawab dengan daftar apa yang masih diperlukan, dirumuskan sebagai pertanyaan, sehingga asisten menanyakannya dan memanggil lagi. Panggilan untuk catatan yang sudah ada mengembalikan catatan yang ada alih-alih membuat yang kedua, sehingga menjalankan permintaan yang sama dua kali tidak dapat meninggalkan duplikat.

Pengemudi yang ditambahkan dengan cara ini menggunakan salah satu jatah pengemudi dari paket dan ditolak ketika semuanya sudah terpakai, persis seperti di halaman Tim, dan dicocokkan dengan orang-orang yang sudah ada di tim sehingga seseorang yang sudah bekerja di sana mendapatkan aplikasi pengemudi ditambahkan ke catatan yang mereka miliki. Tidak ada yang diberikan login kantor: itu adalah kursi berbayar dan jalan masuk ke bisnis, dan diberikan di Tim oleh pemilik atau admin.

Pengarsipan ke DEFRA, penandatanganan catatan transfer, penerbitan faktur, dan penghapusan apa pun sengaja tidak ada di sini. Itu adalah hal-hal yang dilakukan seseorang di LoadSnap, dengan nama mereka tercantum di dalamnya.

Panel interaktif

Server menerbitkan panel interaktif sebagai sumber daya MCP di ui://loadsnap/panel, dan setiap alat menunjuk ke sana. Klien yang mendukung ekstensi aplikasi menggambar jawaban sebagai panel dalam percakapan: tabel catatan, kartu untuk catatan yang baru ditambahkan, atau daftar periksa tentang apa yang masih diperlukan sebelum sesuatu dapat disimpan.

Ini adalah satu dokumen mandiri tanpa data sendiri, tanpa token, dan tanpa apa pun yang diambil dari jaringan. Klien meneruskan jawaban alat ke dalamnya. Setiap alat juga mengembalikan jawaban itu sebagai teks, sehingga klien yang tidak menggambar panel menampilkan persis apa yang selalu ditampilkan.

Batasan dan format

Berat dikembalikan dalam kilogram kecuali nama bidang menyebutkan ton. Tanggal menggunakan ISO (YYYY-MM-DD). Pencarian mengembalikan 25 kecocokan paling relevan; count_movements membaca hingga 1.000 baris dan melaporkan count_is_capped ketika mencapai batas itu, sehingga angka yang dibatasi tidak pernah disajikan sebagai total yang tepat. Hal yang sama berlaku untuk uang yang terutang pada find_invoices, yang melaporkan totals_are_capped. Catatan yang diunggulkan sebagai sampel dikecualikan dari setiap hasil.

Persyaratan

Akun LoadSnap pada paket Pro atau lebih tinggi, dan login yang termasuk dalam organisasi LoadSnap. Setiap orang yang terhubung menggunakan login mereka sendiri, karena koneksi diotorisasi sebagai mereka.

Pertanyaan tentang konektor? Email info@loadsnap.co.uk, atau baca ringkasan konektor.