# iFood — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/ifood_byok

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_ifood_byok?ms=1781750880000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/ifood_byok/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/ifood_byok/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/ifood_byok/skill.md
Postman collection (v2.1): https://mcp.ai/ifood_byok/postman.json

## Tools
- ifood_catalog_summary(merchant_id?: string, account?: string, merchant_ids?: string[]) — 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
- ifood_financial_summary(start_date?: string, end_date?: string, account?: string) — 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
- ifood_get_merchant(merchant_id?: string, account?: string, merchant_ids?: string[]) — Detalhe da loja: nome, razão social, endereço, ticket médio, tipo, status, canais.
- ifood_get_opening_hours(merchant_id?: string, account?: string, merchant_ids?: string[]) — Horários de funcionamento da loja (shifts por dia: dayOfWeek, start, duration em minutos).
- ifood_get_reconciliation(competence: string, account?: string) — Conciliação financeira de uma competência (YYYY-MM): links dos arquivos detalhados (CSV) com o financeiro completo por pedido.
- ifood_get_status(merchant_id?: string, account?: string, merchant_ids?: string[]) — Status operacional da loja em tempo real (aberta/fechada, available, motivos).
- ifood_list_accounts(account?: string) — Lista as lojas iFood (conexões) vinculadas a este install — merchant_id, label.
- ifood_list_anticipations(start_date?: string, end_date?: string, account?: string) — Antecipações de recebíveis no período (se a loja contratou antecipação no iFood). Datas YYYY-MM-DD (data de cálculo).
- ifood_list_catalogs(merchant_id?: string, account?: string, merchant_ids?: string[]) — Lista os catálogos (cardápios) da loja — catalogId, groupId, status.
- ifood_list_categories(merchant_id?: string, catalog_id: string, include_items?: boolean, account?: string, merchant_ids?: string[], catalog_ids?: string[]) — Categorias de um catálogo (com itens por padrão): id, nome, status, itens (nome, preço, disponibilidade).
- ifood_list_interruptions(merchant_id?: string, account?: string, merchant_ids?: string[]) — Lista as pausas (interruptions) ativas/agendadas da loja.
- ifood_list_merchants(page?: integer, size?: integer, account?: string) — Lista as lojas visíveis à conexão (id, nome, razão social). Paginação opcional (page, size — máx 10).
- ifood_list_reviews(merchant_id?: string, page?: integer, size?: integer, account?: string, merchant_ids?: string[]) — Lista avaliações individuais (nota, comentário, data) paginadas — pra histograma de notas ou ler comentários recentes.
- ifood_list_sales(start_date?: string, end_date?: string, account?: string) — 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
- ifood_list_settlements(start_date?: string, end_date?: string, account?: string) — Repasses (settlements) recebidos no período — valor líquido transferido, saldo. Datas YYYY-MM-DD (por data de pagamento).
- ifood_reviews_summary(merchant_id?: string, account?: string, merchant_ids?: string[]) — Resumo das avaliações da loja: nota agregada (score) e contagem total/válidas. Ideal pra indicador de satisfação.

## 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"

## Links
Docs: https://mcp.ai/docs/mcps/ifood_byok
Website: https://mcp.ai/mcps/ifood_byok