@pagosrd/mcp 0.0.0-stage → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Cambios
+
+## 0.1.1 (13-nov-2026)
+
+- Usa `@pagosrd/node` 0.1.1.
+- `package.json` enlaza el repositorio público.
+
+## 0.1.0 (12-nov-2026)
+
+- Primera versión: crear links de cobro, consultar pagos y reembolsar desde Claude u otros clientes MCP.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cristian Encarnación
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,35 @@
-# Temporary Holding Version
+# @pagosrd/mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Servidor MCP de PagosRD. Le permite a Claude (u otro cliente MCP) crear links de cobro, consultar pagos y reembolsar con la llave de API de tu plataforma.
+
+## Configuración
+
+```json
+{
+  "mcpServers": {
+    "pagosrd": {
+      "command": "npx",
+      "args": ["-y", "@pagosrd/mcp"],
+      "env": { "PAGOSRD_API_KEY": "sk_test_…" }
+    }
+  }
+}
+```
+
+`PAGOSRD_API_URL` es opcional (por defecto `https://api.pagosrd.com`).
+
+## Herramientas
+
+| Herramienta | Qué hace |
+|---|---|
+| `crear_link_de_cobro` | Crea un link y devuelve la URL para el cliente. El monto se da en pesos ("4,500.00"). |
+| `consultar_link`, `listar_links` | Estado de los links. |
+| `cancelar_link` | Cancela un link sin pagar (destructiva). |
+| `consultar_pago`, `listar_pagos` | Estado de los pagos. |
+| `reembolsar_pago` | Reembolso total o parcial (destructiva: mueve dinero en live). |
+| `listar_comercios` | Comercios de la plataforma. |
+| `resumen_de_cobros` | Totales de los últimos días. |
+
+Las herramientas destructivas están marcadas con `destructiveHint` para que el cliente pida confirmación.
+
+Licencia MIT.

package/dist/index.js

@@ -0,0 +1,193 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { PagosRD as PagosRD2 } from "@pagosrd/node";
+
+// src/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { formatMoney, PagosRDError, toCents } from "@pagosrd/node";
+import { z } from "zod";
+var pesos = z.string().describe('Monto en pesos dominicanos, por ejemplo "4,500.00" o "1500".');
+function linkText(l) {
+  return [
+    `Link ${l.id} (${l.status})`,
+    `Monto: ${formatMoney(l.amount, l.currency)}${l.itbis ? ` (ITBIS ${formatMoney(l.itbis, l.currency)})` : ""}`,
+    `Concepto: ${l.description}`,
+    l.reference ? `Referencia: ${l.reference}` : null,
+    l.customer.name ? `Cliente: ${l.customer.name}` : null,
+    `URL para pagar: ${l.url}`,
+    l.expires_at ? `Vence: ${l.expires_at}` : null,
+    l.livemode ? null : "Modo de prueba: no se cobra dinero real."
+  ].filter(Boolean).join("\n");
+}
+function paymentText(p) {
+  return [
+    `Pago ${p.id}: ${p.status}${p.requires_review ? " (requiere revisi\xF3n)" : ""}`,
+    `Monto: ${formatMoney(p.amount, p.currency)}${p.amount_refunded ? `, reembolsado ${formatMoney(p.amount_refunded, p.currency)}` : ""}`,
+    p.card ? `Tarjeta: ${p.card.brand ?? ""} terminada en ${p.card.last4}` : null,
+    p.failure_message ? `Detalle: ${p.failure_message}` : null,
+    p.paid_at ? `Pagado: ${p.paid_at}` : null,
+    p.payment_link_id ? `Link: ${p.payment_link_id}` : null
+  ].filter(Boolean).join("\n");
+}
+async function run(fn) {
+  try {
+    return { content: [{ type: "text", text: await fn() }] };
+  } catch (err) {
+    const message = err instanceof PagosRDError ? `${err.message}${err.field ? ` (campo: ${err.field})` : ""} [${err.code}]` : err.message;
+    return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+  }
+}
+function createServer(client2) {
+  const server2 = new McpServer({ name: "pagosrd", version: "0.1.1" });
+  server2.registerTool(
+    "crear_link_de_cobro",
+    {
+      title: "Crear link de cobro",
+      description: "Crea un link de cobro con tarjeta para un comercio y devuelve la URL para envi\xE1rsela al cliente (por WhatsApp o correo). Si no sabes el comercio, usa primero listar_comercios.",
+      inputSchema: {
+        comercio_id: z.string().describe("Id del comercio (mer_\u2026)."),
+        monto: pesos.describe('Total a cobrar en pesos, ITBIS incluido. Ej: "4,500.00".'),
+        itbis: pesos.optional().describe("Parte del monto que es ITBIS, en pesos. Om\xEDtelo si est\xE1 exento."),
+        concepto: z.string().min(1).max(140).describe('Qu\xE9 se cobra. Ej: "Cuota de mantenimiento octubre, Apto 4B".'),
+        referencia: z.string().max(100).optional().describe("Tu referencia interna (factura, cuota). Vuelve en los webhooks."),
+        cliente_nombre: z.string().optional(),
+        cliente_correo: z.string().optional(),
+        cliente_telefono: z.string().optional(),
+        idioma: z.enum(["es", "en"]).optional().describe("Idioma de la p\xE1gina de pago. Por defecto es."),
+        vence_en_dias: z.number().int().min(1).max(90).optional().describe("D\xEDas hasta que vence el link. Por defecto 30.")
+      },
+      annotations: { destructiveHint: false, idempotentHint: false, openWorldHint: true }
+    },
+    async (a) => run(async () => {
+      const link = await client2.paymentLinks.create({
+        merchant_id: a.comercio_id,
+        amount: toCents(a.monto),
+        itbis: a.itbis ? toCents(a.itbis) : void 0,
+        description: a.concepto,
+        reference: a.referencia,
+        customer: { name: a.cliente_nombre, email: a.cliente_correo, phone: a.cliente_telefono },
+        locale: a.idioma,
+        expires_at: a.vence_en_dias ? new Date(Date.now() + a.vence_en_dias * 864e5).toISOString() : void 0
+      });
+      return `Link de cobro creado.
+${linkText(link)}`;
+    })
+  );
+  server2.registerTool(
+    "consultar_link",
+    { title: "Consultar link de cobro", description: "Muestra el estado de un link de cobro (abierto, pagado, vencido o cancelado).", inputSchema: { link_id: z.string() }, annotations: { readOnlyHint: true } },
+    async (a) => run(async () => linkText(await client2.paymentLinks.retrieve(a.link_id)))
+  );
+  server2.registerTool(
+    "listar_links",
+    {
+      title: "Listar links de cobro",
+      description: "Lista links de cobro recientes. Puede filtrar por estado o por referencia.",
+      inputSchema: {
+        estado: z.enum(["open", "paid", "expired", "canceled"]).optional().describe("open = pendiente de pago."),
+        referencia: z.string().optional(),
+        cantidad: z.number().int().min(1).max(50).optional()
+      },
+      annotations: { readOnlyHint: true }
+    },
+    async (a) => run(async () => {
+      const list = await client2.paymentLinks.list({ status: a.estado, reference: a.referencia, limit: a.cantidad ?? 10 });
+      if (list.data.length === 0) return "No hay links que coincidan.";
+      return list.data.map(linkText).join("\n\n") + (list.has_more ? "\n\nHay m\xE1s resultados." : "");
+    })
+  );
+  server2.registerTool(
+    "cancelar_link",
+    {
+      title: "Cancelar link de cobro",
+      description: "Cancela un link que a\xFAn no se ha pagado, para que ya no se pueda pagar. Confirma con el usuario antes de usarla.",
+      inputSchema: { link_id: z.string() },
+      annotations: { destructiveHint: true, idempotentHint: true }
+    },
+    async (a) => run(async () => `Link cancelado.
+${linkText(await client2.paymentLinks.cancel(a.link_id))}`)
+  );
+  server2.registerTool(
+    "consultar_pago",
+    { title: "Consultar pago", description: "Muestra el detalle de un pago: estado, monto, tarjeta y reembolsos.", inputSchema: { pago_id: z.string() }, annotations: { readOnlyHint: true } },
+    async (a) => run(async () => paymentText(await client2.payments.retrieve(a.pago_id)))
+  );
+  server2.registerTool(
+    "listar_pagos",
+    {
+      title: "Listar pagos",
+      description: "Lista pagos recientes, con filtro opcional por estado.",
+      inputSchema: {
+        estado: z.enum(["pending", "processing", "succeeded", "failed", "canceled"]).optional().describe("succeeded = cobrado."),
+        cantidad: z.number().int().min(1).max(50).optional()
+      },
+      annotations: { readOnlyHint: true }
+    },
+    async (a) => run(async () => {
+      const list = await client2.payments.list({ status: a.estado, limit: a.cantidad ?? 10 });
+      if (list.data.length === 0) return "No hay pagos que coincidan.";
+      return list.data.map(paymentText).join("\n\n");
+    })
+  );
+  server2.registerTool(
+    "reembolsar_pago",
+    {
+      title: "Reembolsar pago",
+      description: "Devuelve dinero de un pago cobrado al cliente, total o parcial. Mueve dinero real en modo live: confirma SIEMPRE con el usuario el pago y el monto antes de llamarla.",
+      inputSchema: {
+        pago_id: z.string(),
+        monto: pesos.optional().describe("Monto a reembolsar en pesos. Om\xEDtelo para reembolsar todo lo disponible."),
+        motivo: z.string().max(300).optional()
+      },
+      annotations: { destructiveHint: true, idempotentHint: false, openWorldHint: true }
+    },
+    async (a) => run(async () => {
+      const r = await client2.refunds.create(a.pago_id, { amount: a.monto ? toCents(a.monto) : void 0, reason: a.motivo });
+      return `Reembolso ${r.id}: ${r.status}, ${formatMoney(r.amount)}${r.failure_message ? `. Detalle: ${r.failure_message}` : ""}`;
+    })
+  );
+  server2.registerTool(
+    "listar_comercios",
+    { title: "Listar comercios", description: "Lista los comercios de la plataforma, con su procesador y estado.", inputSchema: {}, annotations: { readOnlyHint: true } },
+    async () => run(async () => {
+      const list = await client2.merchants.list({ limit: 100 });
+      if (list.data.length === 0) return "No hay comercios.";
+      return list.data.map((m) => `${m.id}: ${m.name} (${m.processor}, ${m.status}${m.processor_configured ? "" : ", sin credenciales"})`).join("\n");
+    })
+  );
+  server2.registerTool(
+    "resumen_de_cobros",
+    {
+      title: "Resumen de cobros",
+      description: "Totales de los \xFAltimos d\xEDas: cobrado, cantidad de pagos, reembolsado, fallidos y pagos en revisi\xF3n.",
+      inputSchema: { dias: z.number().int().min(1).max(365).optional().describe("Por defecto 30.") },
+      annotations: { readOnlyHint: true }
+    },
+    async (a) => run(async () => {
+      const dias = a.dias ?? 30;
+      const s = await client2.summary({ from: new Date(Date.now() - dias * 864e5).toISOString() });
+      return [
+        `\xDAltimos ${dias} d\xEDas:`,
+        `Cobrado: ${formatMoney(s.succeeded_amount)} en ${s.succeeded_count} ${s.succeeded_count === 1 ? "pago" : "pagos"}`,
+        `Reembolsado: ${formatMoney(s.refunded_amount)}`,
+        `Pagos fallidos: ${s.failed_count}`,
+        s.review_count ? `Pagos que requieren revisi\xF3n: ${s.review_count}` : null
+      ].filter(Boolean).join("\n");
+    })
+  );
+  return server2;
+}
+
+// src/index.ts
+var apiKey = process.env.PAGOSRD_API_KEY;
+if (!apiKey) {
+  console.error("Falta PAGOSRD_API_KEY (tu llave sk_test_\u2026 o sk_live_\u2026).");
+  process.exit(1);
+}
+var client = new PagosRD2(apiKey, { baseUrl: process.env.PAGOSRD_API_URL });
+var server = createServer(client);
+await server.connect(new StdioServerTransport());
+console.error(`PagosRD MCP listo (${client.testMode ? "modo de prueba" : "modo live"}).`);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/server.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { PagosRD } from \"@pagosrd/node\";\nimport { createServer } from \"./server.js\";\n\nconst apiKey = process.env.PAGOSRD_API_KEY;\nif (!apiKey) {\n  console.error(\"Falta PAGOSRD_API_KEY (tu llave sk_test_… o sk_live_…).\");\n  process.exit(1);\n}\nconst client = new PagosRD(apiKey, { baseUrl: process.env.PAGOSRD_API_URL });\nconst server = createServer(client);\nawait server.connect(new StdioServerTransport());\n// stdout es del protocolo MCP: los mensajes para humanos van a stderr.\nconsole.error(`PagosRD MCP listo (${client.testMode ? \"modo de prueba\" : \"modo live\"}).`);\n","import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { formatMoney, PagosRD, PagosRDError, toCents, type Payment, type PaymentLink } from \"@pagosrd/node\";\nimport { z } from \"zod\";\n\n/**\n * Servidor MCP de PagosRD. Permite a Claude (u otro cliente MCP) crear links de\n * cobro, consultar pagos y reembolsar usando la llave de API de la plataforma.\n *\n * Los montos se piden en PESOS (\"4,500.00\") porque es como habla la gente; el\n * servidor los convierte a centavos sin errores de redondeo.\n */\n\nconst pesos = z.string().describe('Monto en pesos dominicanos, por ejemplo \"4,500.00\" o \"1500\".');\n\nfunction linkText(l: PaymentLink): string {\n  return [\n    `Link ${l.id} (${l.status})`,\n    `Monto: ${formatMoney(l.amount, l.currency)}${l.itbis ? ` (ITBIS ${formatMoney(l.itbis, l.currency)})` : \"\"}`,\n    `Concepto: ${l.description}`,\n    l.reference ? `Referencia: ${l.reference}` : null,\n    l.customer.name ? `Cliente: ${l.customer.name}` : null,\n    `URL para pagar: ${l.url}`,\n    l.expires_at ? `Vence: ${l.expires_at}` : null,\n    l.livemode ? null : \"Modo de prueba: no se cobra dinero real.\",\n  ]\n    .filter(Boolean)\n    .join(\"\\n\");\n}\n\nfunction paymentText(p: Payment): string {\n  return [\n    `Pago ${p.id}: ${p.status}${p.requires_review ? \" (requiere revisión)\" : \"\"}`,\n    `Monto: ${formatMoney(p.amount, p.currency)}${p.amount_refunded ? `, reembolsado ${formatMoney(p.amount_refunded, p.currency)}` : \"\"}`,\n    p.card ? `Tarjeta: ${p.card.brand ?? \"\"} terminada en ${p.card.last4}` : null,\n    p.failure_message ? `Detalle: ${p.failure_message}` : null,\n    p.paid_at ? `Pagado: ${p.paid_at}` : null,\n    p.payment_link_id ? `Link: ${p.payment_link_id}` : null,\n  ]\n    .filter(Boolean)\n    .join(\"\\n\");\n}\n\ntype ToolResult = { content: { type: \"text\"; text: string }[]; isError?: boolean };\n\nasync function run(fn: () => Promise<string>): Promise<ToolResult> {\n  try {\n    return { content: [{ type: \"text\", text: await fn() }] };\n  } catch (err) {\n    const message = err instanceof PagosRDError ? `${err.message}${err.field ? ` (campo: ${err.field})` : \"\"} [${err.code}]` : (err as Error).message;\n    return { content: [{ type: \"text\", text: `Error: ${message}` }], isError: true };\n  }\n}\n\nexport function createServer(client: PagosRD): McpServer {\n  const server = new McpServer({ name: \"pagosrd\", version: \"0.1.1\" });\n\n  server.registerTool(\n    \"crear_link_de_cobro\",\n    {\n      title: \"Crear link de cobro\",\n      description:\n        \"Crea un link de cobro con tarjeta para un comercio y devuelve la URL para enviársela al cliente (por WhatsApp o correo). Si no sabes el comercio, usa primero listar_comercios.\",\n      inputSchema: {\n        comercio_id: z.string().describe(\"Id del comercio (mer_…).\"),\n        monto: pesos.describe('Total a cobrar en pesos, ITBIS incluido. Ej: \"4,500.00\".'),\n        itbis: pesos.optional().describe(\"Parte del monto que es ITBIS, en pesos. Omítelo si está exento.\"),\n        concepto: z.string().min(1).max(140).describe('Qué se cobra. Ej: \"Cuota de mantenimiento octubre, Apto 4B\".'),\n        referencia: z.string().max(100).optional().describe(\"Tu referencia interna (factura, cuota). Vuelve en los webhooks.\"),\n        cliente_nombre: z.string().optional(),\n        cliente_correo: z.string().optional(),\n        cliente_telefono: z.string().optional(),\n        idioma: z.enum([\"es\", \"en\"]).optional().describe(\"Idioma de la página de pago. Por defecto es.\"),\n        vence_en_dias: z.number().int().min(1).max(90).optional().describe(\"Días hasta que vence el link. Por defecto 30.\"),\n      },\n      annotations: { destructiveHint: false, idempotentHint: false, openWorldHint: true },\n    },\n    async (a) =>\n      run(async () => {\n        const link = await client.paymentLinks.create({\n          merchant_id: a.comercio_id,\n          amount: toCents(a.monto),\n          itbis: a.itbis ? toCents(a.itbis) : undefined,\n          description: a.concepto,\n          reference: a.referencia,\n          customer: { name: a.cliente_nombre, email: a.cliente_correo, phone: a.cliente_telefono },\n          locale: a.idioma,\n          expires_at: a.vence_en_dias ? new Date(Date.now() + a.vence_en_dias * 86_400_000).toISOString() : undefined,\n        });\n        return `Link de cobro creado.\\n${linkText(link)}`;\n      }),\n  );\n\n  server.registerTool(\n    \"consultar_link\",\n    { title: \"Consultar link de cobro\", description: \"Muestra el estado de un link de cobro (abierto, pagado, vencido o cancelado).\", inputSchema: { link_id: z.string() }, annotations: { readOnlyHint: true } },\n    async (a) => run(async () => linkText(await client.paymentLinks.retrieve(a.link_id))),\n  );\n\n  server.registerTool(\n    \"listar_links\",\n    {\n      title: \"Listar links de cobro\",\n      description: \"Lista links de cobro recientes. Puede filtrar por estado o por referencia.\",\n      inputSchema: {\n        estado: z.enum([\"open\", \"paid\", \"expired\", \"canceled\"]).optional().describe(\"open = pendiente de pago.\"),\n        referencia: z.string().optional(),\n        cantidad: z.number().int().min(1).max(50).optional(),\n      },\n      annotations: { readOnlyHint: true },\n    },\n    async (a) =>\n      run(async () => {\n        const list = await client.paymentLinks.list({ status: a.estado, reference: a.referencia, limit: a.cantidad ?? 10 });\n        if (list.data.length === 0) return \"No hay links que coincidan.\";\n        return list.data.map(linkText).join(\"\\n\\n\") + (list.has_more ? \"\\n\\nHay más resultados.\" : \"\");\n      }),\n  );\n\n  server.registerTool(\n    \"cancelar_link\",\n    {\n      title: \"Cancelar link de cobro\",\n      description: \"Cancela un link que aún no se ha pagado, para que ya no se pueda pagar. Confirma con el usuario antes de usarla.\",\n      inputSchema: { link_id: z.string() },\n      annotations: { destructiveHint: true, idempotentHint: true },\n    },\n    async (a) => run(async () => `Link cancelado.\\n${linkText(await client.paymentLinks.cancel(a.link_id))}`),\n  );\n\n  server.registerTool(\n    \"consultar_pago\",\n    { title: \"Consultar pago\", description: \"Muestra el detalle de un pago: estado, monto, tarjeta y reembolsos.\", inputSchema: { pago_id: z.string() }, annotations: { readOnlyHint: true } },\n    async (a) => run(async () => paymentText(await client.payments.retrieve(a.pago_id))),\n  );\n\n  server.registerTool(\n    \"listar_pagos\",\n    {\n      title: \"Listar pagos\",\n      description: \"Lista pagos recientes, con filtro opcional por estado.\",\n      inputSchema: {\n        estado: z.enum([\"pending\", \"processing\", \"succeeded\", \"failed\", \"canceled\"]).optional().describe(\"succeeded = cobrado.\"),\n        cantidad: z.number().int().min(1).max(50).optional(),\n      },\n      annotations: { readOnlyHint: true },\n    },\n    async (a) =>\n      run(async () => {\n        const list = await client.payments.list({ status: a.estado, limit: a.cantidad ?? 10 });\n        if (list.data.length === 0) return \"No hay pagos que coincidan.\";\n        return list.data.map(paymentText).join(\"\\n\\n\");\n      }),\n  );\n\n  server.registerTool(\n    \"reembolsar_pago\",\n    {\n      title: \"Reembolsar pago\",\n      description:\n        \"Devuelve dinero de un pago cobrado al cliente, total o parcial. Mueve dinero real en modo live: confirma SIEMPRE con el usuario el pago y el monto antes de llamarla.\",\n      inputSchema: {\n        pago_id: z.string(),\n        monto: pesos.optional().describe(\"Monto a reembolsar en pesos. Omítelo para reembolsar todo lo disponible.\"),\n        motivo: z.string().max(300).optional(),\n      },\n      annotations: { destructiveHint: true, idempotentHint: false, openWorldHint: true },\n    },\n    async (a) =>\n      run(async () => {\n        const r = await client.refunds.create(a.pago_id, { amount: a.monto ? toCents(a.monto) : undefined, reason: a.motivo });\n        return `Reembolso ${r.id}: ${r.status}, ${formatMoney(r.amount)}${r.failure_message ? `. Detalle: ${r.failure_message}` : \"\"}`;\n      }),\n  );\n\n  server.registerTool(\n    \"listar_comercios\",\n    { title: \"Listar comercios\", description: \"Lista los comercios de la plataforma, con su procesador y estado.\", inputSchema: {}, annotations: { readOnlyHint: true } },\n    async () =>\n      run(async () => {\n        const list = await client.merchants.list({ limit: 100 });\n        if (list.data.length === 0) return \"No hay comercios.\";\n        return list.data.map((m) => `${m.id}: ${m.name} (${m.processor}, ${m.status}${m.processor_configured ? \"\" : \", sin credenciales\"})`).join(\"\\n\");\n      }),\n  );\n\n  server.registerTool(\n    \"resumen_de_cobros\",\n    {\n      title: \"Resumen de cobros\",\n      description: \"Totales de los últimos días: cobrado, cantidad de pagos, reembolsado, fallidos y pagos en revisión.\",\n      inputSchema: { dias: z.number().int().min(1).max(365).optional().describe(\"Por defecto 30.\") },\n      annotations: { readOnlyHint: true },\n    },\n    async (a) =>\n      run(async () => {\n        const dias = a.dias ?? 30;\n        const s = await client.summary({ from: new Date(Date.now() - dias * 86_400_000).toISOString() });\n        return [\n          `Últimos ${dias} días:`,\n          `Cobrado: ${formatMoney(s.succeeded_amount)} en ${s.succeeded_count} ${s.succeeded_count === 1 ? \"pago\" : \"pagos\"}`,\n          `Reembolsado: ${formatMoney(s.refunded_amount)}`,\n          `Pagos fallidos: ${s.failed_count}`,\n          s.review_count ? `Pagos que requieren revisión: ${s.review_count}` : null,\n        ]\n          .filter(Boolean)\n          .join(\"\\n\");\n      }),\n  );\n\n  return server;\n}\n"],"mappings":";;;AACA,SAAS,4BAA4B;AACrC,SAAS,WAAAA,gBAAe;;;ACFxB,SAAS,iBAAiB;AAC1B,SAAS,aAAsB,cAAc,eAA+C;AAC5F,SAAS,SAAS;AAUlB,IAAM,QAAQ,EAAE,OAAO,EAAE,SAAS,8DAA8D;AAEhG,SAAS,SAAS,GAAwB;AACxC,SAAO;AAAA,IACL,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM;AAAA,IACzB,UAAU,YAAY,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,EAAE,QAAQ,WAAW,YAAY,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE;AAAA,IAC3G,aAAa,EAAE,WAAW;AAAA,IAC1B,EAAE,YAAY,eAAe,EAAE,SAAS,KAAK;AAAA,IAC7C,EAAE,SAAS,OAAO,YAAY,EAAE,SAAS,IAAI,KAAK;AAAA,IAClD,mBAAmB,EAAE,GAAG;AAAA,IACxB,EAAE,aAAa,UAAU,EAAE,UAAU,KAAK;AAAA,IAC1C,EAAE,WAAW,OAAO;AAAA,EACtB,EACG,OAAO,OAAO,EACd,KAAK,IAAI;AACd;AAEA,SAAS,YAAY,GAAoB;AACvC,SAAO;AAAA,IACL,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,EAAE,kBAAkB,4BAAyB,EAAE;AAAA,IAC3E,UAAU,YAAY,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,EAAE,kBAAkB,iBAAiB,YAAY,EAAE,iBAAiB,EAAE,QAAQ,CAAC,KAAK,EAAE;AAAA,IACpI,EAAE,OAAO,YAAY,EAAE,KAAK,SAAS,EAAE,iBAAiB,EAAE,KAAK,KAAK,KAAK;AAAA,IACzE,EAAE,kBAAkB,YAAY,EAAE,eAAe,KAAK;AAAA,IACtD,EAAE,UAAU,WAAW,EAAE,OAAO,KAAK;AAAA,IACrC,EAAE,kBAAkB,SAAS,EAAE,eAAe,KAAK;AAAA,EACrD,EACG,OAAO,OAAO,EACd,KAAK,IAAI;AACd;AAIA,eAAe,IAAI,IAAgD;AACjE,MAAI;AACF,WAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE;AAAA,EACzD,SAAS,KAAK;AACZ,UAAM,UAAU,eAAe,eAAe,GAAG,IAAI,OAAO,GAAG,IAAI,QAAQ,YAAY,IAAI,KAAK,MAAM,EAAE,KAAK,IAAI,IAAI,MAAO,IAAc;AAC1I,WAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,UAAU,OAAO,GAAG,CAAC,GAAG,SAAS,KAAK;AAAA,EACjF;AACF;AAEO,SAAS,aAAaC,SAA4B;AACvD,QAAMC,UAAS,IAAI,UAAU,EAAE,MAAM,WAAW,SAAS,QAAQ,CAAC;AAElE,EAAAA,QAAO;AAAA,IACL;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,aACE;AAAA,MACF,aAAa;AAAA,QACX,aAAa,EAAE,OAAO,EAAE,SAAS,+BAA0B;AAAA,QAC3D,OAAO,MAAM,SAAS,0DAA0D;AAAA,QAChF,OAAO,MAAM,SAAS,EAAE,SAAS,uEAAiE;AAAA,QAClG,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,iEAA8D;AAAA,QAC5G,YAAY,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,SAAS,EAAE,SAAS,iEAAiE;AAAA,QACrH,gBAAgB,EAAE,OAAO,EAAE,SAAS;AAAA,QACpC,gBAAgB,EAAE,OAAO,EAAE,SAAS;AAAA,QACpC,kBAAkB,EAAE,OAAO,EAAE,SAAS;AAAA,QACtC,QAAQ,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,iDAA8C;AAAA,QAC/F,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS,kDAA+C;AAAA,MACpH;AAAA,MACA,aAAa,EAAE,iBAAiB,OAAO,gBAAgB,OAAO,eAAe,KAAK;AAAA,IACpF;AAAA,IACA,OAAO,MACL,IAAI,YAAY;AACd,YAAM,OAAO,MAAMD,QAAO,aAAa,OAAO;AAAA,QAC5C,aAAa,EAAE;AAAA,QACf,QAAQ,QAAQ,EAAE,KAAK;AAAA,QACvB,OAAO,EAAE,QAAQ,QAAQ,EAAE,KAAK,IAAI;AAAA,QACpC,aAAa,EAAE;AAAA,QACf,WAAW,EAAE;AAAA,QACb,UAAU,EAAE,MAAM,EAAE,gBAAgB,OAAO,EAAE,gBAAgB,OAAO,EAAE,iBAAiB;AAAA,QACvF,QAAQ,EAAE;AAAA,QACV,YAAY,EAAE,gBAAgB,IAAI,KAAK,KAAK,IAAI,IAAI,EAAE,gBAAgB,KAAU,EAAE,YAAY,IAAI;AAAA,MACpG,CAAC;AACD,aAAO;AAAA,EAA0B,SAAS,IAAI,CAAC;AAAA,IACjD,CAAC;AAAA,EACL;AAEA,EAAAC,QAAO;AAAA,IACL;AAAA,IACA,EAAE,OAAO,2BAA2B,aAAa,iFAAiF,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,cAAc,KAAK,EAAE;AAAA,IAC5M,OAAO,MAAM,IAAI,YAAY,SAAS,MAAMD,QAAO,aAAa,SAAS,EAAE,OAAO,CAAC,CAAC;AAAA,EACtF;AAEA,EAAAC,QAAO;AAAA,IACL;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,aAAa;AAAA,MACb,aAAa;AAAA,QACX,QAAQ,EAAE,KAAK,CAAC,QAAQ,QAAQ,WAAW,UAAU,CAAC,EAAE,SAAS,EAAE,SAAS,2BAA2B;AAAA,QACvG,YAAY,EAAE,OAAO,EAAE,SAAS;AAAA,QAChC,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS;AAAA,MACrD;AAAA,MACA,aAAa,EAAE,cAAc,KAAK;AAAA,IACpC;AAAA,IACA,OAAO,MACL,IAAI,YAAY;AACd,YAAM,OAAO,MAAMD,QAAO,aAAa,KAAK,EAAE,QAAQ,EAAE,QAAQ,WAAW,EAAE,YAAY,OAAO,EAAE,YAAY,GAAG,CAAC;AAClH,UAAI,KAAK,KAAK,WAAW,EAAG,QAAO;AACnC,aAAO,KAAK,KAAK,IAAI,QAAQ,EAAE,KAAK,MAAM,KAAK,KAAK,WAAW,+BAA4B;AAAA,IAC7F,CAAC;AAAA,EACL;AAEA,EAAAC,QAAO;AAAA,IACL;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,aAAa;AAAA,MACb,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE;AAAA,MACnC,aAAa,EAAE,iBAAiB,MAAM,gBAAgB,KAAK;AAAA,IAC7D;AAAA,IACA,OAAO,MAAM,IAAI,YAAY;AAAA,EAAoB,SAAS,MAAMD,QAAO,aAAa,OAAO,EAAE,OAAO,CAAC,CAAC,EAAE;AAAA,EAC1G;AAEA,EAAAC,QAAO;AAAA,IACL;AAAA,IACA,EAAE,OAAO,kBAAkB,aAAa,uEAAuE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,cAAc,KAAK,EAAE;AAAA,IACzL,OAAO,MAAM,IAAI,YAAY,YAAY,MAAMD,QAAO,SAAS,SAAS,EAAE,OAAO,CAAC,CAAC;AAAA,EACrF;AAEA,EAAAC,QAAO;AAAA,IACL;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,aAAa;AAAA,MACb,aAAa;AAAA,QACX,QAAQ,EAAE,KAAK,CAAC,WAAW,cAAc,aAAa,UAAU,UAAU,CAAC,EAAE,SAAS,EAAE,SAAS,sBAAsB;AAAA,QACvH,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS;AAAA,MACrD;AAAA,MACA,aAAa,EAAE,cAAc,KAAK;AAAA,IACpC;AAAA,IACA,OAAO,MACL,IAAI,YAAY;AACd,YAAM,OAAO,MAAMD,QAAO,SAAS,KAAK,EAAE,QAAQ,EAAE,QAAQ,OAAO,EAAE,YAAY,GAAG,CAAC;AACrF,UAAI,KAAK,KAAK,WAAW,EAAG,QAAO;AACnC,aAAO,KAAK,KAAK,IAAI,WAAW,EAAE,KAAK,MAAM;AAAA,IAC/C,CAAC;AAAA,EACL;AAEA,EAAAC,QAAO;AAAA,IACL;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,aACE;AAAA,MACF,aAAa;AAAA,QACX,SAAS,EAAE,OAAO;AAAA,QAClB,OAAO,MAAM,SAAS,EAAE,SAAS,6EAA0E;AAAA,QAC3G,QAAQ,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,MACvC;AAAA,MACA,aAAa,EAAE,iBAAiB,MAAM,gBAAgB,OAAO,eAAe,KAAK;AAAA,IACnF;AAAA,IACA,OAAO,MACL,IAAI,YAAY;AACd,YAAM,IAAI,MAAMD,QAAO,QAAQ,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,QAAQ,EAAE,KAAK,IAAI,QAAW,QAAQ,EAAE,OAAO,CAAC;AACrH,aAAO,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,KAAK,YAAY,EAAE,MAAM,CAAC,GAAG,EAAE,kBAAkB,cAAc,EAAE,eAAe,KAAK,EAAE;AAAA,IAC9H,CAAC;AAAA,EACL;AAEA,EAAAC,QAAO;AAAA,IACL;AAAA,IACA,EAAE,OAAO,oBAAoB,aAAa,qEAAqE,aAAa,CAAC,GAAG,aAAa,EAAE,cAAc,KAAK,EAAE;AAAA,IACpK,YACE,IAAI,YAAY;AACd,YAAM,OAAO,MAAMD,QAAO,UAAU,KAAK,EAAE,OAAO,IAAI,CAAC;AACvD,UAAI,KAAK,KAAK,WAAW,EAAG,QAAO;AACnC,aAAO,KAAK,KAAK,IAAI,CAAC,MAAM,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,KAAK,EAAE,SAAS,KAAK,EAAE,MAAM,GAAG,EAAE,uBAAuB,KAAK,oBAAoB,GAAG,EAAE,KAAK,IAAI;AAAA,IAChJ,CAAC;AAAA,EACL;AAEA,EAAAC,QAAO;AAAA,IACL;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,aAAa;AAAA,MACb,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,EAAE,SAAS,iBAAiB,EAAE;AAAA,MAC7F,aAAa,EAAE,cAAc,KAAK;AAAA,IACpC;AAAA,IACA,OAAO,MACL,IAAI,YAAY;AACd,YAAM,OAAO,EAAE,QAAQ;AACvB,YAAM,IAAI,MAAMD,QAAO,QAAQ,EAAE,MAAM,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAU,EAAE,YAAY,EAAE,CAAC;AAC/F,aAAO;AAAA,QACL,cAAW,IAAI;AAAA,QACf,YAAY,YAAY,EAAE,gBAAgB,CAAC,OAAO,EAAE,eAAe,IAAI,EAAE,oBAAoB,IAAI,SAAS,OAAO;AAAA,QACjH,gBAAgB,YAAY,EAAE,eAAe,CAAC;AAAA,QAC9C,mBAAmB,EAAE,YAAY;AAAA,QACjC,EAAE,eAAe,oCAAiC,EAAE,YAAY,KAAK;AAAA,MACvE,EACG,OAAO,OAAO,EACd,KAAK,IAAI;AAAA,IACd,CAAC;AAAA,EACL;AAEA,SAAOC;AACT;;;AD7MA,IAAM,SAAS,QAAQ,IAAI;AAC3B,IAAI,CAAC,QAAQ;AACX,UAAQ,MAAM,mEAAyD;AACvE,UAAQ,KAAK,CAAC;AAChB;AACA,IAAM,SAAS,IAAIC,SAAQ,QAAQ,EAAE,SAAS,QAAQ,IAAI,gBAAgB,CAAC;AAC3E,IAAM,SAAS,aAAa,MAAM;AAClC,MAAM,OAAO,QAAQ,IAAI,qBAAqB,CAAC;AAE/C,QAAQ,MAAM,sBAAsB,OAAO,WAAW,mBAAmB,WAAW,IAAI;","names":["PagosRD","client","server","PagosRD"]}

package/package.json

@@ -1,6 +1,50 @@
 {
   "name": "@pagosrd/mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Servidor MCP de PagosRD: crea links de cobro, consulta pagos y reembolsa desde Claude u otros clientes MCP.",
+  "license": "MIT",
+  "author": "Cristian Encarnación",
+  "homepage": "https://github.com/cristianEncarnacion/pagosrd-mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cristianEncarnacion/pagosrd-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cristianEncarnacion/pagosrd-mcp/issues"
+  },
+  "keywords": [
+    "pagosrd",
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "pagos",
+    "republica-dominicana"
+  ],
+  "type": "module",
+  "bin": {
+    "pagosrd-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.2",
+    "@pagosrd/node": "^0.1.0",
+    "zod": "^4.6.7"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.5",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^5.0.5"
+  }
+}