Abacate Pay MCP Server

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js"; import { z } from "zod"; import { makeAbacatePayRequest } from "../http/api.js"; import { resolveApiKey } from "../utils/api-key.js"; import { formatHttpError } from "../utils/errors.js"; export function registerPixTools(server: McpServer) { server.tool( "createPixQrCode", "Cria um QR Code PIX para pagamento direto", { amount: z.number().describe("Valor da cobrança em centavos"), expiresIn: z.number().optional().describe("Tempo de expiração em segundos (opcional)"), description: z.string().max(140).optional().describe("Mensagem que aparecerá no pagamento PIX (máx 140 caracteres)"), customer: z.object({ name: z.string().describe("Nome completo do cliente"), cellphone: z.string().describe("Celular do cliente"), email: z.string().email().describe("E-mail do cliente"), taxId: z.string().describe("CPF ou CNPJ do cliente") }).optional().describe("Dados do cliente (opcional)") }, async (params) => { const { amount, expiresIn, description, customer } = params as any; const finalApiKey = resolveApiKey(); if (!finalApiKey) { return { content: [ { type: "text", text: "❌ Erro: API key é obrigatória. Configure via header HTTP ou configure globalmente via variável de ambiente ABACATE_PAY_API_KEY." } ] }; } const requestBody: any = { amount }; if (expiresIn) { requestBody.expiresIn = expiresIn; } if (description) { requestBody.description = description; } if (customer) { requestBody.customer = customer; } const result = await makeAbacatePayRequest<any>("/pixQrCode/create", finalApiKey, { method: "POST", body: JSON.stringify(requestBody) }); if (result.error) { const errorMessage = formatHttpError(result.error); return { content: [ { type: "text", text: `Falha ao criar QR Code PIX: ${errorMessage}` } ] }; } const data = result.data?.data; if (!data) { return { content: [ { type: "text", text: "Erro: Resposta inválida da API" } ] }; } const amountFormatted = (data.amount / 100).toFixed(2); const feeFormatted = (data.platformFee / 100).toFixed(2); return { content: [ { type: "text", text: `🎯 **QR Code PIX criado com sucesso!**\n\n` + `📋 **Detalhes:**\n` + `• ID: ${data.id}\n` + `• Valor: R$ ${amountFormatted}\n` + `• Status: ${data.status}\n` + `• Taxa da Plataforma: R$ ${feeFormatted}\n` + `• Criado em: ${new Date(data.createdAt).toLocaleString('pt-BR')}\n` + `• Expira em: ${new Date(data.expiresAt).toLocaleString('pt-BR')}\n\n` + `📱 **Código PIX (Copia e Cola):**\n\`\`\`\n${data.brCode}\n\`\`\`\n\n` + `🖼️ **QR Code Base64:**\n${data.brCodeBase64.substring(0, 100)}...\n\n` + `${data.devMode ? '⚠️ Modo de desenvolvimento ativo' : '✅ Modo de produção'}` } ] }; } ); server.tool( "simulatePixPayment", "Simula o pagamento de um QR Code PIX (apenas em modo desenvolvimento)", { id: z.string().describe("ID do QR Code PIX para simular o pagamento"), metadata: z.object({}).optional().describe("Metadados opcionais para a requisição") }, async (params) => { const { id, metadata } = params as any; const finalApiKey = resolveApiKey(); if (!finalApiKey) { return { content: [ { type: "text", text: "❌ Erro: API key é obrigatória. Configure via header HTTP ou configure globalmente via variável de ambiente ABACATE_PAY_API_KEY." } ] }; } const requestBody: any = {}; if (metadata) { requestBody.metadata = metadata; } const result = await makeAbacatePayRequest<any>(`/pixQrCode/simulate-payment?id=${id}`, finalApiKey, { method: "POST", body: JSON.stringify(requestBody) }); if (result.error) { const errorMessage = formatHttpError(result.error); return { content: [ { type: "text", text: `Falha ao simular pagamento PIX: ${errorMessage}` } ] }; } const data = result.data?.data; if (!data) { return { content: [ { type: "text", text: "Erro: Resposta inválida da API" } ] }; } const amountFormatted = (data.amount / 100).toFixed(2); const feeFormatted = (data.platformFee / 100).toFixed(2); const statusEmojis: Record<string, string> = { 'PENDING': '⏳', 'PAID': '✅', 'EXPIRED': '⏰', 'CANCELLED': '❌', 'REFUNDED': '↩️' }; const statusEmoji = statusEmojis[data.status] || '❓'; return { content: [ { type: "text", text: `${statusEmoji} **Pagamento PIX simulado com sucesso!**\n\n` + `📋 **Detalhes do Pagamento:**\n` + `• ID: ${data.id}\n` + `• Status: ${data.status}\n` + `• Valor: R$ ${amountFormatted}\n` + `• Taxa da Plataforma: R$ ${feeFormatted}\n` + `• Criado em: ${new Date(data.createdAt).toLocaleString('pt-BR')}\n` + `• Atualizado em: ${new Date(data.updatedAt).toLocaleString('pt-BR')}\n` + `• Expira em: ${new Date(data.expiresAt).toLocaleString('pt-BR')}\n\n` + `${data.devMode ? '⚠️ Simulação realizada em modo de desenvolvimento' : '✅ Pagamento em produção'}\n\n` + `🎉 O pagamento foi processado com sucesso!` } ] }; } ); server.tool( "checkPixStatus", "Verifica o status de um QR Code PIX", { id: z.string().describe("ID do QR Code PIX para verificar o status") }, async (params) => { const { id } = params as any; const finalApiKey = resolveApiKey(); if (!finalApiKey) { return { content: [ { type: "text", text: "❌ Erro: API key é obrigatória. Configure via header HTTP ou configure globalmente via variável de ambiente ABACATE_PAY_API_KEY." } ] }; } const result = await makeAbacatePayRequest<any>(`/pixQrCode/check?id=${id}`, finalApiKey, { method: "GET" }); if (result.error) { const errorMessage = formatHttpError(result.error); return { content: [ { type: "text", text: `Falha ao verificar status do PIX: ${errorMessage}` } ] }; } const data = result.data?.data; if (!data) { return { content: [ { type: "text", text: "Erro: Resposta inválida da API" } ] }; } const statusEmojis: Record<string, string> = { 'PENDING': '⏳', 'PAID': '✅', 'EXPIRED': '⏰', 'CANCELLED': '❌', 'REFUNDED': '↩️' }; const statusEmoji = statusEmojis[data.status] || '❓'; return { content: [ { type: "text", text: `${statusEmoji} **Status do QR Code PIX**\n\n` + `📋 **ID**: ${id}\n` + `📊 **Status**: ${data.status}\n` + `⏰ **Expira em**: ${new Date(data.expiresAt).toLocaleString('pt-BR')}\n\n` + `${data.status === 'PENDING' ? '⏳ Aguardando pagamento...' : data.status === 'PAID' ? '✅ Pagamento confirmado!' : data.status === 'EXPIRED' ? '⏰ QR Code expirado' : data.status === 'CANCELLED' ? '❌ QR Code cancelado' : data.status === 'REFUNDED' ? '↩️ Pagamento estornado' : '❓ Status desconhecido'}` } ] }; } ); }