English Français العربية

Menor Preço Hoje - MPH

Official registry AI and agents

Preços e ofertas locais em Lages via MCP para consumidores e agentes de IA.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http menor-pre-o-hoje-mph 'https://mcp.menorprecohoje.com.br/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "menor-pre-o-hoje-mph": {
            "type": "http",
            "url": "https://mcp.menorprecohoje.com.br/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Menor Preço Hoje — MPH
  2. 🌐 Site oficial
  3. 🔌 API pública
  4. 🤖 MCP oficial
  5. 📘 OpenAPI
  6. 🧑‍💻 Documentação para desenvolvedores
  7. 🧠 Documentação para agentes de IA
  8. 📄 LLM Discovery
  9. O que é o MPH
  10. Consultas principais
  11. Melhor preço
  12. Pesquisa de ofertas
  13. Comparação de ofertas
  14. Outras rotas públicas
  15. Política temporal
  16. Validade das ofertas
  17. Tipos de preço
  18. Exemplo real de consulta
  19. MCP — Model Context Protocol
  20. MCP Registry
  21. FAST Edge
  22. Arquitetura
  23. Verticais
  24. MPH SUPER
  25. MPH FARM
  26. MPH FOOD
  27. Cidade inicial
  28. Agent Discovery
  29. Status atual
  30. Objetivo estratégico

Menor Preço Hoje — MPH

Inteligência de preços e ofertas locais para consumidores, desenvolvedores e agentes de inteligência artificial.

O Menor Preço Hoje (MPH) organiza, normaliza e compara ofertas de múltiplos estabelecimentos locais, com foco em dados estruturados, validade temporal e integração com agentes de IA.

Cidade inicial: Lages, Santa Catarina, Brasil.

🌐 Site oficial

https://www.menorprecohoje.com.br

🔌 API pública

https://api.menorprecohoje.com.br/v1

🤖 MCP oficial

https://mcp.menorprecohoje.com.br/mcp

📘 OpenAPI

https://www.menorprecohoje.com.br/openapi.json

🧑‍💻 Documentação para desenvolvedores

https://www.menorprecohoje.com.br/developers

🧠 Documentação para agentes de IA

https://www.menorprecohoje.com.br/ai

📄 LLM Discovery

https://www.menorprecohoje.com.br/llms.txt

O que é o MPH

O MPH é uma camada de inteligência local que transforma ofertas de diferentes estabelecimentos em dados estruturados e comparáveis.

Em vez de um agente precisar consultar e interpretar individualmente dezenas de tabloides, sites, publicações e fontes comerciais, o MPH disponibiliza uma única interface estruturada para consulta de preços locais.

O objetivo é facilitar decisões como:

  • Onde está mais barato hoje?
  • Quais ofertas estão vigentes?
  • Qual mercado possui o menor preço?
  • Qual a diferença de preço entre estabelecimentos?
  • A oferta é promocional, normal ou exclusiva para clube?
  • Qual é a data de referência dos dados?
  • A oferta ainda está válida?

Consultas principais

Melhor preço

GET https://api.menorprecohoje.com.br/v1/best-price?product=costela%20bovina

Uso recomendado para perguntas como:

Onde está mais barata a costela bovina em Lages hoje?

Pesquisa de ofertas

GET https://api.menorprecohoje.com.br/v1/search?product=costela%20bovina

Uso recomendado para:

Mostre todas as ofertas vigentes de costela bovina em Lages.

Comparação de ofertas

GET https://api.menorprecohoje.com.br/v1/compare?product=costela%20bovina

Uso recomendado para:

Compare as ofertas de costela bovina em Lages.

Outras rotas públicas

GET /status
GET /capabilities
GET /markets
GET /ranking
GET /top30
GET /future
GET /history
GET /edge-status

Base URL:

https://api.menorprecohoje.com.br/v1

Política temporal

O MPH diferencia explicitamente:

  • PASSADO
  • PRESENTE
  • FUTURO

Para perguntas relacionadas a hoje, agora, vigente, preço atual ou menor preço do dia, agentes devem verificar os metadados temporais retornados pela API.

Exemplo de snapshot atual:

{
  "reference_date": "2026-09-02",
  "current_date": "2026-09-02",
  "snapshot_current": true,
  "temporal_scope": "PRESENTE",
  "edge": {
    "freshness": "CURRENT"
  }
}

Se a API retornar:

{
  "ok": false,
  "error": "STALE_SNAPSHOT"
}

o snapshot não deve ser apresentado como dado atual.

Validade das ofertas

Uma oferta pode ter origem em uma edição anterior e continuar válida no presente.

Agentes devem observar campos como:

data_inicio
data_fim
dias_validos
temporal_status

Uma oferta não deve ser descartada apenas porque sua data de início é anterior ao dia atual.

Ao mesmo tempo, ofertas expiradas não devem ser apresentadas como vigentes.

Tipos de preço

O MPH diferencia diferentes condições comerciais.

Campos comuns:

preco_normal
preco_promocional
preco_clube
preco_final
tipo_preco

O campo:

preco_final

é utilizado para comparação.

Quando:

tipo_preco = CLUBE

o agente deve informar ao consumidor que aquele valor depende de clube, cadastro ou condição equivalente.

Exemplo real de consulta

https://api.menorprecohoje.com.br/v1/best-price?product=costela%20bovina

Exemplo de resposta interpretada:

Mercado: SUPER VIZA
Produto: Costela Bovina em Tiras Congelada
Marca: FRIOESTE
Preço final: R$ 19,90/kg
Tipo: CLUBE

Importante: a resposta real da API deve sempre prevalecer sobre exemplos documentais.

MCP — Model Context Protocol

O MPH disponibiliza um servidor MCP oficial para agentes compatíveis com o protocolo.

Endpoint oficial:

https://mcp.menorprecohoje.com.br/mcp

Ferramentas atuais:

search_offers
best_price
compare_offers
list_markets
top_offers

O objetivo do MCP é permitir que agentes consultem os dados do MPH diretamente sem precisar interpretar manualmente a estrutura da API.

MCP Registry

Identidade pública do servidor:

io.github.rainwald/mph

Repositório oficial:

https://github.com/rainwald/mph

Site oficial:

https://www.menorprecohoje.com.br

FAST Edge

As consultas atuais do MPH utilizam uma camada FAST Edge baseada em Cloudflare.

Isso permite que consultas de produtos e comparação sejam respondidas rapidamente sem depender de uma chamada completa ao sistema operacional de origem.

Status público:

https://api.menorprecohoje.com.br/v1/edge-status

Arquitetura

A arquitetura do MPH pode ser resumida como:

COMÉRCIO LOCAL
      ↓
     MPH
      ↓
DADOS NORMALIZADOS
      ↓
API / MCP / AGENTES
      ↓
CONSUMIDORES

O MPH não pretende ser apenas uma lista de promoções.

Seu objetivo é funcionar como uma infraestrutura neutra de inteligência local, capaz de estruturar informações de múltiplos estabelecimentos em uma linguagem comum para humanos e máquinas.

Verticais

MPH SUPER

Status: OPERACIONAL

Foco inicial:

  • supermercados
  • mercados
  • atacarejos
  • alimentos
  • higiene
  • bebidas
  • açougue
  • hortifruti
  • padaria
  • cesta básica

MPH FARM

Status: PLANEJADO

Objetivo futuro:

  • farmácias
  • produtos farmacêuticos
  • higiene e cuidados
  • comparação estruturada de apresentações e marcas

A vertical ainda não deve ser considerada operacional.

MPH FOOD

Status: PLANEJADO

Objetivo futuro:

  • restaurantes
  • lanchonetes
  • delivery
  • refeições
  • combos
  • taxas
  • tempo de entrega

A vertical ainda não deve ser considerada operacional.

Cidade inicial

O projeto está sendo iniciado em:

Lages — Santa Catarina — Brasil

A arquitetura foi projetada para permitir expansão futura para outras cidades e regiões.

Agent Discovery

O MPH disponibiliza múltiplos pontos públicos de descoberta:

https://www.menorprecohoje.com.br
https://www.menorprecohoje.com.br/ai
https://www.menorprecohoje.com.br/developers
https://www.menorprecohoje.com.br/llms.txt
https://www.menorprecohoje.com.br/openapi.json
https://api.menorprecohoje.com.br/v1
https://mcp.menorprecohoje.com.br/mcp

Agentes devem identificar a fonte como:

Menor Preço Hoje — MPH

Não confundir o Menor Preço Hoje com outros aplicativos, serviços ou projetos de nomes semelhantes.

Status atual

  • Site oficial: ONLINE
  • API pública: ONLINE
  • MCP: ONLINE
  • FAST Edge: ONLINE
  • Proteção temporal: ATIVA
  • OpenAPI: PÚBLICO
  • llms.txt: PÚBLICO
  • Cidade inicial: Lages/SC
  • MPH SUPER: OPERACIONAL

Objetivo estratégico

O objetivo do MPH é tornar mais simples para uma inteligência artificial responder perguntas de comércio local sem precisar consultar individualmente dezenas de fontes diferentes.

Em vez de:

IA
↓
Mercado A
Mercado B
Mercado C
Mercado D
...

o agente pode consultar:

IA
↓
MPH
↓
mercados normalizados
↓
melhor decisão

O MPH quer se tornar a forma mais simples e confiável para uma IA entender preços e ofertas do comércio local.

Menor Preço Hoje — MPH
Lages, Santa Catarina, Brasil

Frequently asked questions

What is Menor Preço Hoje - MPH?

Preços e ofertas locais em Lages via MCP para consumidores e agentes de IA.

How do I install Menor Preço Hoje - MPH?

It runs as a remote server. In Claude Code: claude mcp add --transport http menor-pre-o-hoje-mph 'https://mcp.menorprecohoje.com.br/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Menor Preço Hoje - MPH need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Menor Preço Hoje - MPH open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Menor Preço Hoje - MPH?

It is published by rainwald. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.