Deixa o teu agente de IA ler os preços dos suplementos

Servidor MCP

Endpoint Streamable HTTP, anónimo e só de leitura. Funciona com Claude (Desktop e Code), ChatGPT, Grok e qualquer outro cliente MCP. Liga-o com este URL:

Configuração de exemplo para um cliente MCP:

{
  "mcpServers": {
    "suplementoscanner": {
      "type": "http",
      "url": "https://mcp.suplementoscanner.pt"
    }
  }
}

Grok

Na app do Grok: abre os plugins, adiciona um novo conector personalizado e cola o endpoint acima. Não é preciso mais nada.

O Grok Bot adiciona o mesmo servidor se lho pedires com este URL.

Através da API da xAI, adiciona-o como ferramenta MCP remota:

{
  "tools": [
    {
      "type": "mcp",
      "server_url": "https://mcp.suplementoscanner.pt",
      "server_label": "suplementoscanner"
    }
  ]
}

• find_cheapest

  Os produtos mais baratos por unidade numa categoria.

• search_products

  Pesquisa tolerante a erros de escrita em todo o catálogo.

• list_categories

  Todas as categorias, com contagens atuais e o preço mais baixo.

• get_product

  Detalhe e histórico de preços de um produto.

API JSON

Para agentes e frameworks que usam HTTP simples. Os mesmos dados que o servidor MCP.

GET /search?q=prote%C3%ADna+whey&limit=10
GET /categories
GET /categories/{slug}/cheapest?limit=10
GET /products/{id}

Legível por máquinas: Especificação OpenAPI · llms.txt

Identifica a tua integração

Cada integração tem de indicar quem a gere num cabeçalho do pedido, tanto na API JSON como no endpoint MCP.

curl \
  -H "Client-Name: Acme Labs" \
  -H "Client-Domain: example.com" \
  "https://api.suplementoscanner.pt/v1/categories"

• Client-Name: obrigatório. A empresa, organização ou pessoa que gere a integração. Indica o operador, não cada um dos seus utilizadores; para um projeto pessoal, basta um nome de projeto ou um nome de utilizador.
• Client-Domain: recomendado. O domínio simples do site do operador, como example.com: sem https://, caminho nem porta.