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

# MCP Server

> Servidor Model Context Protocol oficial da WovePay — API, docs e ferramentas compostas para agentes

O **WovePay MCP Server** conecta assistentes de IA (Cursor, Claude Desktop, agentes autônomos) diretamente à API WovePay e à documentação — sem adivinhar rotas ou formatos.

## O que o MCP oferece

| Camada                    | O que faz                                                                                   |
| ------------------------- | ------------------------------------------------------------------------------------------- |
| **API automática**        | Uma tool por `operationId` do OpenAPI v1 (101 operações) + `execute_operation` genérico     |
| **Documentação offline**  | `search_docs` e `fetch_doc` com índice local (instantâneo, sem depender da Mintlify online) |
| **Ferramentas compostas** | `create_checkout`, `configure_webhook`, `debug_api_key`, `analyze_webhook`                  |
| **Resources**             | `wovepay://spec/v1`, `wovepay://docs`, `wovepay://webhooks`, etc.                           |
| **Prompts**               | Fluxos sugeridos: criar PIX, webhook, checkout, testar API key                              |

## Endpoints

| Ambiente            | URL                                     |
| ------------------- | --------------------------------------- |
| **Produção (HTTP)** | `https://mcp.wovepay.com/mcp`           |
| **Health**          | `https://mcp.wovepay.com/health`        |
| **Local (stdio)**   | `MCP_BRAND=wovepay` + `WOVEPAY_API_KEY` |

O mesmo deploy também atende `mcp.wovepay.com` — a marca é resolvida pelo header `Host`.

## Por que MCP e não só llms.txt?

O [llms.txt](/pages/guides/integracao-ia) é ótimo para contexto estático. O MCP vai além:

* **Executa** chamadas reais na API com validação OpenAPI (Ajv)
* **Descobre** endpoints via `search_operations` / `get_operation`
* **Resolve tarefas completas** com tools compostas (checkout em uma chamada)
* **Retorna diagnósticos** HAR-like (status, headers, rate limit, duração)

## Fluxo típico

```mermaid theme={null}
flowchart LR
  Agent[Agente IA] --> MCP[mcp.wovepay.com]
  MCP --> Docs[Docs offline]
  MCP --> API[api.wovepay.com/v1]
  Docs --> Agent
  API --> Agent
```

## Próximos passos

<CardGroup cols={2}>
  <Card title="Autenticação" icon="key" href="/pages/mcp/authentication">
    API key, permissões e headers
  </Card>

  <Card title="Configurar no Cursor" icon="code" href="/pages/mcp/cursor">
    stdio local ou remoto HTTP
  </Card>

  <Card title="Tools disponíveis" icon="wrench" href="/pages/mcp/tools">
    Auto-geradas, discovery e compostas
  </Card>

  <Card title="Exemplos" icon="lightbulb" href="/pages/mcp/examples">
    Prompts e fluxos prontos
  </Card>
</CardGroup>