Menor Preço Hoje - MPH MCP server

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:

Shortened. The full README is on GitHub.