● Documentação

A API da Mercado Phone

Acesse e construa sobre os dados da sua loja — estoque, vendas, ordens de serviço, financeiro, clientes e catálogo — por REST e por MCP. Autentique com sua chave e comece em minutos.

Início rápido
# Liste as vendas da sua loja
curl https://platform.mercadophone.tech/api/v1/sales/history \
  -H "X-API-Key: SUA_CHAVE"

# Cadastre um cliente
curl -X POST https://platform.mercadophone.tech/api/v1/customers \
  -H "X-API-Key: SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"nome": "João da Silva", "telefone": "11999990000"}'
Recursos
🏪

Dados da sua loja

Estoque, vendas, ordens de serviço, financeiro, clientes e catálogo — tudo acessível pela sua chave.

🤖

MCP nativo

Cada recurso também é uma ferramenta MCP. Conecte uma IA e ela lê e escreve na sua loja diretamente.

REST + MCP

A mesma API em REST (documentada nesta referência) e como servidor MCP unificado.

🔑

Autenticação por chave

Cada requisição usa sua API key no header X-API-Key — ela define os dados aos quais você tem acesso.

Conectar uma IA

Conecte uma IA à sua loja

Aponte seu cliente MCP (streamable-http) para /mcp/platform com sua chave no header. A IA recebe o conjunto completo de ferramentas — leitura e escrita — da sua loja.

URL   /mcp/platform
Header   X-API-Key: ••••••