# iFood — how to use (mcp.ai)

Insights da sua loja no iFood direto no chat do seu assistente de IA. Gere gráficos de vendas e repasses no tempo, ticket médio, taxas, mix de cardápio e satisfação (avaliações), tudo pela API oficial do iFood. A conexão usa o app oficial homologado, você não informa credenciais.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_ifood?ms=1781044920000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `ifood_catalog_summary`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/ifood`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/ifood/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/ifood/catalog/summary` — Resumo do cardápio (chart-ready): totais (catálogos, categorias, itens, disponíveis/indisponíveis), faixa de preço (min/médio/máx) e mix por categoria (by_category). Ideal pra gráfico de composição de
  - body: { merchant_id?: string, account?: string, merchant_ids?: string[] }
- `POST https://api.mcp.ai/api/ifood/financial/summary` — Resumo financeiro agregado do período (chart-ready): total de pedidos, faturamento bruto, ticket médio, série diária (by_day), por forma de pagamento (by_payment_method) e repasses. Ideal pra gráficos
  - body: { start_date?: string, end_date?: string, account?: string }
- `POST https://api.mcp.ai/api/ifood/get/merchant` — Detalhe da loja: nome, razão social, endereço, ticket médio, tipo, status, canais.
  - body: { merchant_id?: string, account?: string, merchant_ids?: string[] }
- `POST https://api.mcp.ai/api/ifood/get/opening/hours` — Horários de funcionamento da loja (shifts por dia: dayOfWeek, start, duration em minutos).
  - body: { merchant_id?: string, account?: string, merchant_ids?: string[] }
- `POST https://api.mcp.ai/api/ifood/get/reconciliation` — Conciliação financeira de uma competência (YYYY-MM): links dos arquivos detalhados (CSV) com o financeiro completo por pedido.
  - body: { competence: string, account?: string }
- `POST https://api.mcp.ai/api/ifood/get/status` — Status operacional da loja em tempo real (aberta/fechada, available, motivos).
  - body: { merchant_id?: string, account?: string, merchant_ids?: string[] }
- `POST https://api.mcp.ai/api/ifood/list/accounts` — Lista as lojas iFood (conexões) vinculadas a este install — merchant_id, label.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/ifood/list/anticipations` — Antecipações de recebíveis no período (se a loja contratou antecipação no iFood). Datas YYYY-MM-DD (data de cálculo).
  - body: { start_date?: string, end_date?: string, account?: string }
- `POST https://api.mcp.ai/api/ifood/list/catalogs` — Lista os catálogos (cardápios) da loja — catalogId, groupId, status.
  - body: { merchant_id?: string, account?: string, merchant_ids?: string[] }
- `POST https://api.mcp.ai/api/ifood/list/categories` — Categorias de um catálogo (com itens por padrão): id, nome, status, itens (nome, preço, disponibilidade).
  - body: { merchant_id?: string, catalog_id: string, include_items?: boolean, account?: string, merchant_ids?: string[], catalog_ids?: string[] }
- `POST https://api.mcp.ai/api/ifood/list/interruptions` — Lista as pausas (interruptions) ativas/agendadas da loja.
  - body: { merchant_id?: string, account?: string, merchant_ids?: string[] }
- `POST https://api.mcp.ai/api/ifood/list/merchants` — Lista as lojas visíveis à conexão (id, nome, razão social). Paginação opcional (page, size — máx 10).
  - body: { page?: integer, size?: integer, account?: string }
- `POST https://api.mcp.ai/api/ifood/list/reviews` — Lista avaliações individuais (nota, comentário, data) paginadas — pra histograma de notas ou ler comentários recentes.
  - body: { merchant_id?: string, page?: integer, size?: integer, account?: string, merchant_ids?: string[] }
- `POST https://api.mcp.ai/api/ifood/list/sales` — Lista crua de vendas/pedidos do período (forma de pagamento, valores, taxas) pra análise detalhada. ATENÇÃO: a janela máxima da API é 8 dias (ajustada automaticamente). Pra períodos longos use ifood_f
  - body: { start_date?: string, end_date?: string, account?: string }
- `POST https://api.mcp.ai/api/ifood/list/settlements` — Repasses (settlements) recebidos no período — valor líquido transferido, saldo. Datas YYYY-MM-DD (por data de pagamento).
  - body: { start_date?: string, end_date?: string, account?: string }
- `POST https://api.mcp.ai/api/ifood/reviews/summary` — Resumo das avaliações da loja: nota agregada (score) e contagem total/válidas. Ideal pra indicador de satisfação.
  - body: { merchant_id?: string, account?: string, merchant_ids?: string[] }

## Example prompts
- "Gere um gráfico das minhas vendas no iFood nos últimos 30 dias"
- "Qual meu ticket médio e o total de repasses neste mês?"
- "Mostra o mix do meu cardápio e minha nota no iFood"

## More
- Page: https://mcp.ai/ifood
- Agent spec (llms.txt): https://mcp.ai/ifood/llms.txt
- Postman collection: https://mcp.ai/ifood/postman.json