{"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"}}, "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 | ...", "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 (painel ou API autenticada)", "Configurar webhook em POST /api/webhooks/create (opcional)", "Criar cobrança PIX em POST /api/pix/charge/create com value + title", "Exibir brCode ou qrCodeImage ao comprador", "Receber charge.approved via webhook ou consultar GET /api/pix/charge/status?charge_id="], "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"}}], "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"]}}