Safefy MCP
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SAFEFY_PUBLIC_KEY | Yes | Your Safefy Public Key (starts with pk_) | |
| SAFEFY_SECRET_KEY | Yes | Your Safefy Secret Key (starts with sk_) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| safefy_payment_get_integration_guideA | Mostra um passo a passo de integracao (SDK Node ou API direta). Use somente quando o usuario pedir ajuda para integrar. |
| safefy_payment_list_capabilitiesA | Mostra tudo que este MCP consegue fazer. Nao executa operacoes financeiras, apenas informa capacidades. NAO use este tool quando o usuario pedir uma acao concreta (criar cliente, PIX, etc.) — nesses casos va direto para a tool de execucao. |
| safefy_payment_configure_credentialsA | Configura as credenciais da conta. Peca APENAS publicKey (pk_...) e secretKey (sk_...). O ambiente e detectado automaticamente pelo prefixo das chaves (pk_sandbox_ ou pk_production_). NAO peca environment, NAO peca baseUrl — esses sao configurados automaticamente. |
| safefy_payment_get_configurationA | Verifica se as credenciais ja estao configuradas. Chame antes de qualquer operacao para saber se precisa pedir credenciais ao usuario. |
| safefy_payment_authenticateA | Faz login novamente na API e atualiza o token de acesso. |
| safefy_payment_api_requestB | Executa uma chamada real para qualquer rota da API de pagamentos. Use quando nao houver tool dedicada. |
| safefy_payment_get_balanceA | Consulta e retorna o saldo atual. Chame imediatamente quando o usuario perguntar 'qual meu saldo', 'quanto tenho disponivel', etc. |
| safefy_payment_create_transactionA | Cria cobranca PIX, boleto ou cartao na API agora. NAO pergunte 'via API ou painel' nem 'qual framework' — voce JA ESTA conectado a API. 'gera um PIX de R$50' = chame com method=Pix, amount=5000. 'boleto de R$100' = method=Boleto, amount=10000. Valores em centavos. Nao pede merchant ID. APOS criar: se for PIX exiba o campo pixCopyPaste em destaque como 'PIX Copia e Cola'; se for Boleto exiba boletoDigitableLine. Esses campos estao no topo do resultado. |
| safefy_payment_list_transactionsC | Lista suas transacoes com filtros. |
| safefy_payment_get_transactionA | Obtém uma transação por ID via /v1/transactions/{transactionId}. |
| safefy_payment_simulate_transactionA | Simula mudança de status de transação em Sandbox via /v1/transactions/{transactionId}/simulate. |
| safefy_payment_resend_transaction_webhookB | Reenvia webhook de transação completed via /v1/transactions/{transactionId}/resend-webhook. |
| safefy_payment_create_cashoutA | Solicita saque agora. Quando o usuario pedir 'solicita um saque de R$X', 'quero sacar R$X', chame esta tool. Valores em centavos. |
| safefy_payment_list_cashoutsA | Lista saques com paginação via /v1/cashouts. |
| safefy_payment_get_cashoutA | Obtém saque por ID via /v1/cashouts/{id}. |
| safefy_payment_cancel_cashoutA | Cancela saque via /v1/cashouts/{id}/cancel. |
| safefy_payment_simulate_cashoutB | Simula saque em sandbox via /v1/cashouts/{id}/simulate. |
| safefy_payment_create_customerB | Cria um cliente na API agora. Não pergunte 'via API ou painel' nem 'qual framework' — você JA ESTÁ conectado à API. Se o usuário disser 'cria cliente chamado Jorge', chame esta tool com name='Jorge'. Dados mínimos: name. Email, documento e outros são opcionais. Não pede merchant ID. |
| safefy_payment_list_customersC | Lista clientes via /v1/customers. |
| safefy_payment_get_customerB | Obtém cliente por ID via /v1/customers/{id}. |
| safefy_payment_update_customerB | Atualiza cliente via /v1/customers/{id}. |
| safefy_payment_create_orderC | Cria pedido com itens e pagamento via /v1/orders. |
| safefy_payment_list_ordersB | Lista pedidos via /v1/orders. |
| safefy_payment_get_orderA | Obtém pedido por ID via /v1/orders/{orderId}. |
| safefy_payment_list_productsB | Lista produtos cadastrados do merchant via /v1/products. |
| safefy_payment_get_productA | Obtém produto por ID via /v1/products/{productId}. |
| safefy_payment_get_payment_linkA | Consulta link de pagamento público via /v1/payment-links/{token}. |
| safefy_payment_start_payment_linkC | Inicia cobrança de payment link via /v1/payment-links/{token}/start. |
| safefy_payment_get_payment_link_statusB | Consulta status de cobrança de payment link por sessão via /v1/payment-links/{token}/payments/{paymentId}/status. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 29 tools
Each tool targets a distinct resource and action, from configuration and authentication to transactions, cashouts, customers, orders, products, and payment links. The generic api_request tool is clearly scoped as a fallback for routes without dedicated tools, preventing confusion.
All tools follow a consistent safefy_payment_<verb>_<noun> pattern in snake_case, with only minor deviations like 'authenticate' and 'api_request'. This predictability makes it easy for an agent to infer function from the name.
At 29 tools, the set is comprehensive but heavy. While most tools serve a clear purpose for a full payment API, the count edges into the 'too many' range and could be streamlined by consolidating niche operations like simulate and resend-webhook.
The set covers core operations for transactions, cashouts, customers, orders, products, and payment links, but lacks some lifecycle operations (e.g., refund/cancel transaction, update/delete product, create payment link). The generic api_request mitigates gaps but leaves the dedicated surface incomplete.