@xpayr/mcp-server v1.0.0 · Registro: io.github.xpayrcom/xpayr-mcp-server · 21 Ferramentas

Servidor Model Context Protocol (MCP) para Comércio Cripto Não Custodial.

Conceda aos agentes Claude Desktop, Cursor, VS Code Copilot, Windsurf, Cline e n8n acesso nativo e protegido por políticas a 21 ferramentas XPayr fortemente tipadas — crie checkouts multichain em USDT/USDC, verifique webhooks HMAC, envie intenções autônomas de pagamento e modele divisões de liquidação 99.5% / 0.5% on-chain.

21 FerramentasAbrangendo checkout, webhooks, agentes de IA e tesouraria do lojista.
2 TransportesJSON-RPC 2.0 Remoto (/api/mcp) + Local npx Stdio.
6 SuítesDelimitando janelas de contexto via --suite flagship ou all.
Limites de ProteçãoTetos por transação, orçamentos diários e filas de aprovação humana.

Configuração em 1 Clique para IDEs e Clientes de Agentes


        

Teste ao Vivo no Navegador → POST /api/mcp

Envie uma requisição JSON-RPC 2.0 real para o endpoint MCP Streamable HTTP ao vivo da XPayr diretamente desta página.

// Click "Run tools/list" or "Run Fee Split ($250 USDC)" to inspect live JSON-RPC 2.0 output from https://xpayr.com/api/mcp

Todas as 21 ferramentas MCP oficiais

xpayr_health_check

Verificação de integridade do API Gateway

Verifique a saúde operacional, a versão e o carimbo de data/hora do servidor da XPayr Gateway API v1.

GET /health Público (Sem chave)
xpayr_create_payment_session

Criar sessão de pagamento cripto (Checkout Duplo)

Crie uma sessão de pagamento cripto não custodial com suporte a pagamento Web3 em 1 clique, transferência direta via QR de corretoras, links multichain, links reutilizáveis por 1 ano e envio automático de faturas HTML por e-mail.

POST /payments Bearer sk_test / sk_live
xpayr_get_payment_session

Obter detalhes da sessão de pagamento

Recupere todos os detalhes, metadados, valores de divisão de liquidação, modo de checkout e hash de transação on-chain de uma sessão de pagamento.

GET /payments/{session_id} Bearer sk_test / sk_live
xpayr_list_payment_sessions

Listar sessões de pagamento do lojista

Liste as sessões de pagamento cripto do lojista com filtragem por status, moeda, rede e paginação.

GET /payments Bearer sk_test / sk_live
xpayr_get_public_payment_status

Consultar status público do pagamento on-chain

Consulte em tempo real o status público do checkout, tx_hash on-chain, endereço da carteira remetente, confirmações de bloco e carimbo paid_at sem chave de API.

GET /payments/{session_id}/status Público (Sem chave)
xpayr_apply_payment_coupon

Aplicar cupom de desconto no checkout

Valide e aplique um código de cupom promocional de desconto do lojista a uma sessão de pagamento pendente ativa.

POST /payments/{session_id}/coupon Público (Sem chave)
xpayr_get_merchant_profile

Obter perfil do lojista e carteira de liquidação

Recupere o perfil autenticado do lojista, o endereço da carteira de liquidação, a taxa de comissão em pontos-base (50 bps = 0.5%) e as chaves de API ativas.

GET /me Bearer sk_test / sk_live
xpayr_get_merchant_balance

Obter volume e saldo de liquidação multichain

Consulte o volume confirmado de liquidação não custodial, a contagem de transações e as taxas da plataforma agrupados por moeda e rede blockchain.

GET /me/balance Bearer sk_test / sk_live
xpayr_get_supported_networks

Listar redes, chains e tokens suportados

Liste todas as redes blockchain ativas EVM, TRON, Solana e Arc Mainnet/Testnet, IDs de chain, endpoints RPC, contratos divisores e tokens suportados.

GET /me/networks Bearer sk_test / sk_live
xpayr_get_webhook_config

Obter configuração e eventos de webhook

Inspecione a URL de callback de webhook do lojista, o segredo de assinatura HMAC-SHA256 mascarado e os eventos inscritos do ciclo de vida do pagamento.

GET /webhooks Bearer sk_test / sk_live
xpayr_set_webhook_endpoint

Configurar endpoint de webhook HTTPS

Configure ou atualize a URL receptora HTTPS de webhooks do lojista e gere um novo segredo de assinatura HMAC-SHA256 de 32 bytes.

POST /webhooks Bearer sk_test / sk_live
xpayr_send_test_webhook

Disparar evento de webhook de teste assinado

Envie um payload test.webhook assinado com cabeçalhos HMAC-SHA256 para validar a verificação de assinatura de webhook do lojista.

POST /webhooks/test Bearer sk_test / sk_live
xpayr_create_ai_agent

Criar agente de comércio de IA controlado por políticas

Provisione uma nova identidade de agente de comércio de IA gerenciada pelo lojista com credenciais delimitadas e limites de gastos programáveis.

POST /agents Bearer sk_test / sk_live
xpayr_list_ai_agents

Listar agentes de comércio de IA do lojista

Liste todos os agentes de comércio de IA gerenciados pelo lojista com seus status, carteiras atribuídas e políticas de gastos.

GET /agents Bearer sk_test / sk_live
xpayr_update_ai_agent_policy

Atualizar limites de gastos do agente de IA

Configure os limites da política de gastos de um agente de IA (máx. em USD por transação, teto diário, limite de aprovação automática, redes/tokens permitidos).

PUT /agents/{agent_id}/policy Bearer sk_test / sk_live
xpayr_submit_agent_payment_intent

Enviar intenção de pagamento autônoma de agente de IA

Envie uma intenção de pagamento autônoma de agente de IA avaliada em tempo real conforme as regras de política do lojista (approved, pending_approval, rejected).

POST /agent-intents Bearer agk_test / agk_live
xpayr_list_agent_payment_intents

Listar intenções de pagamento de agentes de IA e logs de auditoria

Liste as intenções de pagamento de agentes de IA, decisões de avaliação de políticas e registros de trilha de auditoria do lojista.

GET /agent-intents Bearer sk_test / sk_live
xpayr_bridge_agent_intent_to_checkout

Converter intenção de agente aprovada em sessão de checkout

Converta uma intenção de pagamento aprovada de agente de IA em uma sessão de pagamento XPayr executável ao vivo com URL de checkout hospedada e verificação on-chain.

POST /agent-intents/{intent_id}/bridge Bearer sk_test / sk_live
xpayr_approve_agent_intent

Aprovar intenção pendente de agente de IA (Human-in-the-Loop)

Aprove uma intenção de pagamento pendente de um agente de IA na fila de aprovação do lojista e converta-a para o checkout.

POST /agent-approvals/{intent_id}/approve Bearer sk_test / sk_live
xpayr_reject_agent_intent

Rejeitar intenção pendente de agente de IA

Rejeite uma intenção de pagamento pendente de um agente de IA na fila de aprovação do lojista informando um motivo para auditoria.

POST /agent-approvals/{intent_id}/reject Bearer sk_test / sk_live
xpayr_calculate_gateway_fee_and_split

Calculadora de divisão de taxa de 0.5% e tolerância de corretoras

Calcule de forma determinística a divisão da taxa fixa de 0.5% (50 bps) da XPayr, a liquidação líquida na carteira do lojista, a tolerância de saque de corretoras de 1% (máx. $0.50) e a economia em relação ao BitPay, Coinbase Commerce e Stripe.

LOCAL /tools/crypto-payment-fee-calculator Offline / Público

Perguntas frequentes sobre o servidor MCP da XPayr

Devo conectar via Streamable HTTP Remoto (/api/mcp) ou npx local (@xpayr/mcp-server)?

Ambos expõem todas as 21 ferramentas da XPayr com esquemas idênticos. O Streamable HTTP Remoto (https://xpayr.com/api/mcp) dispensa runtime Node.js local e funciona imediatamente em agentes em nuvem, n8n e IDEs modernas; já npx -y @xpayr/mcp-server@1.0.0 roda localmente via stdio e suporta filtragem por módulos (--suite flagship,checkout).

Agentes de IA podem chamar ferramentas MCP públicas sem uma chave de API?

Sim. Descoberta pública, verificação de saúde do gateway (xpayr_health_check), cálculo determinístico de divisão de 0.5% (xpayr_calculate_gateway_fee_and_split) e consulta pública de status de sessão funcionam sem credenciais. Ferramentas autenticadas de criação de checkout e intenções de agente usam sua chave sk_test_ ou sk_live_.

Como os guardrails de gastos impedem que uma alucinação de LLM gaste além do permitido?

Os Agentes de Comércio de IA da XPayr impõem no servidor tetos por transação, orçamentos diários móveis, limites de aprovação automática, listas brancas de redes/tokens e filas de aprovação humana (/agent-commerce) antes que qualquer fundo se mova on-chain.

Onde o XPayr MCP é publicado e verificado?

O XPayr MCP é publicado no npm (@xpayr/mcp-server@1.0.0), GitHub Container Registry (ghcr.io/xpayrcom/xpayr-mcp-server), Registro Oficial MCP, Glama e Smithery, e documentado em https://mcp.xpayr.com e /.well-known/mcp.json.