> ## Documentation Index
> Fetch the complete documentation index at: https://dev.valorapayments.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Valora Payments API (Brazil: Pix, card, boleto). Base URL https://api.valorapayments.com.br, Authorization: Bearer sk_vl_... used only on the server. Request amounts are reais as strings ("149.90"); response amounts are integer cents (14990). Use POST /v1/checkouts for card and boleto; POST /v1/payments only creates Pix and should send an Idempotency-Key. Confirm payments only through the payment.succeeded webhook after verifying X-Valora-Signature (hex HMAC-SHA256 of "<t>.<raw body>"), dedupe by event.id and check livemode. Never invent endpoints or fields: check /llms.txt and /openapi.json.

# Servidor MCP

> Conecte a documentação da Valora ao seu agente pelo Model Context Protocol, para ele pesquisar e ler as páginas sozinho.

O servidor MCP deixa o seu agente pesquisar esta documentação durante o trabalho. Em vez de responder de memória, ele busca a página certa (por exemplo, como verificar a assinatura do webhook) e usa o conteúdo atual.

```text theme={null}
https://dev.valorapayments.com.br/mcp
```

O servidor só lê a documentação pública. Ele não acessa a sua conta, não cria cobranças e não precisa de chave.

## Conectar

> [tab] Claude Code
>
> ```bash theme={null}
> claude mcp add --transport http valora-docs https://dev.valorapayments.com.br/mcp
> ```
>
> Confira com `claude mcp list`.

> [tab] Cursor
>
> Crie ou edite `.cursor/mcp.json` no projeto (ou `~/.cursor/mcp.json` para todos os projetos):
>
> ```json .cursor/mcp.json theme={null}
> {
>   "mcpServers": {
>     "valora-docs": { "url": "https://dev.valorapayments.com.br/mcp" }
>   }
> }
> ```

> [tab] VS Code
>
> ```json .vscode/mcp.json theme={null}
> {
>   "servers": {
>     "valora-docs": { "type": "http", "url": "https://dev.valorapayments.com.br/mcp" }
>   }
> }
> ```

> [tab] Claude (app)
>
> Em **Configurações → Conectores → Adicionar conector personalizado**, use o nome `Valora Docs` e a URL `https://dev.valorapayments.com.br/mcp`.

> [tab] Outros
>
> Qualquer cliente MCP que aceite transporte HTTP funciona com a URL acima. A descoberta automática fica em `https://dev.valorapayments.com.br/.well-known/mcp`.

## Como usar

Peça ao agente para consultar a documentação antes de escrever código:

```text theme={null}
Use o MCP valora-docs para ler as páginas de checkout e de webhooks da Valora.
Depois, crie a rota de checkout e o endpoint de webhook neste projeto.
```

> [!TIP]
>
> Junte o MCP com as [regras para o projeto](https://dev.valorapayments.com.br/ia/regras.md). O MCP traz os detalhes; as regras garantem que o agente nunca esqueça o essencial.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.