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

# Servidor MCP

> O servidor MCP oficial da WyzeCash: a API, a documentação e prompts prontos para a sua IA.

O **servidor MCP da WyzeCash** conecta assistentes de IA (Cursor, Claude Code, Codex, VS Code e Claude Desktop) direto à API da WyzeCash e a esta documentação, sem a IA adivinhar rotas, campos ou formatos.

## O que o MCP oferece

| Camada | O que faz |
| - | - |
| **Documentação** | `listar_operacoes`, `ver_operacao` e `buscar_documentacao`: as rotas, os campos tirados do esquema real da API, webhooks, erros e limites |
| **Código pronto** | `exemplo_codigo` escreve o pedido em cURL, Node.js, Python ou PHP, com a chave em variável de ambiente |
| **Sua conta** | Com a chave de API: criar cobranças e links e consultar cobranças, saldo, tarifas, extrato, comprovantes, MED e subcontas |
| **Diagnóstico** | `testar_chave` diz se a chave vale, de qual conta é e quais permissões tem |
| **Prompts** | [Dez fluxos prontos](https://docs.wyzecash.com.br/mcp/prompts.md), cada um com os endpoints que usa: cobrança Pix, no cartão e em cripto, link de pagamento, webhooks, assinatura, saldo e extrato, subcontas, MED e testar a chave |

## Endpoint

`https://api.wyzecash.com.br/mcp`

Streamable HTTP, sem instalar nada. A chave de API é opcional: sem ela, a IA usa a documentação; com ela, também a sua conta ([Autenticação](https://docs.wyzecash.com.br/mcp/autenticacao.md)).

## Por que MCP e não só a documentação?

Esta documentação (também em [`llms.txt`](https://docs.wyzecash.com.br/llms.txt)) é ótima para dar contexto. O MCP vai além:

* **Descobre** as rotas com `listar_operacoes` e `ver_operacao`, sempre iguais ao que a API aceita
* **Executa** chamadas reais com a sua chave, com as mesmas regras da API: permissões, limite de pedidos e `Idempotency-Key`
* **Escreve o código** da integração na linguagem do seu projeto
* **Nunca tira dinheiro:** saque, Pix enviado e estorno ficam só na documentação, para você rodar no seu sistema

## Fluxo típico

```mermaid theme={null}
flowchart LR
  IA[Sua IA] --> MCP[MCP da WyzeCash]
  MCP --> Docs[Documentação]
  MCP --> API[API v1 da WyzeCash]
  Docs --> IA
  API --> IA
```

## Próximos passos

> [card] [Autenticação](https://docs.wyzecash.com.br/mcp/autenticacao.md)
>
> Chave de API e permissões

> [card] [Configurar no Cursor](https://docs.wyzecash.com.br/mcp/cursor.md)
>
> Conectar pelo HTTP

> [card] [Ferramentas](https://docs.wyzecash.com.br/mcp/ferramentas.md)
>
> Documentação, código e conta

> [card] [Exemplos](https://docs.wyzecash.com.br/mcp/exemplos.md)
>
> Prompts e fluxos prontos


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