# Muralha Entregas — how to use (mcp.ai)

Para lojas que pedem entregas à Muralha Entregas. Pergunte pelas entregas de um período e pelo status de cada uma, veja o detalhe de uma OS (paradas, entregador e valores), estime o preço de uma entrega antes de chamar e consulte o saldo e o extrato da carteira de créditos. Também pede e cancela entregas, sempre mostrando antes o valor ou a taxa de cancelamento e esperando o seu sim. Você conecta com o e-mail e a senha do painel da Muralha; se a conta tiver verificação em duas etapas, o código do app autenticador é pedido na conexão. Não é um serviço oficial da Muralha Entregas nem da Machine.

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

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/muralha_entregas`
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/muralha_entregas/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/muralha_entregas/cancelar/entrega` — Cancela uma entrega (OS). Se o entregador já aceitou, a central pode cobrar taxa de cancelamento. Sem confirmar: true, só mostra se haverá taxa.
  - body: { os: string, tipo?: string, motivo?: string, confirmar?: boolean, aceitar_taxa?: boolean }
- `POST https://api.mcp.ai/api/muralha_entregas/detalhe/entrega` — Detalhe de uma ou mais entregas (OS): categoria, tarifa, valores, percurso, entregador, cada parada (endereço, cliente, valor a cobrar, confirmação) e cancelamento.
  - body: { os_ids?: string[], os?: string, tipo?: string }
- `POST https://api.mcp.ai/api/muralha_entregas/empresa` — Dados da empresa no painel: endereço de coleta, categorias de entrega, formas de pagamento liberadas e tempo padrão de despacho.
- `POST https://api.mcp.ai/api/muralha_entregas/estimar/entrega` — Estima preço, distância e tempo de uma entrega pela tabela da Muralha Entregas, sem criar nada. Aceita endereço ou lat/lng por parada.
  - body: { entregas: object[], coleta?: object, categoria?: string, forma_pagamento?: string, com_retorno?: boolean }
- `POST https://api.mcp.ai/api/muralha_entregas/extrato` — Extrato da carteira de créditos: consumos por OS, recargas, saques e estornos, com resumo do período.
  - body: { data_inicio?: string, data_fim?: string, tipo?: string, os?: string, pagina?: integer, por_pagina?: integer }
- `POST https://api.mcp.ai/api/muralha_entregas/listar/entregas` — Lista as entregas da empresa no histórico do painel da Muralha Entregas (até 31 dias por consulta, 30 por página): OS, quando, status, quantidade de paradas e entregador.
  - body: { data_inicio?: string, data_fim?: string, status?: string, pagina?: integer }
- `POST https://api.mcp.ai/api/muralha_entregas/saldo` — Saldo da carteira de créditos da empresa na Muralha Entregas e o saldo mínimo exigido por entrega.
- `POST https://api.mcp.ai/api/muralha_entregas/solicitar/entrega` — Solicita uma entrega (chama um entregador) na Muralha Entregas. GERA COBRANÇA REAL. Sem confirmar: true, só devolve a prévia com o valor; mostre ao usuário e só confirme com o sim dele, reusando a mes
  - body: { entregas: object[], coleta?: object, categoria?: string, forma_pagamento?: string, com_retorno?: boolean, despachar_em_minutos?: integer, chave_idempotencia?: string, confirmar?: boolean }
- `POST https://api.mcp.ai/api/muralha_entregas/status/entrega` — Status atual de uma ou mais entregas (OS), com entregador e paradas. Opcionalmente gera o link de rastreio de cada parada para mandar ao cliente.
  - body: { os_ids?: string[], os?: string, link_rastreio?: boolean }

## Example prompts
- "Quanto tenho de saldo na Muralha Entregas?"
- "Liste as entregas desta semana e quais foram canceladas"
- "Quanto custa uma entrega daqui até a Rua Exemplo, 100, Centro?"

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