{"success": true, "data": {"name": "Nucleo Pay API", "version": "1.0.0", "description": "API REST e webhooks para cobranças PIX, boleto e cripto na Nucleo Pay (Brasil).", "mcp": {"server": "nucleopay", "transport": "stdio", "entry": "python -m mcp_server", "compatibleClients": ["Cursor", "Claude Desktop", "Lovable", "Trae"], "manifestUrl": "https://nucleopay.com.br/api/integrations/mcp/manifest", "guideUrl": "https://nucleopay.com.br/api/integrations/mcp/guide", "traeSetup": {"note": "No Trae (Windows) use python.exe com caminho absoluto. Não use .bat (erro cmd.exe ENOENT).", "windowsLauncher": "python.exe direto — ver trae-mcp.example.json", "exampleConfig": "mcp_server/trae-mcp.example.json", "globalConfigPathWindows": "%APPDATA%\\Trae\\User\\mcp.json"}, "env": {"NUCLEOPAY_API_BASE_URL": "https://nucleopay.com.br", "NUCLEOPAY_API_TOKEN": "seu_token_bearer"}, "httpBridge": {"url": "https://nucleopay.com.br/api/integrations/mcp/call", "method": "POST", "auth": "Bearer NUCLEOPAY_API_TOKEN", "body": {"tool": "create_pix_charge", "arguments": {"value": 10, "title": "Teste"}}, "note": "Bridge remoto sem instalar Python local. Stdio MCP continua disponível."}}, "baseUrl": "https://nucleopay.com.br", "authentication": {"type": "bearer", "header": "Authorization", "format": "Bearer {token}", "tokenCreate": "POST /api/auth/token/create"}, "webhooks": {"signatureHeader": "X-NucleoPay-Signature", "signatureAlgorithm": "HMAC-SHA256", "signatureFormat": "sha256={hex}", "events": ["charge.created", "charge.approved", "charge.declined", "charge.refund", "charge.updated", "webhook.test"], "payloadShape": {"event": "string", "timestamp": "ISO8601", "data": {"chargeId": "string", "order_id": "string", "status": "Pendente | Aprovado | Recusado | ...", "statusCode": "pending | approved | declined | canceled | expired | failed | refunded", "livemode": "boolean", "value": "number (BRL)", "title": "string", "product_id": "string", "external_id": "string", "customer_name": "string", "customer_email": "string", "customer_cpf": "string", "customer_phone": "string", "provider": "string", "createdAt": "ISO8601", "approvedAt": "ISO8601"}}}, "integrationFlow": ["Criar token em POST /api/auth/token/create (mode: test|live)", "Configurar webhook em POST /api/webhooks/create (opcional)", "Criar cobrança PIX em POST /api/pix/charge/create com value + title (opcional: Idempotency-Key)", "Ou crypto: ativar wallet no painel e POST /api/crypto/charge/create → copyAddress + qrCodeImage", "Exibir brCode/qrCodeImage (PIX) ou copyAddress/qrCodeImage (crypto)", "Sandbox PIX: POST /api/pix/charge/simulate-pay — Produção: webhook charge.approved", "Bridge remoto: POST /api/integrations/mcp/call sem instalar Python"], "endpoints": [{"method": "POST", "path": "/api/pix/charge/create", "summary": "Cria cobrança PIX", "auth": true, "body": {"value": "number (BRL) — obrigatório se sem product_id", "title": "string — nome do produto/cobrança", "description": "string (opcional)", "product_id": "string (opcional) — produto cadastrado na Nucleo", "external_id": "string (opcional) — ID no seu sistema", "customer_name": "string (opcional)", "customer_email": "string (opcional)", "customer_cpf": "string (opcional)", "customer_phone": "string (opcional)", "customer_zip": "string (opcional)", "customer_street": "string (opcional)", "customer_number": "string (opcional)", "customer_complement": "string (opcional)", "customer_neighborhood": "string (opcional)", "customer_city": "string (opcional)", "customer_state": "string (opcional)", "customer_address": "string (opcional)", "address": "object (opcional) — zip/street/number/complement/neighborhood/city/state"}, "response": {"chargeId": "string", "status": "Pendente", "value": "number", "brCode": "string (copia-e-cola PIX)", "qrCodeImage": "string (base64 ou URL)", "provider": "string"}}, {"method": "GET", "path": "/api/pix/charge/status", "summary": "Consulta status de uma cobrança", "auth": true, "query": {"charge_id": "string (obrigatório)"}}, {"method": "GET", "path": "/api/pix/charges", "summary": "Lista cobranças PIX recentes", "auth": true, "query": {"limit": "number (1-200, default 50)"}}, {"method": "GET", "path": "/api/webhooks", "summary": "Lista webhooks cadastrados", "auth": true}, {"method": "POST", "path": "/api/webhooks/create", "summary": "Cadastra webhook", "auth": true, "body": {"url": "https://...", "events": ["charge.approved"]}}, {"method": "POST", "path": "/api/webhooks/test", "summary": "Envia evento de teste ao webhook", "auth": true, "body": {"id": "webhook_id"}}, {"method": "GET", "path": "/api/auth/tokens", "summary": "Lista tokens de API da conta", "auth": true}, {"method": "POST", "path": "/api/auth/token/create", "summary": "Cria novo token de API", "auth": true, "body": {"label": "string", "mode": "test | live (opcional)"}}, {"method": "POST", "path": "/api/pix/charge/simulate-pay", "summary": "Aprova cobrança sandbox (só np_test_)", "auth": true, "body": {"charge_id": "string"}}, {"method": "POST", "path": "/api/crypto/charge/create", "summary": "Cria cobrança Bitcoin (wallet do lojista; retorna QR + copyAddress)", "auth": "Bearer ou product_id no checkout", "body": {"value": "number (BRL)", "product_name": "string (opcional)", "product_id": "string (opcional)", "customer_name": "string (opcional)", "customer_email": "string (opcional)"}, "response": {"chargeId": "string (BTC-…)", "status": "Pendente", "statusCode": "pending", "amountBrl": "number", "amountCrypto": "string", "address": "string", "copyAddress": "string", "payUri": "bitcoin:…", "qrCodeImage": "string (URL)", "expiresAt": "ISO8601", "provider": "crypto"}}, {"method": "GET", "path": "/api/crypto/charge/status", "summary": "Status crypto (poll Blockstream; charge.approved ao confirmar)", "auth": "opcional (checkout público por charge_id)", "query": {"charge_id": "string (obrigatório)"}}, {"method": "GET", "path": "/api/crypto/quote", "summary": "Cotação BTC/BRL", "auth": false, "query": {"brl": "number (opcional)"}}, {"method": "POST", "path": "/api/integrations/mcp/call", "summary": "Bridge HTTP remoto das tools MCP", "auth": "Bearer (exceto manifest/snippet/verify)", "body": {"tool": "create_pix_charge", "arguments": {}}}], "mcpTools": ["get_integration_manifest", "create_pix_charge", "get_pix_charge_status", "list_pix_charges", "list_webhooks", "create_webhook", "test_webhook", "list_api_tokens", "verify_webhook_signature", "generate_integration_snippet", "simulate_pay"]}}