Conexão
URL do servidor (Streamable HTTP):
https://pay.snapex.pro/mcp
Não é preciso chave para começar: o agente chama create_account e continua com a nova chave na mesma sessão. Configurações para os clientes mais usados:
Claude Code
claude mcp add --transport http snapex-pay https://pay.snapex.pro/mcp
Cursor — ~/.cursor/mcp.json
{
"mcpServers": {
"snapex-pay": {
"url": "https://pay.snapex.pro/mcp"
}
}
}
VS Code — .vscode/mcp.json
{
"servers": {
"snapex-pay": {
"type": "http",
"url": "https://pay.snapex.pro/mcp"
}
}
}
Windsurf — ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"snapex-pay": {
"serverUrl": "https://pay.snapex.pro/mcp"
}
}
}
Claude Desktop — claude_desktop_config.json
{
"mcpServers": {
"snapex-pay": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://pay.snapex.pro/mcp"
]
}
}
}
Conectores do claude.ai e do ChatGPT
Adicione um conector personalizado com a URL do servidor. Esses clientes não enviam cabeçalhos: depois de create_account, pegue mcp_personal_url da resposta e use como URL do conector — assim cada novo chat usa a mesma conta. Guarde essa URL como uma senha.
Se você já tem uma chave
Adicione o cabeçalho Authorization: Bearer smk_… — a chave de comerciante do painel (Comerciante → Desenvolvedores) ou a de create_account.
{
"mcpServers": {
"snapex-pay": {
"url": "https://pay.snapex.pro/mcp",
"headers": {
"Authorization": "Bearer smk_…"
}
}
}
}
Como o agente trabalha
- Conecte a URL — sem chave.
- O agente chama
create_account: sem captcha e sem e-mail. Recebe uma chave com todas as permissões e a sessão continua com ela. - Para receber:
create_invoice→ o pagador abrepay_url→get_invoicemostra paid. Os pagamentos entram no saldo em USDT. - Para pagar:
preview_payoutmostra o valor e a taxa,create_payoutenvia — em qualquer moeda delist_assets.
Ferramentas
As mesmas ferramentas no servidor remoto e no pacote local. Cada resposta é JSON; um erro diz o que fazer em seguida.
Conta
create_account, get_account
Moedas, cotações e taxas (sem chave)
list_assets, get_fiat_rates, get_fees, list_static_address_networks
Saldo e histórico
get_balances, list_transactions
Recebimento: faturas, pagamentos, endereços permanentes
create_invoice, get_invoice, list_invoices, get_invoice_payment_methods, select_invoice_payment_method, preview_payment, create_payment, get_payment, list_payments, create_static_address, list_static_addresses, list_static_address_deposits
Envio: pagamentos
preview_payout, create_payout, get_payout, list_payouts
Troca: conversões
preview_conversion, create_conversion, get_conversion, list_conversions
Webhooks
list_webhooks, create_webhook, update_webhook, rotate_webhook_secret
Segurança
- A chave e a senha gerada aparecem uma única vez, na resposta de
create_account. Com o login e a senha uma pessoa entra no painel. - O agente movimenta só o dinheiro da própria conta. Uma conta nova começa do zero; o dinheiro vem dos pagamentos das suas faturas e endereços.
- Enviar são dois passos:
preview_payoutmostra o valor e a taxa,create_payoutenvia com oidempotency_keydo próprio agente — uma nova tentativa nunca paga duas vezes. - Modo de teste: uma fatura com environment test percorre todo o fluxo sem dinheiro real.
- Limites: poucas contas novas por IP por hora; pagamentos — 5 por minuto e 30 por hora por chave.
- O que pode e o que não pode ser vendido: Regras
Sem MCP
O mesmo funciona pela API REST: a conta em uma requisição e depois a Merchant API com a chave.
curl -X POST https://pay.snapex.pro/api/v1/merchant/signup -H 'Content-Type: application/json' -d '{"agent":"my-agent"}'