# Mercado Phone API
> A API da sua loja Mercado Phone: estoque, vendas, ordens de serviço, financeiro, clientes e catálogo. Acessível por REST e por MCP.

Base: https://platform.mercadophone.tech
Autenticação: toda requisição leva o header `X-API-Key: mpk_...`. Crie a sua chave em https://platform.mercadophone.tech/account.

## Conectar uma IA
- MCP (recomendado): cada chave tem um link próprio. Cole no seu assistente:
  https://platform.mercadophone.tech/mcp/platform/?key=mpl_token_do_link
- Ou consuma a API REST diretamente com o header X-API-Key.

## Documentos
- Especificação OpenAPI 3.1: https://platform.mercadophone.tech/openapi.json
- Guia + lista completa de endpoints (texto): https://platform.mercadophone.tech/llms-full.txt
- Documentação para humanos: https://platform.mercadophone.tech/docs

## Recursos (cada um em REST e como ferramenta MCP)
Lojas, Vendas, Estoque, Clientes, Pessoas, Ordens de serviço, Financeiro, Notas fiscais, Arquivos, Metas de venda, Catálogo.

## Várias lojas
Uma chave pode cobrir mais de uma loja. Liste com `GET /api/v1/stores`. Escolha a loja pelo header `X-Unit-Id`, ou use os endpoints `.../all`, que consultam todas as lojas da chave e agregam o resultado.