# Cardápio Web — MCP server on mcp.ai
> Use Claude or ChatGPT with your restaurant on Cardápio Web: current and past orders, revenue, average ticket and best sellers, menu, coupons, reviews and opening hours. Create and edit coupons, and confirm, advance or cancel orders by chat.

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

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_cardapioweb?ms=1794515220000
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/cardapioweb/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/cardapioweb/<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
Install guide (prompt + clients + REST), markdown: https://mcp.ai/cardapioweb/index.md
How to use (MCP or REST), markdown: https://mcp.ai/cardapioweb/skill.md
Postman collection (v2.1): https://mcp.ai/cardapioweb/postman.json

## Tools
- cardapioweb_avaliacoes(data_inicio?: string, data_fim?: string, max_paginas?: integer, account?: string) — Avaliações dos clientes (nota, comentário, respostas da pesquisa, pedido avaliado) com a média do período. 1 requisição por página de 100 (padrão até 3).
- cardapioweb_cardapio(busca?: string, categoria_ids?: integer[], status?: string[], incluir_complementos?: boolean, account?: string) — Cardápio da loja: categorias e itens com id, preço, preço promocional ativo, status (ACTIVE visível, INACTIVE oculto, MISSING em falta), tipo (combo) e estoque quando controlado. Use os ids em cardapi
- cardapioweb_cupom_criar(nome: string, tipo: string, valor?: number, codigo?: string, ativo?: boolean, pedido_minimo?: number, limite_usos?: integer, so_clientes_novos?: boolean, cliente_pode_repetir?: boolean, dias?: string[], tipos_pedido?: string[], valido_de?: string, expira_em?: string, horario_inicio?: string, horario_fim?: string, item_ids?: integer[], account?: string) — Cria um cupom de desconto na loja. Cupom sem código fica visível no cardápio para todos; com código, o cliente digita. Crie com ativo=false se quiser revisar antes de liberar.
- cardapioweb_cupons(busca?: string, so_ativos?: boolean, max_paginas?: integer, account?: string) — Cupons de desconto da loja: nome, código, tipo e valor, se está ativo, situação (valid, expired, usage_limit_reached, not_yet_available, not_active, not_available), regras e validade. 1 requisição por
- cardapioweb_cupons_editar(cupons: object[], account?: string) — Edita cupons existentes (ativar/desativar, mudar valor, código, validade, regras). Mande só o que muda: o restante do cupom é mantido (a Cardápio Web exige o cupom inteiro, então ele é lido antes e re
- cardapioweb_estoque(busca?: string, ate_quantidade?: number, incluir_sem_controle?: boolean, account?: string) — Estoque da loja: itens e complementos (opções) com o controle de estoque ligado, quantidade atual, unidade e status. Uma opção usada em vários itens aparece uma vez, com os grupos onde está. Use os id
- cardapioweb_estoque_ajustar(ajustes: object[], account?: string) — Ajusta o estoque REAL de itens e complementos (opções) da loja: o cardápio passa a mostrar a nova quantidade e o item esgota quando zera. Escrita real: mostre ao usuário o que vai mudar (item, quantid
- cardapioweb_horarios_atualizar(semana?: object, datas_especiais?: object, fuso?: string, modos_operacao?: object, account?: string) — Altera horários de funcionamento e modos de operação da loja REAL (o cardápio passa a abrir/fechar conforme o novo horário).
- cardapioweb_insumos(busca?: string, abaixo_do_minimo?: boolean, max_paginas?: integer, account?: string) — Insumos (matéria-prima) da loja com categoria, unidade, estoque atual, estoque mínimo e se está abaixo do mínimo. Exige a conexão por OAuth. 1 requisição por página de 100 (padrão até 3).
- cardapioweb_insumos_ajustar(insumos: object[], account?: string) — Altera insumos REAIS da loja: preço de custo e se o estoque pode ficar negativo. Escrita real: confirme com o usuário antes de chamar. A quantidade em estoque e o mínimo de um insumo NÃO são alterávei
- cardapioweb_itens_atualizar(itens: object[], account?: string) — Altera itens do cardápio REAL da loja (o cliente vê na hora): pausar ou reativar (status MISSING = em falta, INACTIVE = oculto, ACTIVE = à venda), mudar o preço e ligar/desligar o preço promocional. A
- cardapioweb_list_accounts(account?: string) — Lista as lojas Cardápio Web conectadas (id, nome, modo de conexão). Não chama a API.
- cardapioweb_loja(account?: string) — Dados da loja na Cardápio Web: nome, status, link do cardápio, endereço, modos de operação (delivery, retirada, consumo no local, agendado), horários da semana e datas especiais, estado temporário (ab
- cardapioweb_pedido_detalhe(pedido_ids: integer|string[], incluir_documento_fiscal?: boolean, account?: string) — Detalhe completo de pedidos por id: número, status, itens com opções, descontos/cupom, pagamentos, taxas, total, cliente (nome e telefone) e endereço de entrega. 1 requisição por pedido.
- cardapioweb_pedidos_avancar(pedido_ids: integer|string[], etapa: string, account?: string) — Avança pedidos REAIS para a próxima etapa (o cliente acompanha o status). Confirme com o usuário antes de chamar.
- cardapioweb_pedidos_cancelar(pedido_ids: integer|string[], motivo: string, account?: string) — CANCELA pedidos REAIS (status final, não volta). O cliente é avisado e pode haver estorno de pagamento online. Só chame depois de o usuário confirmar o cancelamento de cada pedido e dizer o motivo, qu
- cardapioweb_pedidos_confirmar(pedido_ids: integer|string[], account?: string) — ACEITA pedidos REAIS que estão pendentes (waiting_confirmation). O cliente é avisado e a cozinha passa a produzir: confirme com o usuário, pedido por pedido, antes de chamar. Agendados vão para schedu
- cardapioweb_pedidos_historico(data_inicio: string, data_fim: string, status?: string[], max_paginas?: integer, account?: string) — Pedidos FINALIZADOS e CANCELADOS criados num período (até 6 meses por consulta, inclusive iFood e outros canais integrados). Traz id, status, tipo, canal e datas; para valores e itens use cardapioweb_
- cardapioweb_pedidos_recentes(status?: string[], atualizados_desde?: string, detalhar?: boolean, account?: string) — Pedidos alterados nas ÚLTIMAS 8 HORAS (os do turno). Para dias anteriores use cardapioweb_pedidos_historico.
- cardapioweb_resumo_vendas(data_inicio: string, data_fim: string, incluir?: string[], limite_ranking?: integer, incluir_cancelados?: boolean, account?: string) — Resumo de vendas de um período (até 6 meses), calculado pela Cardápio Web: faturamento total, nº de pedidos e ticket médio; quebras por dia, dia da semana, hora, mês, canal, tipo de pedido, forma de p

## Example prompts
- "How many orders did I get yesterday, what did they add up to and which items sold most?"
- "Is there a pending order right now? If so, show me the items and the address"
- "Create a 10% coupon for orders over R$ 50, inactive so I can review it first"

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