Model Context Protocol

VIO Pay MCP Server

Servidor MCP oficial da VIO Pay. Expõe 100% da API via tools, 5 workflows de alto nível, guias de integração e prompts guiados — pronto para plugar no seu cliente MCP.

Online · v0.1.0

Configuração do cliente

Adicione ao seu ~/.claude.json, .cursor/mcp.json, ou equivalente no cliente MCP:

{
  "mcpServers": {
    "viopay": {
      "transport": "http",
      "url": "https://mcp.viopay.com.br/mcp",
      "headers": {
        "Authorization": "Bearer "
      }
    }
  }
}

O que está disponível

558

Tools totais

Workflows compostos

Guias de integração

Prompts guiados

Workflows de alto nível

complete_pf_onboarding — abre conta PF completa em uma chamada (account-type → dados pessoais → SMS → documentos → ativação → timeline)
complete_pj_onboarding — abre conta PJ com consulta CNPJ, documentos da empresa e dos sócios
create_and_send_charge — resolve/cria cliente → cria my-receivable → gera cobrança → envia email
setup_recurring_subscription — configura assinatura recorrente com customer, billingType e cycle
configure_payment_split — cobrança com rateio entre fornecedores/representantes

Endpoints

POST /mcp — protocolo MCP (Streamable HTTP).
GET /health — healthcheck (resposta JSON com status).

Primeiros passos

Solicite suas credenciais VIO Pay (client ID e secret) com a equipe comercial.
Chame a tool login passando {client, secret} para obter o Bearer token.
Use o Bearer no header Authorization das requisições subsequentes ao MCP.
Consulte o resource viopay://guides pelo cliente MCP para ver todos os guias de integração.

Guias de integração → Healthcheck →