# API AutoConsulta

# API AutoConsulta

Uma chave, um `POST`, um resultado.

```bash
curl -X POST "https://api.consultas.us" \
  -H "X-API-Key: SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "consultation_type": "antecedentes-cpf",
    "input_data": { "cpf": "11144477735" }
  }'
```

## O que dá para fazer

| Você quer | Use |
| --- | --- |
| Executar uma consulta | `POST /` |
| Saber quanto vai custar, antes | `POST /estimate` |
| Ver o que sua conta pode consultar | `GET /catalog` |
| Ver seu saldo | `GET /balance` |
| Acompanhar uma consulta demorada | `GET /status` |
| Recuperar algo que você já consultou | `GET /lookup` |

Cada uma está descrita, com os campos e os exemplos, na [Referência da API](/referencia).

## Três coisas que economizam tempo

**1. Confira `success`, não só o status HTTP.** Alguns desfechos de falha chegam com **HTTP 200 e
`success: false`**. É o campo `success` que diz se deu certo, e o `code` que diz o quê. Ramifique no
`code` — ele é estável; o texto da mensagem não é.

**2. O saldo da carteira é o limite.** Não há cota, franquia nem teto além dele.

**3. O catálogo é a fonte, não esta página.** Preço e disponibilidade variam por conta.
`GET /catalog` devolve o preço efetivo **da sua conta** e o contrato de entrada de cada produto —
consulte-o em tempo de execução em vez de fixar valores no seu código.

## Antes de gastar

`POST /estimate` responde quanto custaria, de onde o pagamento sairia, se a entrada está completa e
se aquele documento **já está no seu histórico**. Não cobra e não executa nada.

Se já estiver no histórico, `GET /lookup` traz o resultado de novo — também sem cobrar.

## Sem escrever código: o servidor MCP

Além da API HTTP, a AutoConsulta expõe um **servidor MCP** (*Model Context Protocol*). Você o
conecta ao seu cliente MCP e passa a consultar conversando — mesmas consultas, mesmos preços, mesma
carteira.

```
https://mcp.consultas.us/mcp
```

Veja [o que é o MCP](/assistente/visao-geral) e [como conectar](/assistente/conectar).