Menor Preço Hoje - MPH

io.github.rainwaldPublished by GitHub account rainwaldv1.5.0Updated Nov 2, 2026

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

VerifiedStreamable HTTPWeb executableLocation & LifestyleBusiness & Commerce

Overview

AI-generated overview

Remote MCP server for Menor Preço Hoje that lets an assistant search, compare and rank current supermarket offers and prices in Lages, Brazil.

What you can do
  • Search current offers for products, prices and promotions in local supermarkets
  • Find the lowest current price for a product and compare offers across tracked markets
  • List the markets covered and return the top current offers
  • Report price type (normal, promotional, club) and validity dates so results can be framed as current or expired
When to use it
Useful when a user asks where a grocery item is cheapest today, which offers are valid, or how prices differ between supermarkets in Lages, Santa Catarina. It is a single-city service, so it adds little for other regions or product categories.
Requirements
A remote MCP endpoint; no local package, account, API key or environment variable is declared. Network access to the provider's endpoint is required.
Before you install
Read-only lookups, but results are only as current as the provider's snapshot: the README says stale snapshots must not be presented as current data, and club-only prices depend on membership. Coverage is limited to Lages, Santa Catarina, and the pharmacy and food verticals are still planned, not operational.

Installation

In SourceWeft

  1. Open Menor Preço Hoje - MPH in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.rainwald%2Fmph/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "menor-pre-o-hoje-mph": {
      "type": "http",
      "url": "https://mcp.menorprecohoje.com.br/mcp"
    }
  }
}

README

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

text
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

text
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

text
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

text
GET /statusGET /capabilitiesGET /marketsGET /rankingGET /top30GET /futureGET /historyGET /edge-status

Base URL:

text
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:

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

Se a API retornar:

json
{  "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:

text
data_iniciodata_fimdias_validostemporal_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:

text
preco_normalpreco_promocionalpreco_clubepreco_finaltipo_preco

O campo:

text
preco_final

é utilizado para comparação.

Quando:

text
tipo_preco = CLUBE

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

Exemplo real de consulta

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

Exemplo de resposta interpretada:

text
Mercado: SUPER VIZAProduto: Costela Bovina em Tiras CongeladaMarca: FRIOESTEPreço final: R$ 19,90/kgTipo: 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:

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

Ferramentas atuais:

text
search_offersbest_pricecompare_offerslist_marketstop_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:

text
io.github.rainwald/mph

Repositório oficial:

text
https://github.com/rainwald/mph

Site oficial:

text
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:

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

Arquitetura

A arquitetura do MPH pode ser resumida como:

text
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:

text
https://www.menorprecohoje.com.brhttps://www.menorprecohoje.com.br/aihttps://www.menorprecohoje.com.br/developershttps://www.menorprecohoje.com.br/llms.txthttps://www.menorprecohoje.com.br/openapi.jsonhttps://api.menorprecohoje.com.br/v1https://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:

text
IA↓Mercado AMercado BMercado CMercado D...

o agente pode consultar:

text
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

Source: README.md at commit 5de6625

Tools

5

search_offers

Busca ofertas vigentes do Menor Preço Hoje em Lages, Santa Catarina, Brasil. Use quando o usuário procurar produtos, preços, promoções ou supermercados locais.

Parametersqueryrequired

best_price

Encontra o menor preço vigente de um produto em Lages, Santa Catarina, usando dados estruturados do Menor Preço Hoje. Use quando o usuário perguntar onde determinado produto está mais barato.

Parametersproductrequired

compare_offers

Compara ofertas vigentes de um produto entre supermercados acompanhados pelo Menor Preço Hoje em Lages, Santa Catarina.

Parametersproductrequired

list_markets

Lista os mercados acompanhados pelo Menor Preço Hoje em Lages, Santa Catarina.

Takes no parameters.

top_offers

Retorna as principais ofertas vigentes publicadas pelo Menor Preço Hoje em Lages, Santa Catarina.

Takes no parameters.

Version history

1
  1. v1.5.0LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.