Integração para programadores

Liga o teu agente de IA à LowStock

O teu agente de voz ou assistente de IA pode pesquisar produtos, consultar preços e verificar a disponibilidade dos lotes diretamente no catálogo público da LowStock.

Acesso público, sem conta ou chave API · Apenas leitura

Endereço do servidor MCP

Endpoint HTTPS

Na plataforma do agente, adiciona um servidor MCP externo e cola o endereço acima.
Escolher transporte Streamable HTTP e autenticação Sem autenticação.
Liga o servidor e carrega as ferramentas search_products e check_stock.
Utiliza palavras-chave de produto ou categoria na pesquisa e o identificador devolvido para verificar o stock.

É necessário um cliente MCP com Streamable HTTP. Os clientes que apenas suportam o antigo transporte SSE precisam de um adaptador. O MCP não é um serviço telefónico; a voz é fornecida pela plataforma do teu agente.

search_products

Pesquisa por nome ou categoria. Devolve o nome, o preço, a moeda, a quantidade disponível, a unidade, a localidade e a ligação do lote.

Parâmetros: query ou category, mais limit opcional (1–20).

check_stock

Verificar o stock atual por id. A quantidade exclui as reservas. Um lote indisponível ou inexistente devolve found: false.

A verificação não reserva a mercadoria. A disponibilidade pode mudar até à conclusão de uma transação.

O que podes pedir ao agente?

«Que lotes de vestuário de trabalho têm disponíveis e a que preço?»
«Pesquisa lotes ProfiWear de calças.»
«O lote que encontraste ainda está disponível?»

O agente transforma a pergunta em palavras-chave, por exemplo category: "Îmbrăcăminte" ou query: "ProfiWear". O preço deve ser interpretado em conjunto com price_basis: por unidade, por lote ou negociável.

Exemplo para programadores

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_products",
    "arguments": {
      "query": "ProfiWear",
      "limit": 5
    }
  }
}

O cliente MCP efetua a inicialização e a descoberta das ferramentas. Versões suportadas: 2025-06-18 e 2025-03-26. Respostas JSON, sem sessão persistente.

Acesso e segurança

São expostos apenas os dados públicos dos lotes ativos com stock disponível. Não estão disponíveis contactos, perfis, conversas, documentos privados, credenciais, encomendas ou alterações de stock.

Máximo de 20 resultados e 8 KB por pedido. Um contador partilhado no servidor limita o acesso público a um total de 120 pedidos por minuto. Existem também filtros locais adicionais para pedidos repetitivos. Perante uma resposta 429, aguarda 60 segundos. Para tráfego abusivo de grande volume, continua a ser necessária a proteção do fornecedor de alojamento.

Ver lotes disponíveis