# Reclame Aqui — how to use (mcp.ai)

Manage your company's complaints on Reclame Aqui through the Company Area account. You provide the company user and password and the platform logs into your account to list complaints, read details, check reputation and reply to consumers. It does not use the paid RA API, it uses the same area you already access on the site.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/reclameaqui/listar/reclamacoes` — Lista as reclamações da sua empresa no Reclame Aqui (mais recentes primeiro). Traz id, título, status, consumidor, cidade/UF, se já foi respondida e avaliação.
  - body: { status?: string, limit?: integer, index?: integer, order?: string, order_type?: string }
- `POST https://api.mcp.ai/api/reclameaqui/reclamacao` — Detalhe de uma ou mais reclamações por id (conversa completa em treatments, avaliação, score, status). Aceita lista de ids.
  - body: { ids?: string[], id?: string }
- `POST https://api.mcp.ai/api/reclameaqui/reputacao` — Indicadores de reputação da sua empresa no Reclame Aqui (nota/rating e principais problemas reclamados).
- `POST https://api.mcp.ai/api/reclameaqui/responder` — Responde uma reclamação da sua empresa no Reclame Aqui. Por padrão é resposta PÚBLICA; use privada=true para mensagem interna ao consumidor. AÇÃO PÚBLICA — confirme o texto antes de enviar.
  - body: { id: string, mensagem: string, privada?: boolean, ids?: string[] }

## Example prompts
- "Which complaints have not been answered yet?"
- "Show me the detail of the latest complaint"
- "How is my company's reputation on Reclame Aqui?"

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