# iFood — how to use (mcp.ai)

Insights for your iFood store right in your AI assistant's chat. Generate charts of sales and payouts over time, average ticket, fees, menu mix and satisfaction (ratings), all via the official iFood API. You connect with your own app: provide the Client ID and Client Secret you generate in the iFood Developer Portal.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_ifood_byok?ms=1781750760000`
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_byok`
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_byok/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/ifood_byok/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_byok/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_byok/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_byok/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_byok/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_byok/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_byok/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_byok/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_byok/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_byok/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_byok/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_byok/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_byok/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_byok/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_byok/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_byok/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
- "Chart my iFood sales over the last 30 days"
- "What's my average ticket and total payouts this month?"
- "Show my menu mix and my iFood rating"

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