LoadSnap

oficial

Consulte seus registros de conformidade de resíduos do Reino Unido a partir de qualquer assistente de IA. Acesso somente leitura às suas próprias notas de transferência de resíduos, recibos, tonelagem e envios ao DEFRA Digital Waste Tracking.

O que você pode fazer com LoadSnap MCP?

  • Pesquisar movimentações de resíduos — Solicite notas de transferência de resíduos ou trabalhos por transportadora, gerador ou nome do cliente e intervalo de datas via find_movements.
  • Revisar recibos do site — Liste os recibos de entrada de resíduos no seu próprio site, filtrados por transportadora, gerador ou intervalo de datas com find_receipts.
  • Resumir totais de movimentações — Obtenha contagens de movimentações e peso total em um período, opcionalmente dividido por direção de entrada/saída, usando count_movements.
  • Verificar status de envio à DEFRA — Conte e liste os envios de Digital Waste Tracking, incluindo registros pendentes, com defra_filings.
  • Resolver nomes de empresas — Corresponda um nome de empresa ou site aos seus transportadores e sites conhecidos usando find_parties.

Documentação

Referência do servidor MCP

Tudo o que é necessário para conectar um assistente de IA a uma conta LoadSnap, e o que ele pode ler uma vez conectado.

Endpoint

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

Um servidor remoto do Model Context Protocol usando o transporte HTTP Streamable: JSON-RPC 2.0 sobre um único POST. O servidor não tem estado, portanto não há cabeçalho de sessão nem fluxo de eventos iniciado pelo servidor, e um GET retorna 405.

Adicione-o ao Claude, Claude Code, ChatGPT, Cursor ou qualquer outro cliente compatível com MCP como um conector personalizado ou remoto, usando essa URL. Não há chave de API para colar.

Autenticação

OAuth 2.1: código de autorização com PKCE, além de Registro Dinâmico de Cliente, para que um cliente se registre sozinho sem configuração manual. A descoberta funciona da maneira usual: uma solicitação não autenticada retorna 401 com um cabeçalho WWW-Authenticate apontando para os metadados do recurso protegido.

Metadados do recurso protegido/.well-known/oauth-protected-resource
Metadados do servidor de autorização/.well-known/oauth-authorization-server
Registro dinâmico de cliente/api/oauth/register
Autorização/oauth/authorize
Token/api/oauth/token

A pessoa faz login na LoadSnap e aprova a conexão em uma tela que nomeia o cliente e a organização. Os tokens de acesso duram uma hora e são renovados com um token de atualização, então a conexão continua funcionando sem novo login.

O acesso é autorizado como pessoa, não como chave. A associação à organização e o plano são verificados novamente a cada solicitação, então remover alguém de uma organização encerra o acesso do conector dessa pessoa junto.

Escopo do acesso

Cada consulta é estritamente filtrada para a organização do usuário autorizado, resolvida no lado do servidor a partir do token. O cliente nunca fornece uma organização, portanto não pode solicitar dados de outra empresa. A segurança em nível de linha aplica a mesma fronteira no banco de dados subjacente.

O servidor é somente leitura. Não há ferramenta que crie, edite ou exclua nada.

Ferramentas

find_movements

Lista ou pesquisa registros de movimentação de resíduos (Notas de Transferência de Resíduos) e trabalhos.

nameopcionalNome do produtor, cliente ou transportador. Omita para listar tudo no intervalo de datas.
date_fromopcionalData ISO (AAAA-MM-DD) como limite inferior na data de coleta.
date_toopcionalData ISO (AAAA-MM-DD) como limite superior na data de coleta.

find_receipts

Lista ou pesquisa recibos de resíduos que chegam ao próprio site da organização.

nameopcionalNome do transportador ou produtor. Omita para listar tudo recebido no intervalo.
date_fromopcionalData ISO (AAAA-MM-DD) como limite inferior na data de recebimento.
date_toopcionalData ISO (AAAA-MM-DD) como limite superior na data de recebimento.

count_movements

Conta movimentações em um período e totaliza o peso delas, opcionalmente dividido por direção.

date_fromopcionalData ISO (AAAA-MM-DD) como limite inferior na data de coleta.
date_toopcionalData ISO (AAAA-MM-DD) como limite superior na data de coleta.
directionopcionalinbound, outbound ou all. Inbound é o resíduo recebido no próprio site da organização.

defra_filings

Conta e lista os envios do DEFRA Digital Waste Tracking, e os registros ainda aguardando envio.

date_fromopcionalData ISO (AAAA-MM-DD) como limite inferior na data de envio.
date_toopcionalData ISO (AAAA-MM-DD) como limite superior na data de envio.
include_outstandingopcionalTambém retorna registros ainda não enviados. O padrão é true.

find_parties

Resolve um nome de empresa ou site para os transportadores e sites conhecidos da organização.

nameobrigatórioNome da empresa ou site.

Limites e formatos

Os pesos são retornados em quilogramas, a menos que o nome do campo indique toneladas. As datas são ISO (AAAA-MM-DD). As duas ferramentas de busca retornam as 25 correspondências mais recentes; count_movements lê até 1.000 linhas e informa count_is_capped quando atinge esse teto, então um valor limitado nunca é apresentado como total exato. Registros semeados como amostras são excluídos de todos os resultados.

Requisitos

Uma conta LoadSnap no plano Pro ou superior, e um login que pertença a uma organização LoadSnap. Todos que se conectam usam o próprio login, porque a conexão é autorizada como eles.

Dúvidas sobre o conector? Envie um e-mail para info@loadsnap.co.uk, ou leia a visão geral do conector.