@ar-agents/mcp 0.1.0

package/AGENTS.md

@@ -0,0 +1,91 @@
+# @ar-agents/mcp — agent guide
+
+This file is for the LLM running INSIDE Claude Desktop, Cursor, or any MCP host that loaded `@ar-agents/mcp`. It explains what's available and how to chain tools.
+
+## What you have access to
+
+`@ar-agents/mcp` registers a subset of up to ~34 tools, depending on which env vars the human configured. Always check `list_payment_methods` (if MercadoPago is enabled) or just call any tool — if it's not registered, the host will tell you.
+
+The tools are organized into 4 groups; each ships its own AGENTS.md you can mentally fold in:
+
+1. **`@ar-agents/identity`** — CUIT validation + AFIP/ARCA padron lookup
+2. **`@ar-agents/identity-attest`** — Verification orchestration (WhatsApp OTP, email magic-link), trust-level gating
+3. **`@ar-agents/mercadopago`** — Payments, Subscriptions, Cuotas, Customers, Refunds
+4. **`@ar-agents/whatsapp`** — WhatsApp Cloud API messaging
+
+## The canonical agent flow (Argentine SaaS billing)
+
+```
+User: "quiero cobrarle $50.000 a juan@example.com"
+
+Step 1 → calculate_installments(amount: 50000, payment_method_id: "visa")
+   → returns recommended_message strings
+Step 2 → create_payment_preference(items, payer_email, max_installments, ...)
+   → returns init_point_url
+Step 3 → send_whatsapp_text(to: juan_phone, text: "Te paso el link de pago: ...")
+Step 4 → (waits for webhook) get_payment(payment_id) when it fires
+Step 5 → if amount > $20k AND no recent attestation:
+            request_identity_verification(method: "whatsapp_otp", subject_type: "phone", subject_value: juan_phone)
+            → user dictates code → submit_otp_code(request_id, code)
+            → now you have an attestation at trust 0.3
+Step 6 → continue with the charge, log the attestation_id alongside the payment
+```
+
+## Tool selection cheat sheet
+
+| User intent | Most likely tool |
+|---|---|
+| "cobrale $X a [email]" | `create_payment_preference` |
+| "validame este CUIT" | `validate_cuit` (then `lookup_cuit_afip`) |
+| "cuántas cuotas tiene esta tarjeta?" | `calculate_installments` |
+| "necesito verificar al cliente antes de cobrar" | `request_identity_verification` |
+| "mandale un mensaje a [phone]" | `send_whatsapp_text` |
+| "devolvele la plata" | `refund_payment` |
+| "creale una suscripción mensual a $X" | `create_subscription` |
+| "buscá los pagos del cliente X" | `search_payments(payer_email)` or `(external_reference)` |
+
+## Cross-package patterns
+
+### Identity gating for payments
+
+```
+For amount < $5k → no verification needed (just create_payment_preference)
+For amount $5k-$50k → require trust >= 0.5 (email_magic_link)
+For amount > $50k → require trust >= 0.85 (KYC; only available with MercadoPago Identity adapter — planned v0.3)
+```
+
+The agent checks `check_verification_status` for an existing valid attestation BEFORE kicking off a new one.
+
+### CUIT-validated B2B onboarding
+
+```
+Step 1 → validate_cuit → if invalid, explain to user
+Step 2 → lookup_cuit_afip → confirm "factura a nombre de [razón social]"
+Step 3 → user confirms → create_subscription with proper external_reference
+Step 4 → send_whatsapp_text with the init_point_url for first payment
+```
+
+### WhatsApp inbound webhook → agent dispatch
+
+If the host integrates WhatsApp webhooks (your app's HTTP layer, not the MCP server itself), the inbound message text becomes a regular user prompt. Then standard tool selection applies.
+
+## Argentine context (key landmines)
+
+- **Mercado Pago payer_email cannot equal seller email** (error 205). Use distinct emails even in sandbox.
+- **WhatsApp 24h customer service window**: free-form text only works within 24h of user's last message. Outside → use `send_whatsapp_template`.
+- **AFIP `condicion: "DESCONOCIDA"`** — use `ws_sr_constancia_inscripcion` (default in identity v0.4+) for monotributo + IVA condition. A13 is "datos generales only".
+- **Cuotas `recommended_message`** — surface VERBATIM, already in compliant Argentine format ("3 cuotas sin interés de $X").
+- **Statement descriptor max 13 chars** — use abbreviations.
+- **AR phone normalizer** in `@ar-agents/whatsapp` handles all formats automatically.
+
+## When things fail
+
+The MCP server returns `{ isError: true, content: [{ text: "Error calling X: ..." }] }` on any tool failure. Surface the error message to the user (it's already actionable: "El número no tiene WhatsApp", "El CUIT es inexistente", "Te quedan 2 intentos del código", etc.). Don't invent fallbacks — the lib's errors-as-docs philosophy means each error is a clear next-step instruction.
+
+## Composition philosophy
+
+`@ar-agents/mcp` is the meta-package — its purpose is to expose all the lower packages over MCP transport. Read each lower package's AGENTS.md for fuller decision trees:
+- [@ar-agents/identity AGENTS.md](https://github.com/ar-agents/ar-agents/blob/main/packages/identity/AGENTS.md)
+- [@ar-agents/identity-attest AGENTS.md](https://github.com/ar-agents/ar-agents/blob/main/packages/identity-attest/AGENTS.md)
+- [@ar-agents/mercadopago AGENTS.md](https://github.com/ar-agents/ar-agents/blob/main/packages/mercadopago/AGENTS.md)
+- [@ar-agents/whatsapp AGENTS.md](https://github.com/ar-agents/ar-agents/blob/main/packages/whatsapp/AGENTS.md)

package/CHANGELOG.md

@@ -0,0 +1,41 @@
+# Changelog
+
+## 0.1.0
+
+### Initial release — the MCP wrapper
+
+One MCP server that bundles the entire `@ar-agents/*` toolkit (identity, identity-attest, mercadopago, whatsapp) into any MCP host (Claude Desktop, Cursor, Codeium, Continue, Cline, etc.). Up to **34 tools in one install**, configured entirely via env vars.
+
+**What it does**
+
+- Spawns as a stdio MCP server (`npx @ar-agents/mcp`).
+- Auto-detects which `@ar-agents/*` packages to enable based on env vars present.
+- Bridges Vercel AI SDK 6 `tool()` definitions → MCP `Tool` shape, including Zod → JSON Schema conversion (using Zod 4 native `z.toJSONSchema()`).
+- Reports startup summary on stderr (which packages enabled, how many tools registered).
+
+**Tool inventory**
+
+| Source | Tools (when configured) |
+|---|---|
+| `@ar-agents/identity` (always on) | 1-2 |
+| `@ar-agents/identity-attest` | 5 |
+| `@ar-agents/mercadopago` | 21 |
+| `@ar-agents/whatsapp` | 6 |
+
+**Env-var configuration**
+
+- Without any env vars: only `validate_cuit` (algorithm-only).
+- Each package's tools enable independently when its env vars are set. See README for the full table.
+
+**Quality**
+
+- 12/12 tests pass (adapter conversions, registry env-var detection, server boot).
+- 21.33 KB ESM brotli'd (under 60 KB budget).
+- publint + arethetypeswrong all 🟢.
+- Smoke-tested CLI binary boots and connects via stdio with both empty and full env-var setups.
+
+**Implementation notes**
+
+- Uses Zod 4's native `z.toJSONSchema()` (no `zod-to-json-schema` dep needed).
+- MCP SDK: `@modelcontextprotocol/sdk@^1.0.0`.
+- Tool name collisions across registered packages throw at startup (no silent overrides).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nazareno Clemente
+
+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

@@ -0,0 +1,140 @@
+# @ar-agents/mcp
+
+> One MCP server that bundles the entire `@ar-agents/*` toolkit — CUIT validation, AFIP/ARCA padron lookup, identity attestation, MercadoPago Payments + Subscriptions + Cuotas, WhatsApp Business — into any MCP host (Claude Desktop, Cursor, Codeium, Continue, Cline, etc.).
+
+[![npm](https://img.shields.io/npm/v/@ar-agents/mcp.svg)](https://www.npmjs.com/package/@ar-agents/mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## What is this
+
+This package is the **MCP server wrapper** around the `@ar-agents/*` packages. If you're building agents in Vercel AI SDK 6 directly, you don't need this — install the individual packages. If you want to use the AR toolkit from **Claude Desktop, Cursor, Codeium, or any MCP host**, this is your one-stop install.
+
+## Quick start (Claude Desktop)
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```jsonc
+{
+  "mcpServers": {
+    "ar-agents": {
+      "command": "npx",
+      "args": ["-y", "@ar-agents/mcp"],
+      "env": {
+        // All env vars are optional — set the ones for the integrations you need.
+        // Without any: only `validate_cuit` (algorithm-only) is available.
+
+        // MercadoPago — enables 21 payment / subscription tools
+        "MP_ACCESS_TOKEN": "TEST-...-or-APP_USR-...",
+        "MP_BACK_URL": "https://yourapp.com/done",
+
+        // AFIP/ARCA — enables `lookup_cuit_afip` (real padron data)
+        "AFIP_CUIT_REPRESENTADO": "20XXXXXXXXY",
+        "AFIP_CERT_PEM": "-----BEGIN CERTIFICATE-----\n...",
+        "AFIP_KEY_PEM": "-----BEGIN PRIVATE KEY-----\n...",
+        "AFIP_ENV": "prod", // or "homo"
+
+        // WhatsApp Business — enables 6 messaging tools
+        "WA_ACCESS_TOKEN": "EAA...",
+        "WA_PHONE_NUMBER_ID": "...",
+
+        // Identity Attestation — enables 5 verification tools
+        "ATTEST_SIGNING_SECRET": "openssl rand -hex 32 result here",
+        "BUSINESS_NAME": "Your Company",
+        "RESEND_API_KEY": "re_...",                // optional, enables email_magic_link adapter
+        "ATTEST_CALLBACK_URL": "https://yourapp.com/api/identity-attest/callback",
+        "ATTEST_FROM_EMAIL": "noreply@yourapp.com"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. Look for the wrench icon → ar-agents tools should appear.
+
+## Quick start (Cursor)
+
+Edit `~/.cursor/mcp.json`:
+
+```jsonc
+{
+  "mcpServers": {
+    "ar-agents": {
+      "command": "npx",
+      "args": ["-y", "@ar-agents/mcp"],
+      "env": {
+        "MP_ACCESS_TOKEN": "TEST-...",
+        // ... same env vars as above
+      }
+    }
+  }
+}
+```
+
+Restart Cursor. The tools appear in your chat panel's tool picker.
+
+## Quick start (any other MCP host)
+
+Same pattern. Anything that supports MCP stdio servers works:
+- **Codeium** — set in `Settings → MCP servers`
+- **Continue** — `~/.continue/config.json` → `experimental.modelContextProtocolServers`
+- **Cline** — `cline_mcp_settings.json`
+
+## What tools you get
+
+The set of tools depends on which env vars you set. Without any env vars: only `validate_cuit` (algorithm-only) is registered. With all env vars set:
+
+| Source | Tools |
+|---|---|
+| `@ar-agents/identity` (always on) | `validate_cuit`, `lookup_cuit_afip` (when AFIP vars set) |
+| `@ar-agents/identity-attest` (when `ATTEST_SIGNING_SECRET` set) | `list_verification_methods`, `request_identity_verification`, `submit_otp_code`, `check_verification_status`, `get_attestation` |
+| `@ar-agents/mercadopago` (when `MP_ACCESS_TOKEN` set) | 21 tools — `create_payment_preference`, `create_payment`, `search_payments`, `refund_payment`, `calculate_installments`, `create_subscription`, `create_customer`, `list_customer_cards`, `list_payment_methods`, `get_account_info`, `cancel_payment`, `capture_payment`, `list_refunds`, `get_payment`, `get_payment_preference`, `find_customer_by_email`, `delete_customer_card`, `pause_subscription`, `resume_subscription`, `cancel_subscription`, `get_subscription_status` |
+| `@ar-agents/whatsapp` (when WA vars set) | 6 tools — `send_whatsapp_text`, `send_whatsapp_template`, `send_whatsapp_media`, `send_whatsapp_buttons`, `send_whatsapp_list`, `mark_whatsapp_read` |
+
+**Total: up to 34 tools** for AR agents in one MCP install.
+
+## Verifying it works
+
+Run the binary directly to see the registered-tools summary:
+
+```bash
+npx @ar-agents/mcp
+# Outputs to stderr (stdout is reserved for MCP protocol):
+#   ar-agents@0.1.0 starting with N tools registered:
+#     identity      → validate_cuit + lookup_cuit_afip (AFIP cert configured)
+#     mercadopago   → PROD mode · back_url=...
+#     whatsapp      → phone_number_id=...
+#     identity-attest → whatsapp_otp, email_magic_link
+```
+
+If you see "not configured", check your env vars match what each package expects.
+
+## When to use this vs the individual packages
+
+| Use this (`@ar-agents/mcp`) | Use the individual packages |
+|---|---|
+| Claude Desktop / Cursor / Codeium user | Building a Vercel AI SDK 6 agent in your own Node app |
+| Want the toolkit available in your IDE | Want fine-grained control over which tools an Agent registers |
+| Don't want to write any code | Already have an `Agent({ tools })` setup |
+
+The npm packages and the MCP server expose **identical functionality** — same tool names, same schemas, same behavior. The MCP server is just a different transport.
+
+## Troubleshooting
+
+**"validate_cuit only" — no other tools showing**
+→ You haven't set any env vars. Check the env section of your MCP config.
+
+**MercadoPago tool calls fail with 401**
+→ Your `MP_ACCESS_TOKEN` is wrong or expired. Test users in sandbox have their own tokens; don't mix prod/test.
+
+**AFIP `lookup_cuit_afip` returns "not configured"**
+→ You set `MP_ACCESS_TOKEN` but missed `AFIP_CUIT_REPRESENTADO` + cert vars. Each integration is independent.
+
+**Magic-link adapter not registered (identity-attest)**
+→ You set `ATTEST_SIGNING_SECRET` but not `RESEND_API_KEY` + `ATTEST_CALLBACK_URL`. The adapter needs both.
+
+**Tool names collide**
+→ Open an issue at github.com/ar-agents/ar-agents — we'll prefix tool names in v0.2 if collisions become common.
+
+## License
+
+MIT — © Nazareno Clemente

package/bin/ar-agents-mcp.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+// CLI entry for the ar-agents MCP server.
+//
+// Usage (from any MCP host config — Cursor, Claude Desktop, etc.):
+//   {
+//     "mcpServers": {
+//       "ar-agents": {
+//         "command": "npx",
+//         "args": ["-y", "@ar-agents/mcp"],
+//         "env": {
+//           "MP_ACCESS_TOKEN": "TEST-...",
+//           "AFIP_CERT_PEM": "-----BEGIN CERTIFICATE-----...",
+//           ...
+//         }
+//       }
+//     }
+//   }
+//
+// Without env vars: only `validate_cuit` is exposed (algorithm-only).
+// Each env-var group enables a different subset of tools — see README.
+
+import { startStdio } from "../dist/index.js";
+
+startStdio().catch((err) => {
+  console.error("ar-agents MCP server failed to start:", err);
+  process.exit(1);
+});

package/dist/index.cjs

@@ -0,0 +1,245 @@
+'use strict';
+
+var index_js = require('@modelcontextprotocol/sdk/server/index.js');
+var stdio_js = require('@modelcontextprotocol/sdk/server/stdio.js');
+var types_js = require('@modelcontextprotocol/sdk/types.js');
+var zod = require('zod');
+var identity = require('@ar-agents/identity');
+var wsaa = require('@ar-agents/identity/wsaa');
+var identityAttest = require('@ar-agents/identity-attest');
+var whatsapp = require('@ar-agents/whatsapp');
+var mercadopago = require('@ar-agents/mercadopago');
+
+// src/server.ts
+function adaptToolSetToMcp(toolSet) {
+  const tools = [];
+  const lookup = /* @__PURE__ */ new Map();
+  for (const [name, tool] of Object.entries(toolSet)) {
+    if (!tool || typeof tool !== "object") continue;
+    const description = "description" in tool && typeof tool.description === "string" ? tool.description : "";
+    const inputSchema = "inputSchema" in tool && tool.inputSchema ? zod.z.toJSONSchema(tool.inputSchema) : { type: "object", properties: {}, additionalProperties: false };
+    tools.push({ name, description, inputSchema });
+    const exec = "execute" in tool ? tool.execute : null;
+    if (!exec) {
+      continue;
+    }
+    lookup.set(name, exec);
+  }
+  return {
+    tools,
+    call: async (name, args) => {
+      const fn = lookup.get(name);
+      if (!fn) {
+        throw new Error(`Tool "${name}" not found or has no execute fn (MCP requires server-side tools).`);
+      }
+      return fn(args);
+    }
+  };
+}
+function combineToolSets(toolSets) {
+  const tools = [];
+  const lookup = /* @__PURE__ */ new Map();
+  const seen = /* @__PURE__ */ new Set();
+  for (const ts of toolSets) {
+    if (!ts) continue;
+    const adapter = adaptToolSetToMcp(ts);
+    for (const tool of adapter.tools) {
+      if (seen.has(tool.name)) {
+        throw new Error(
+          `Tool name collision: "${tool.name}" appears in multiple registered tool sets. Rename one or skip a registry.`
+        );
+      }
+      seen.add(tool.name);
+      tools.push(tool);
+      const sourceAdapter = adapter;
+      const toolName = tool.name;
+      lookup.set(toolName, (args) => sourceAdapter.call(toolName, args));
+    }
+  }
+  return {
+    tools,
+    call: async (name, args) => {
+      const fn = lookup.get(name);
+      if (!fn) throw new Error(`Tool "${name}" not found in combined set.`);
+      return fn(args);
+    }
+  };
+}
+function buildIdentityTools() {
+  const afip = buildAfipAdapter();
+  return identity.identityTools(afip ? { afip } : {});
+}
+function buildAfipAdapter() {
+  const cuit = process.env.AFIP_CUIT_REPRESENTADO?.trim();
+  if (!cuit) return void 0;
+  const env = process.env.AFIP_ENV?.trim() ?? "prod";
+  const certPem = process.env.AFIP_CERT_PEM;
+  const keyPem = process.env.AFIP_KEY_PEM;
+  if (certPem && keyPem) {
+    return new wsaa.WsaaWscdcAfipPadronAdapter({ certPem, keyPem, cuitRepresentado: cuit, env });
+  }
+  const certPath = process.env.AFIP_CERT_PATH?.trim();
+  const keyPath = process.env.AFIP_KEY_PATH?.trim();
+  if (certPath && keyPath) {
+    return new wsaa.WsaaWscdcAfipPadronAdapter({ certPath, keyPath, cuitRepresentado: cuit, env });
+  }
+  return void 0;
+}
+function describeIdentityConfig() {
+  const cuit = process.env.AFIP_CUIT_REPRESENTADO?.trim();
+  if (!cuit) return "validate_cuit only (no AFIP cert configured)";
+  const certConfigured = !!process.env.AFIP_CERT_PEM || !!process.env.AFIP_CERT_PATH;
+  return certConfigured ? `validate_cuit + lookup_cuit_afip (AFIP cert configured for CUIT ${cuit})` : `validate_cuit only (cert not configured)`;
+}
+function buildWhatsAppTools() {
+  const accessToken = process.env.WA_ACCESS_TOKEN?.trim();
+  const phoneNumberId = process.env.WA_PHONE_NUMBER_ID?.trim();
+  if (!accessToken || !phoneNumberId) return null;
+  return whatsapp.whatsappTools(new whatsapp.WhatsAppClient({ accessToken, phoneNumberId }));
+}
+function describeWhatsAppConfig() {
+  const accessToken = process.env.WA_ACCESS_TOKEN?.trim();
+  const phoneNumberId = process.env.WA_PHONE_NUMBER_ID?.trim();
+  if (!accessToken || !phoneNumberId)
+    return "not configured (set WA_ACCESS_TOKEN + WA_PHONE_NUMBER_ID)";
+  return `phone_number_id=${phoneNumberId.slice(0, 6)}\u2026`;
+}
+function getWhatsAppClient() {
+  const accessToken = process.env.WA_ACCESS_TOKEN?.trim();
+  const phoneNumberId = process.env.WA_PHONE_NUMBER_ID?.trim();
+  if (!accessToken || !phoneNumberId) return null;
+  return new whatsapp.WhatsAppClient({ accessToken, phoneNumberId });
+}
+
+// src/registries/identity-attest.ts
+function buildIdentityAttestTools() {
+  const signingSecret = process.env.ATTEST_SIGNING_SECRET?.trim();
+  if (!signingSecret) return null;
+  const adapters = {};
+  const wa = getWhatsAppClient();
+  if (wa) {
+    adapters["whatsapp_otp"] = new identityAttest.WhatsAppOtpAdapter({
+      whatsappClient: wa,
+      businessName: process.env.BUSINESS_NAME?.trim() ?? "this app"
+    });
+  }
+  const resendKey = process.env.RESEND_API_KEY?.trim();
+  const callbackUrl = process.env.ATTEST_CALLBACK_URL?.trim();
+  if (resendKey && callbackUrl) {
+    const fromEmail = process.env.ATTEST_FROM_EMAIL?.trim() ?? "noreply@example.com";
+    const sender = async ({ to, subject, html, text }) => {
+      const res = await fetch("https://api.resend.com/emails", {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${resendKey}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({ from: fromEmail, to, subject, html, text })
+      });
+      if (!res.ok) {
+        throw new Error(`Resend send failed: ${res.status} ${await res.text()}`);
+      }
+    };
+    adapters["email_magic_link"] = new identityAttest.EmailMagicLinkAdapter({
+      sender,
+      callbackBaseUrl: callbackUrl,
+      businessName: process.env.BUSINESS_NAME?.trim() ?? "this app"
+    });
+  }
+  if (Object.keys(adapters).length === 0) return null;
+  const client = new identityAttest.AttestationClient({ signingSecret, adapters });
+  return identityAttest.identityAttestTools(client);
+}
+function describeIdentityAttestConfig() {
+  const signingSecret = process.env.ATTEST_SIGNING_SECRET?.trim();
+  if (!signingSecret) return "not configured (set ATTEST_SIGNING_SECRET)";
+  const adapters = [];
+  if (getWhatsAppClient()) adapters.push("whatsapp_otp");
+  if (process.env.RESEND_API_KEY?.trim() && process.env.ATTEST_CALLBACK_URL?.trim())
+    adapters.push("email_magic_link");
+  if (adapters.length === 0)
+    return "configured but no adapters (set WhatsApp creds and/or RESEND_API_KEY + ATTEST_CALLBACK_URL)";
+  return adapters.join(", ");
+}
+function buildMercadoPagoTools() {
+  const accessToken = process.env.MP_ACCESS_TOKEN?.trim();
+  if (!accessToken) return null;
+  const client = new mercadopago.MercadoPagoClient({ accessToken });
+  const backUrl = process.env.MP_BACK_URL?.trim() ?? "https://example.com/done";
+  return mercadopago.mercadoPagoTools(client, {
+    state: new mercadopago.InMemoryStateAdapter(),
+    backUrl
+  });
+}
+function describeMercadoPagoConfig() {
+  const token = process.env.MP_ACCESS_TOKEN?.trim();
+  if (!token) return "not configured (set MP_ACCESS_TOKEN)";
+  const isTest = token.startsWith("TEST-");
+  const backUrl = process.env.MP_BACK_URL?.trim();
+  return `${isTest ? "TEST" : "PROD"} mode${backUrl ? ` \xB7 back_url=${backUrl}` : " \xB7 using default back_url"}`;
+}
+
+// src/server.ts
+var SERVER_NAME = "ar-agents";
+var SERVER_VERSION = "0.1.0";
+async function createServer() {
+  const adapter = combineToolSets([
+    buildIdentityTools(),
+    buildMercadoPagoTools(),
+    buildWhatsAppTools(),
+    buildIdentityAttestTools()
+  ]);
+  const summary = [
+    `${SERVER_NAME}@${SERVER_VERSION} starting with ${adapter.tools.length} tools registered:`,
+    `  identity      \u2192 ${describeIdentityConfig()}`,
+    `  mercadopago   \u2192 ${describeMercadoPagoConfig()}`,
+    `  whatsapp      \u2192 ${describeWhatsAppConfig()}`,
+    `  identity-attest \u2192 ${describeIdentityAttestConfig()}`
+  ];
+  const server = new index_js.Server(
+    { name: SERVER_NAME, version: SERVER_VERSION },
+    { capabilities: { tools: {} } }
+  );
+  server.setRequestHandler(types_js.ListToolsRequestSchema, async () => ({
+    tools: adapter.tools
+  }));
+  server.setRequestHandler(types_js.CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+      const result = await adapter.call(name, args ?? {});
+      return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+      };
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return {
+        content: [{ type: "text", text: `Error calling ${name}: ${msg}` }],
+        isError: true
+      };
+    }
+  });
+  return { server, summary };
+}
+async function startStdio() {
+  const { server, summary } = await createServer();
+  for (const line of summary) console.error(line);
+  const transport = new stdio_js.StdioServerTransport();
+  await server.connect(transport);
+  console.error("ar-agents MCP server connected via stdio");
+}
+
+exports.adaptToolSetToMcp = adaptToolSetToMcp;
+exports.buildIdentityAttestTools = buildIdentityAttestTools;
+exports.buildIdentityTools = buildIdentityTools;
+exports.buildMercadoPagoTools = buildMercadoPagoTools;
+exports.buildWhatsAppTools = buildWhatsAppTools;
+exports.combineToolSets = combineToolSets;
+exports.createServer = createServer;
+exports.describeIdentityAttestConfig = describeIdentityAttestConfig;
+exports.describeIdentityConfig = describeIdentityConfig;
+exports.describeMercadoPagoConfig = describeMercadoPagoConfig;
+exports.describeWhatsAppConfig = describeWhatsAppConfig;
+exports.getWhatsAppClient = getWhatsAppClient;
+exports.startStdio = startStdio;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapter.ts","../src/registries/identity.ts","../src/registries/whatsapp.ts","../src/registries/identity-attest.ts","../src/registries/mercadopago.ts","../src/server.ts"],"names":["z","identityTools","WsaaWscdcAfipPadronAdapter","whatsappTools","WhatsAppClient","WhatsAppOtpAdapter","EmailMagicLinkAdapter","AttestationClient","identityAttestTools","MercadoPagoClient","mercadoPagoTools","InMemoryStateAdapter","Server","ListToolsRequestSchema","CallToolRequestSchema","StdioServerTransport"],"mappings":";;;;;;;;;;;;;AAkCO,SAAS,kBAAkB,OAAA,EAA8B;AAC9D,EAAA,MAAM,QAAmB,EAAC;AAC1B,EAAA,MAAM,MAAA,uBAAa,GAAA,EAAiD;AAEpE,EAAA,KAAA,MAAW,CAAC,IAAA,EAAM,IAAI,KAAK,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,EAAG;AAClD,IAAA,IAAI,CAAC,IAAA,IAAQ,OAAO,IAAA,KAAS,QAAA,EAAU;AACvC,IAAA,MAAM,WAAA,GACJ,iBAAiB,IAAA,IAAQ,OAAO,KAAK,WAAA,KAAgB,QAAA,GAAW,KAAK,WAAA,GAAc,EAAA;AACrF,IAAA,MAAM,cACJ,aAAA,IAAiB,IAAA,IAAQ,IAAA,CAAK,WAAA,GACzBA,MAAE,YAAA,CAAa,IAAA,CAAK,WAAwB,CAAA,GAC7C,EAAE,IAAA,EAAM,QAAA,EAAU,YAAY,EAAC,EAAG,sBAAsB,KAAA,EAAM;AAEpE,IAAA,KAAA,CAAM,IAAA,CAAK,EAAE,IAAA,EAAM,WAAA,EAAa,aAAa,CAAA;AAE7C,IAAA,MAAM,IAAA,GAAO,SAAA,IAAa,IAAA,GAAQ,IAAA,CAAK,OAAA,GAAkD,IAAA;AACzF,IAAA,IAAI,CAAC,IAAA,EAAM;AAET,MAAA;AAAA,IACF;AACA,IAAA,MAAA,CAAO,GAAA,CAAI,MAAM,IAAI,CAAA;AAAA,EACvB;AAEA,EAAA,OAAO;AAAA,IACL,KAAA;AAAA,IACA,IAAA,EAAM,OAAO,IAAA,EAAM,IAAA,KAAS;AAC1B,MAAA,MAAM,EAAA,GAAK,MAAA,CAAO,GAAA,CAAI,IAAI,CAAA;AAC1B,MAAA,IAAI,CAAC,EAAA,EAAI;AACP,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,MAAA,EAAS,IAAI,CAAA,kEAAA,CAAoE,CAAA;AAAA,MACnG;AACA,MAAA,OAAO,GAAG,IAAI,CAAA;AAAA,IAChB;AAAA,GACF;AACF;AAMO,SAAS,gBAAgB,QAAA,EAA6C;AAC3E,EAAA,MAAM,QAAmB,EAAC;AAC1B,EAAA,MAAM,MAAA,uBAAa,GAAA,EAAiD;AACpE,EAAA,MAAM,IAAA,uBAAW,GAAA,EAAY;AAE7B,EAAA,KAAA,MAAW,MAAM,QAAA,EAAU;AACzB,IAAA,IAAI,CAAC,EAAA,EAAI;AACT,IAAA,MAAM,OAAA,GAAU,kBAAkB,EAAE,CAAA;AACpC,IAAA,KAAA,MAAW,IAAA,IAAQ,QAAQ,KAAA,EAAO;AAChC,MAAA,IAAI,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,IAAI,CAAA,EAAG;AACvB,QAAA,MAAM,IAAI,KAAA;AAAA,UACR,CAAA,sBAAA,EAAyB,KAAK,IAAI,CAAA,0EAAA;AAAA,SACpC;AAAA,MACF;AACA,MAAA,IAAA,CAAK,GAAA,CAAI,KAAK,IAAI,CAAA;AAClB,MAAA,KAAA,CAAM,KAAK,IAAI,CAAA;AAEf,MAAA,MAAM,aAAA,GAAgB,OAAA;AACtB,MAAA,MAAM,WAAW,IAAA,CAAK,IAAA;AACtB,MAAA,MAAA,CAAO,GAAA,CAAI,UAAU,CAAC,IAAA,KAAkB,cAAc,IAAA,CAAK,QAAA,EAAU,IAAI,CAAC,CAAA;AAAA,IAC5E;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,KAAA;AAAA,IACA,IAAA,EAAM,OAAO,IAAA,EAAM,IAAA,KAAS;AAC1B,MAAA,MAAM,EAAA,GAAK,MAAA,CAAO,GAAA,CAAI,IAAI,CAAA;AAC1B,MAAA,IAAI,CAAC,EAAA,EAAI,MAAM,IAAI,KAAA,CAAM,CAAA,MAAA,EAAS,IAAI,CAAA,4BAAA,CAA8B,CAAA;AACpE,MAAA,OAAO,GAAG,IAAI,CAAA;AAAA,IAChB;AAAA,GACF;AACF;AC/FO,SAAS,kBAAA,GAA8B;AAC5C,EAAA,MAAM,OAAO,gBAAA,EAAiB;AAC9B,EAAA,OAAOC,uBAAc,IAAA,GAAO,EAAE,IAAA,EAAK,GAAI,EAAE,CAAA;AAC3C;AAEA,SAAS,gBAAA,GAAkD;AACzD,EAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,GAAA,CAAI,sBAAA,EAAwB,IAAA,EAAK;AACtD,EAAA,IAAI,CAAC,MAAM,OAAO,MAAA;AAClB,EAAA,MAAM,GAAA,GAAO,OAAA,CAAQ,GAAA,CAAI,QAAA,EAAU,MAAK,IAAK,MAAA;AAC7C,EAAA,MAAM,OAAA,GAAU,QAAQ,GAAA,CAAI,aAAA;AAC5B,EAAA,MAAM,MAAA,GAAS,QAAQ,GAAA,CAAI,YAAA;AAC3B,EAAA,IAAI,WAAW,MAAA,EAAQ;AACrB,IAAA,OAAO,IAAIC,gCAA2B,EAAE,OAAA,EAAS,QAAQ,gBAAA,EAAkB,IAAA,EAAM,KAAK,CAAA;AAAA,EACxF;AACA,EAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,GAAA,CAAI,cAAA,EAAgB,IAAA,EAAK;AAClD,EAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,GAAA,CAAI,aAAA,EAAe,IAAA,EAAK;AAChD,EAAA,IAAI,YAAY,OAAA,EAAS;AACvB,IAAA,OAAO,IAAIA,gCAA2B,EAAE,QAAA,EAAU,SAAS,gBAAA,EAAkB,IAAA,EAAM,KAAK,CAAA;AAAA,EAC1F;AACA,EAAA,OAAO,MAAA;AACT;AAEO,SAAS,sBAAA,GAAiC;AAC/C,EAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,GAAA,CAAI,sBAAA,EAAwB,IAAA,EAAK;AACtD,EAAA,IAAI,CAAC,MAAM,OAAO,8CAAA;AAClB,EAAA,MAAM,cAAA,GACJ,CAAC,CAAC,OAAA,CAAQ,IAAI,aAAA,IAAiB,CAAC,CAAC,OAAA,CAAQ,GAAA,CAAI,cAAA;AAC/C,EAAA,OAAO,cAAA,GACH,CAAA,gEAAA,EAAmE,IAAI,CAAA,CAAA,CAAA,GACvE,CAAA,wCAAA,CAAA;AACN;ACpCO,SAAS,kBAAA,GAAqC;AACnD,EAAA,MAAM,WAAA,GAAc,OAAA,CAAQ,GAAA,CAAI,eAAA,EAAiB,IAAA,EAAK;AACtD,EAAA,MAAM,aAAA,GAAgB,OAAA,CAAQ,GAAA,CAAI,kBAAA,EAAoB,IAAA,EAAK;AAC3D,EAAA,IAAI,CAAC,WAAA,IAAe,CAAC,aAAA,EAAe,OAAO,IAAA;AAC3C,EAAA,OAAOC,uBAAc,IAAIC,uBAAA,CAAe,EAAE,WAAA,EAAa,aAAA,EAAe,CAAC,CAAA;AACzE;AAEO,SAAS,sBAAA,GAAiC;AAC/C,EAAA,MAAM,WAAA,GAAc,OAAA,CAAQ,GAAA,CAAI,eAAA,EAAiB,IAAA,EAAK;AACtD,EAAA,MAAM,aAAA,GAAgB,OAAA,CAAQ,GAAA,CAAI,kBAAA,EAAoB,IAAA,EAAK;AAC3D,EAAA,IAAI,CAAC,eAAe,CAAC,aAAA;AACnB,IAAA,OAAO,2DAAA;AACT,EAAA,OAAO,CAAA,gBAAA,EAAmB,aAAA,CAAc,KAAA,CAAM,CAAA,EAAG,CAAC,CAAC,CAAA,MAAA,CAAA;AACrD;AAGO,SAAS,iBAAA,GAA2C;AACzD,EAAA,MAAM,WAAA,GAAc,OAAA,CAAQ,GAAA,CAAI,eAAA,EAAiB,IAAA,EAAK;AACtD,EAAA,MAAM,aAAA,GAAgB,OAAA,CAAQ,GAAA,CAAI,kBAAA,EAAoB,IAAA,EAAK;AAC3D,EAAA,IAAI,CAAC,WAAA,IAAe,CAAC,aAAA,EAAe,OAAO,IAAA;AAC3C,EAAA,OAAO,IAAIA,uBAAA,CAAe,EAAE,WAAA,EAAa,eAAe,CAAA;AAC1D;;;ACTO,SAAS,wBAAA,GAA2C;AACzD,EAAA,MAAM,aAAA,GAAgB,OAAA,CAAQ,GAAA,CAAI,qBAAA,EAAuB,IAAA,EAAK;AAC9D,EAAA,IAAI,CAAC,eAAe,OAAO,IAAA;AAE3B,EAAA,MAAM,WAAmG,EAAC;AAG1G,EAAA,MAAM,KAAK,iBAAA,EAAkB;AAC7B,EAAA,IAAI,EAAA,EAAI;AACN,IAAA,QAAA,CAAS,cAAc,CAAA,GAAI,IAAIC,iCAAA,CAAmB;AAAA,MAChD,cAAA,EAAgB,EAAA;AAAA,MAChB,YAAA,EAAc,OAAA,CAAQ,GAAA,CAAI,aAAA,EAAe,MAAK,IAAK;AAAA,KACpD,CAAA;AAAA,EACH;AAGA,EAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,GAAA,CAAI,cAAA,EAAgB,IAAA,EAAK;AACnD,EAAA,MAAM,WAAA,GAAc,OAAA,CAAQ,GAAA,CAAI,mBAAA,EAAqB,IAAA,EAAK;AAC1D,EAAA,IAAI,aAAa,WAAA,EAAa;AAC5B,IAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,GAAA,CAAI,iBAAA,EAAmB,MAAK,IAAK,qBAAA;AAC3D,IAAA,MAAM,SAAsB,OAAO,EAAE,IAAI,OAAA,EAAS,IAAA,EAAM,MAAK,KAAM;AACjE,MAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,+BAAA,EAAiC;AAAA,QACvD,MAAA,EAAQ,MAAA;AAAA,QACR,OAAA,EAAS;AAAA,UACP,aAAA,EAAe,UAAU,SAAS,CAAA,CAAA;AAAA,UAClC,cAAA,EAAgB;AAAA,SAClB;AAAA,QACA,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,EAAE,IAAA,EAAM,WAAW,EAAA,EAAI,OAAA,EAAS,IAAA,EAAM,IAAA,EAAM;AAAA,OAClE,CAAA;AACD,MAAA,IAAI,CAAC,IAAI,EAAA,EAAI;AACX,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,oBAAA,EAAuB,GAAA,CAAI,MAAM,IAAI,MAAM,GAAA,CAAI,IAAA,EAAM,CAAA,CAAE,CAAA;AAAA,MACzE;AAAA,IACF,CAAA;AACA,IAAA,QAAA,CAAS,kBAAkB,CAAA,GAAI,IAAIC,oCAAA,CAAsB;AAAA,MACvD,MAAA;AAAA,MACA,eAAA,EAAiB,WAAA;AAAA,MACjB,YAAA,EAAc,OAAA,CAAQ,GAAA,CAAI,aAAA,EAAe,MAAK,IAAK;AAAA,KACpD,CAAA;AAAA,EACH;AAEA,EAAA,IAAI,OAAO,IAAA,CAAK,QAAQ,CAAA,CAAE,MAAA,KAAW,GAAG,OAAO,IAAA;AAE/C,EAAA,MAAM,SAAS,IAAIC,gCAAA,CAAkB,EAAE,aAAA,EAAe,UAAU,CAAA;AAChE,EAAA,OAAOC,mCAAoB,MAAM,CAAA;AACnC;AAEO,SAAS,4BAAA,GAAuC;AACrD,EAAA,MAAM,aAAA,GAAgB,OAAA,CAAQ,GAAA,CAAI,qBAAA,EAAuB,IAAA,EAAK;AAC9D,EAAA,IAAI,CAAC,eAAe,OAAO,4CAAA;AAC3B,EAAA,MAAM,WAAqB,EAAC;AAC5B,EAAA,IAAI,iBAAA,EAAkB,EAAG,QAAA,CAAS,IAAA,CAAK,cAAc,CAAA;AACrD,EAAA,IAAI,OAAA,CAAQ,IAAI,cAAA,EAAgB,IAAA,MAAU,OAAA,CAAQ,GAAA,CAAI,qBAAqB,IAAA,EAAK;AAC9E,IAAA,QAAA,CAAS,KAAK,kBAAkB,CAAA;AAClC,EAAA,IAAI,SAAS,MAAA,KAAW,CAAA;AACtB,IAAA,OAAO,6FAAA;AACT,EAAA,OAAO,QAAA,CAAS,KAAK,IAAI,CAAA;AAC3B;AC5DO,SAAS,qBAAA,GAAwC;AACtD,EAAA,MAAM,WAAA,GAAc,OAAA,CAAQ,GAAA,CAAI,eAAA,EAAiB,IAAA,EAAK;AACtD,EAAA,IAAI,CAAC,aAAa,OAAO,IAAA;AACzB,EAAA,MAAM,MAAA,GAAS,IAAIC,6BAAA,CAAkB,EAAE,aAAa,CAAA;AACpD,EAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,GAAA,CAAI,WAAA,EAAa,MAAK,IAAK,0BAAA;AACnD,EAAA,OAAOC,6BAAiB,MAAA,EAAQ;AAAA,IAC9B,KAAA,EAAO,IAAIC,gCAAA,EAAqB;AAAA,IAChC;AAAA,GACD,CAAA;AACH;AAEO,SAAS,yBAAA,GAAoC;AAClD,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,GAAA,CAAI,eAAA,EAAiB,IAAA,EAAK;AAChD,EAAA,IAAI,CAAC,OAAO,OAAO,sCAAA;AACnB,EAAA,MAAM,MAAA,GAAS,KAAA,CAAM,UAAA,CAAW,OAAO,CAAA;AACvC,EAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,GAAA,CAAI,WAAA,EAAa,IAAA,EAAK;AAC9C,EAAA,OAAO,CAAA,EAAG,SAAS,MAAA,GAAS,MAAM,QAAQ,OAAA,GAAU,CAAA,eAAA,EAAe,OAAO,CAAA,CAAA,GAAK,8BAA2B,CAAA,CAAA;AAC5G;;;ACVA,IAAM,WAAA,GAAc,WAAA;AACpB,IAAM,cAAA,GAAiB,OAAA;AAOvB,eAAsB,YAAA,GAA+D;AACnF,EAAA,MAAM,UAAU,eAAA,CAAgB;AAAA,IAC9B,kBAAA,EAAmB;AAAA,IACnB,qBAAA,EAAsB;AAAA,IACtB,kBAAA,EAAmB;AAAA,IACnB,wBAAA;AAAyB,GAC1B,CAAA;AAED,EAAA,MAAM,OAAA,GAAU;AAAA,IACd,GAAG,WAAW,CAAA,CAAA,EAAI,cAAc,CAAA,eAAA,EAAkB,OAAA,CAAQ,MAAM,MAAM,CAAA,kBAAA,CAAA;AAAA,IACtE,CAAA,uBAAA,EAAqB,wBAAwB,CAAA,CAAA;AAAA,IAC7C,CAAA,uBAAA,EAAqB,2BAA2B,CAAA,CAAA;AAAA,IAChD,CAAA,uBAAA,EAAqB,wBAAwB,CAAA,CAAA;AAAA,IAC7C,CAAA,yBAAA,EAAuB,8BAA8B,CAAA;AAAA,GACvD;AAEA,EAAA,MAAM,SAAS,IAAIC,eAAA;AAAA,IACjB,EAAE,IAAA,EAAM,WAAA,EAAa,OAAA,EAAS,cAAA,EAAe;AAAA,IAC7C,EAAE,YAAA,EAAc,EAAE,KAAA,EAAO,IAAG;AAAE,GAChC;AAEA,EAAA,MAAA,CAAO,iBAAA,CAAkBC,iCAAwB,aAAa;AAAA,IAC5D,OAAO,OAAA,CAAQ;AAAA,GACjB,CAAE,CAAA;AAEF,EAAA,MAAA,CAAO,iBAAA,CAAkBC,8BAAA,EAAuB,OAAO,OAAA,KAAY;AACjE,IAAA,MAAM,EAAE,IAAA,EAAM,SAAA,EAAW,IAAA,KAAS,OAAA,CAAQ,MAAA;AAC1C,IAAA,IAAI;AACF,MAAA,MAAM,SAAS,MAAM,OAAA,CAAQ,KAAK,IAAA,EAAM,IAAA,IAAQ,EAAE,CAAA;AAClD,MAAA,OAAO;AAAA,QACL,OAAA,EAAS,CAAC,EAAE,IAAA,EAAM,MAAA,EAAQ,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,MAAA,EAAQ,IAAA,EAAM,CAAC,CAAA,EAAG;AAAA,OACnE;AAAA,IACF,SAAS,GAAA,EAAK;AACZ,MAAA,MAAM,MAAM,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC3D,MAAA,OAAO;AAAA,QACL,OAAA,EAAS,CAAC,EAAE,IAAA,EAAM,MAAA,EAAQ,IAAA,EAAM,CAAA,cAAA,EAAiB,IAAI,CAAA,EAAA,EAAK,GAAG,CAAA,CAAA,EAAI,CAAA;AAAA,QACjE,OAAA,EAAS;AAAA,OACX;AAAA,IACF;AAAA,EACF,CAAC,CAAA;AAED,EAAA,OAAO,EAAE,QAAQ,OAAA,EAAQ;AAC3B;AAOA,eAAsB,UAAA,GAA4B;AAChD,EAAA,MAAM,EAAE,MAAA,EAAQ,OAAA,EAAQ,GAAI,MAAM,YAAA,EAAa;AAC/C,EAAA,KAAA,MAAW,IAAA,IAAQ,OAAA,EAAS,OAAA,CAAQ,KAAA,CAAM,IAAI,CAAA;AAC9C,EAAA,MAAM,SAAA,GAAY,IAAIC,6BAAA,EAAqB;AAC3C,EAAA,MAAM,MAAA,CAAO,QAAQ,SAAS,CAAA;AAC9B,EAAA,OAAA,CAAQ,MAAM,0CAA0C,CAAA;AAC1D","file":"index.cjs","sourcesContent":["import type { ToolSet } from \"ai\";\nimport { z } from \"zod\";\n\n/**\n * Convert a Vercel AI SDK ToolSet to MCP-compatible tool definitions.\n *\n * Vercel AI SDK's `tool()` shape:\n *   { description, inputSchema: ZodSchema, execute: (args) => result }\n *\n * MCP's tool shape:\n *   { name, description, inputSchema: JSONSchema }\n *   + a separate handler that takes (name, args) and returns the result\n */\n\nexport interface McpTool {\n  name: string;\n  description: string;\n  inputSchema: object; // JSON Schema\n}\n\nexport interface McpAdapter {\n  /** All MCP tool definitions (for ListTools response). */\n  tools: McpTool[];\n  /** Handler for CallTool — looks up the original Vercel AI SDK tool and runs execute. */\n  call: (name: string, args: unknown) => Promise<unknown>;\n}\n\n/**\n * Bridge a Vercel AI SDK ToolSet → MCP tools + dispatcher.\n *\n * Throws on unknown tool name or if execute is missing (safety: every Vercel\n * AI SDK tool ships with `execute` for server-side flows, which is what\n * MCP needs).\n */\nexport function adaptToolSetToMcp(toolSet: ToolSet): McpAdapter {\n  const tools: McpTool[] = [];\n  const lookup = new Map<string, (args: unknown) => Promise<unknown>>();\n\n  for (const [name, tool] of Object.entries(toolSet)) {\n    if (!tool || typeof tool !== \"object\") continue;\n    const description =\n      \"description\" in tool && typeof tool.description === \"string\" ? tool.description : \"\";\n    const inputSchema =\n      \"inputSchema\" in tool && tool.inputSchema\n        ? (z.toJSONSchema(tool.inputSchema as z.ZodType) as object)\n        : { type: \"object\", properties: {}, additionalProperties: false };\n\n    tools.push({ name, description, inputSchema });\n\n    const exec = \"execute\" in tool ? (tool.execute as (args: unknown) => Promise<unknown>) : null;\n    if (!exec) {\n      // Server-side execution required for MCP; skip tools without execute.\n      continue;\n    }\n    lookup.set(name, exec);\n  }\n\n  return {\n    tools,\n    call: async (name, args) => {\n      const fn = lookup.get(name);\n      if (!fn) {\n        throw new Error(`Tool \"${name}\" not found or has no execute fn (MCP requires server-side tools).`);\n      }\n      return fn(args);\n    },\n  };\n}\n\n/**\n * Combine multiple Vercel AI SDK ToolSets into a single McpAdapter. Tool\n * name collisions throw at adapter-build time.\n */\nexport function combineToolSets(toolSets: Array<ToolSet | null>): McpAdapter {\n  const tools: McpTool[] = [];\n  const lookup = new Map<string, (args: unknown) => Promise<unknown>>();\n  const seen = new Set<string>();\n\n  for (const ts of toolSets) {\n    if (!ts) continue;\n    const adapter = adaptToolSetToMcp(ts);\n    for (const tool of adapter.tools) {\n      if (seen.has(tool.name)) {\n        throw new Error(\n          `Tool name collision: \"${tool.name}\" appears in multiple registered tool sets. Rename one or skip a registry.`,\n        );\n      }\n      seen.add(tool.name);\n      tools.push(tool);\n      // Bind this specific tool's call through the source adapter\n      const sourceAdapter = adapter;\n      const toolName = tool.name;\n      lookup.set(toolName, (args: unknown) => sourceAdapter.call(toolName, args));\n    }\n  }\n\n  return {\n    tools,\n    call: async (name, args) => {\n      const fn = lookup.get(name);\n      if (!fn) throw new Error(`Tool \"${name}\" not found in combined set.`);\n      return fn(args);\n    },\n  };\n}\n","import { identityTools, type AfipPadronAdapter } from \"@ar-agents/identity\";\nimport { WsaaWscdcAfipPadronAdapter } from \"@ar-agents/identity/wsaa\";\nimport type { ToolSet } from \"ai\";\n\n/**\n * Build the @ar-agents/identity tool set from environment variables.\n * Returns null when AFIP env vars are missing (the algorithm-only `validate_cuit`\n * is always available; lookup_cuit_afip falls back to UnconfiguredAfipPadronAdapter).\n */\nexport function buildIdentityTools(): ToolSet {\n  const afip = buildAfipAdapter();\n  return identityTools(afip ? { afip } : {}) as ToolSet;\n}\n\nfunction buildAfipAdapter(): AfipPadronAdapter | undefined {\n  const cuit = process.env.AFIP_CUIT_REPRESENTADO?.trim();\n  if (!cuit) return undefined;\n  const env = (process.env.AFIP_ENV?.trim() ?? \"prod\") as \"homo\" | \"prod\";\n  const certPem = process.env.AFIP_CERT_PEM;\n  const keyPem = process.env.AFIP_KEY_PEM;\n  if (certPem && keyPem) {\n    return new WsaaWscdcAfipPadronAdapter({ certPem, keyPem, cuitRepresentado: cuit, env });\n  }\n  const certPath = process.env.AFIP_CERT_PATH?.trim();\n  const keyPath = process.env.AFIP_KEY_PATH?.trim();\n  if (certPath && keyPath) {\n    return new WsaaWscdcAfipPadronAdapter({ certPath, keyPath, cuitRepresentado: cuit, env });\n  }\n  return undefined;\n}\n\nexport function describeIdentityConfig(): string {\n  const cuit = process.env.AFIP_CUIT_REPRESENTADO?.trim();\n  if (!cuit) return \"validate_cuit only (no AFIP cert configured)\";\n  const certConfigured =\n    !!process.env.AFIP_CERT_PEM || !!process.env.AFIP_CERT_PATH;\n  return certConfigured\n    ? `validate_cuit + lookup_cuit_afip (AFIP cert configured for CUIT ${cuit})`\n    : `validate_cuit only (cert not configured)`;\n}\n","import { WhatsAppClient, whatsappTools } from \"@ar-agents/whatsapp\";\nimport type { ToolSet } from \"ai\";\n\nexport function buildWhatsAppTools(): ToolSet | null {\n  const accessToken = process.env.WA_ACCESS_TOKEN?.trim();\n  const phoneNumberId = process.env.WA_PHONE_NUMBER_ID?.trim();\n  if (!accessToken || !phoneNumberId) return null;\n  return whatsappTools(new WhatsAppClient({ accessToken, phoneNumberId })) as ToolSet;\n}\n\nexport function describeWhatsAppConfig(): string {\n  const accessToken = process.env.WA_ACCESS_TOKEN?.trim();\n  const phoneNumberId = process.env.WA_PHONE_NUMBER_ID?.trim();\n  if (!accessToken || !phoneNumberId)\n    return \"not configured (set WA_ACCESS_TOKEN + WA_PHONE_NUMBER_ID)\";\n  return `phone_number_id=${phoneNumberId.slice(0, 6)}…`;\n}\n\n/** Returns the configured client, used by identity-attest's WhatsAppOtpAdapter. */\nexport function getWhatsAppClient(): WhatsAppClient | null {\n  const accessToken = process.env.WA_ACCESS_TOKEN?.trim();\n  const phoneNumberId = process.env.WA_PHONE_NUMBER_ID?.trim();\n  if (!accessToken || !phoneNumberId) return null;\n  return new WhatsAppClient({ accessToken, phoneNumberId });\n}\n","import {\n  AttestationClient,\n  identityAttestTools,\n  WhatsAppOtpAdapter,\n  EmailMagicLinkAdapter,\n  type EmailSender,\n} from \"@ar-agents/identity-attest\";\nimport type { ToolSet } from \"ai\";\nimport { getWhatsAppClient } from \"./whatsapp\";\n\n/**\n * Build @ar-agents/identity-attest tools if ATTEST_SIGNING_SECRET is set\n * and at least one adapter can be configured (WhatsApp client present\n * OR email sender configured via SMTP_URL / RESEND_API_KEY).\n */\nexport function buildIdentityAttestTools(): ToolSet | null {\n  const signingSecret = process.env.ATTEST_SIGNING_SECRET?.trim();\n  if (!signingSecret) return null;\n\n  const adapters: Record<string, ConstructorParameters<typeof AttestationClient>[0][\"adapters\"][string]> = {};\n\n  // WhatsApp OTP — requires WhatsApp client\n  const wa = getWhatsAppClient();\n  if (wa) {\n    adapters[\"whatsapp_otp\"] = new WhatsAppOtpAdapter({\n      whatsappClient: wa,\n      businessName: process.env.BUSINESS_NAME?.trim() ?? \"this app\",\n    });\n  }\n\n  // Email magic-link — requires Resend API key + callback URL\n  const resendKey = process.env.RESEND_API_KEY?.trim();\n  const callbackUrl = process.env.ATTEST_CALLBACK_URL?.trim();\n  if (resendKey && callbackUrl) {\n    const fromEmail = process.env.ATTEST_FROM_EMAIL?.trim() ?? \"noreply@example.com\";\n    const sender: EmailSender = async ({ to, subject, html, text }) => {\n      const res = await fetch(\"https://api.resend.com/emails\", {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${resendKey}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({ from: fromEmail, to, subject, html, text }),\n      });\n      if (!res.ok) {\n        throw new Error(`Resend send failed: ${res.status} ${await res.text()}`);\n      }\n    };\n    adapters[\"email_magic_link\"] = new EmailMagicLinkAdapter({\n      sender,\n      callbackBaseUrl: callbackUrl,\n      businessName: process.env.BUSINESS_NAME?.trim() ?? \"this app\",\n    });\n  }\n\n  if (Object.keys(adapters).length === 0) return null;\n\n  const client = new AttestationClient({ signingSecret, adapters });\n  return identityAttestTools(client) as ToolSet;\n}\n\nexport function describeIdentityAttestConfig(): string {\n  const signingSecret = process.env.ATTEST_SIGNING_SECRET?.trim();\n  if (!signingSecret) return \"not configured (set ATTEST_SIGNING_SECRET)\";\n  const adapters: string[] = [];\n  if (getWhatsAppClient()) adapters.push(\"whatsapp_otp\");\n  if (process.env.RESEND_API_KEY?.trim() && process.env.ATTEST_CALLBACK_URL?.trim())\n    adapters.push(\"email_magic_link\");\n  if (adapters.length === 0)\n    return \"configured but no adapters (set WhatsApp creds and/or RESEND_API_KEY + ATTEST_CALLBACK_URL)\";\n  return adapters.join(\", \");\n}\n","import {\n  InMemoryStateAdapter,\n  MercadoPagoClient,\n  mercadoPagoTools,\n} from \"@ar-agents/mercadopago\";\nimport type { ToolSet } from \"ai\";\n\n/**\n * Build @ar-agents/mercadopago tools if MP_ACCESS_TOKEN is set.\n * Returns null when not configured.\n */\nexport function buildMercadoPagoTools(): ToolSet | null {\n  const accessToken = process.env.MP_ACCESS_TOKEN?.trim();\n  if (!accessToken) return null;\n  const client = new MercadoPagoClient({ accessToken });\n  const backUrl = process.env.MP_BACK_URL?.trim() ?? \"https://example.com/done\";\n  return mercadoPagoTools(client, {\n    state: new InMemoryStateAdapter(),\n    backUrl,\n  }) as ToolSet;\n}\n\nexport function describeMercadoPagoConfig(): string {\n  const token = process.env.MP_ACCESS_TOKEN?.trim();\n  if (!token) return \"not configured (set MP_ACCESS_TOKEN)\";\n  const isTest = token.startsWith(\"TEST-\");\n  const backUrl = process.env.MP_BACK_URL?.trim();\n  return `${isTest ? \"TEST\" : \"PROD\"} mode${backUrl ? ` · back_url=${backUrl}` : \" · using default back_url\"}`;\n}\n","import { Server } from \"@modelcontextprotocol/sdk/server/index.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport {\n  CallToolRequestSchema,\n  ListToolsRequestSchema,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport { combineToolSets } from \"./adapter\";\nimport { buildIdentityTools, describeIdentityConfig } from \"./registries/identity\";\nimport {\n  buildIdentityAttestTools,\n  describeIdentityAttestConfig,\n} from \"./registries/identity-attest\";\nimport {\n  buildMercadoPagoTools,\n  describeMercadoPagoConfig,\n} from \"./registries/mercadopago\";\nimport { buildWhatsAppTools, describeWhatsAppConfig } from \"./registries/whatsapp\";\n\nconst SERVER_NAME = \"ar-agents\";\nconst SERVER_VERSION = \"0.1.0\";\n\n/**\n * Build the @ar-agents/mcp server. Inspects environment variables to decide\n * which package's tools to register. Always registers @ar-agents/identity\n * (algorithm-only `validate_cuit` works without any env vars).\n */\nexport async function createServer(): Promise<{ server: Server; summary: string[] }> {\n  const adapter = combineToolSets([\n    buildIdentityTools(),\n    buildMercadoPagoTools(),\n    buildWhatsAppTools(),\n    buildIdentityAttestTools(),\n  ]);\n\n  const summary = [\n    `${SERVER_NAME}@${SERVER_VERSION} starting with ${adapter.tools.length} tools registered:`,\n    `  identity      → ${describeIdentityConfig()}`,\n    `  mercadopago   → ${describeMercadoPagoConfig()}`,\n    `  whatsapp      → ${describeWhatsAppConfig()}`,\n    `  identity-attest → ${describeIdentityAttestConfig()}`,\n  ];\n\n  const server = new Server(\n    { name: SERVER_NAME, version: SERVER_VERSION },\n    { capabilities: { tools: {} } },\n  );\n\n  server.setRequestHandler(ListToolsRequestSchema, async () => ({\n    tools: adapter.tools,\n  }));\n\n  server.setRequestHandler(CallToolRequestSchema, async (request) => {\n    const { name, arguments: args } = request.params;\n    try {\n      const result = await adapter.call(name, args ?? {});\n      return {\n        content: [{ type: \"text\", text: JSON.stringify(result, null, 2) }],\n      };\n    } catch (err) {\n      const msg = err instanceof Error ? err.message : String(err);\n      return {\n        content: [{ type: \"text\", text: `Error calling ${name}: ${msg}` }],\n        isError: true,\n      };\n    }\n  });\n\n  return { server, summary };\n}\n\n/**\n * Start the MCP server over stdio. Called by the CLI binary.\n * Logs the registered-tools summary to stderr (stdout is reserved for MCP\n * protocol messages).\n */\nexport async function startStdio(): Promise<void> {\n  const { server, summary } = await createServer();\n  for (const line of summary) console.error(line);\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n  console.error(\"ar-agents MCP server connected via stdio\");\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,84 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { ToolSet } from 'ai';
+import { WhatsAppClient } from '@ar-agents/whatsapp';
+
+/**
+ * Build the @ar-agents/mcp server. Inspects environment variables to decide
+ * which package's tools to register. Always registers @ar-agents/identity
+ * (algorithm-only `validate_cuit` works without any env vars).
+ */
+declare function createServer(): Promise<{
+    server: Server;
+    summary: string[];
+}>;
+/**
+ * Start the MCP server over stdio. Called by the CLI binary.
+ * Logs the registered-tools summary to stderr (stdout is reserved for MCP
+ * protocol messages).
+ */
+declare function startStdio(): Promise<void>;
+
+/**
+ * Convert a Vercel AI SDK ToolSet to MCP-compatible tool definitions.
+ *
+ * Vercel AI SDK's `tool()` shape:
+ *   { description, inputSchema: ZodSchema, execute: (args) => result }
+ *
+ * MCP's tool shape:
+ *   { name, description, inputSchema: JSONSchema }
+ *   + a separate handler that takes (name, args) and returns the result
+ */
+interface McpTool {
+    name: string;
+    description: string;
+    inputSchema: object;
+}
+interface McpAdapter {
+    /** All MCP tool definitions (for ListTools response). */
+    tools: McpTool[];
+    /** Handler for CallTool — looks up the original Vercel AI SDK tool and runs execute. */
+    call: (name: string, args: unknown) => Promise<unknown>;
+}
+/**
+ * Bridge a Vercel AI SDK ToolSet → MCP tools + dispatcher.
+ *
+ * Throws on unknown tool name or if execute is missing (safety: every Vercel
+ * AI SDK tool ships with `execute` for server-side flows, which is what
+ * MCP needs).
+ */
+declare function adaptToolSetToMcp(toolSet: ToolSet): McpAdapter;
+/**
+ * Combine multiple Vercel AI SDK ToolSets into a single McpAdapter. Tool
+ * name collisions throw at adapter-build time.
+ */
+declare function combineToolSets(toolSets: Array<ToolSet | null>): McpAdapter;
+
+/**
+ * Build the @ar-agents/identity tool set from environment variables.
+ * Returns null when AFIP env vars are missing (the algorithm-only `validate_cuit`
+ * is always available; lookup_cuit_afip falls back to UnconfiguredAfipPadronAdapter).
+ */
+declare function buildIdentityTools(): ToolSet;
+declare function describeIdentityConfig(): string;
+
+/**
+ * Build @ar-agents/mercadopago tools if MP_ACCESS_TOKEN is set.
+ * Returns null when not configured.
+ */
+declare function buildMercadoPagoTools(): ToolSet | null;
+declare function describeMercadoPagoConfig(): string;
+
+declare function buildWhatsAppTools(): ToolSet | null;
+declare function describeWhatsAppConfig(): string;
+/** Returns the configured client, used by identity-attest's WhatsAppOtpAdapter. */
+declare function getWhatsAppClient(): WhatsAppClient | null;
+
+/**
+ * Build @ar-agents/identity-attest tools if ATTEST_SIGNING_SECRET is set
+ * and at least one adapter can be configured (WhatsApp client present
+ * OR email sender configured via SMTP_URL / RESEND_API_KEY).
+ */
+declare function buildIdentityAttestTools(): ToolSet | null;
+declare function describeIdentityAttestConfig(): string;
+
+export { type McpAdapter, type McpTool, adaptToolSetToMcp, buildIdentityAttestTools, buildIdentityTools, buildMercadoPagoTools, buildWhatsAppTools, combineToolSets, createServer, describeIdentityAttestConfig, describeIdentityConfig, describeMercadoPagoConfig, describeWhatsAppConfig, getWhatsAppClient, startStdio };

package/dist/index.d.ts

@@ -0,0 +1,84 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { ToolSet } from 'ai';
+import { WhatsAppClient } from '@ar-agents/whatsapp';
+
+/**
+ * Build the @ar-agents/mcp server. Inspects environment variables to decide
+ * which package's tools to register. Always registers @ar-agents/identity
+ * (algorithm-only `validate_cuit` works without any env vars).
+ */
+declare function createServer(): Promise<{
+    server: Server;
+    summary: string[];
+}>;
+/**
+ * Start the MCP server over stdio. Called by the CLI binary.
+ * Logs the registered-tools summary to stderr (stdout is reserved for MCP
+ * protocol messages).
+ */
+declare function startStdio(): Promise<void>;
+
+/**
+ * Convert a Vercel AI SDK ToolSet to MCP-compatible tool definitions.
+ *
+ * Vercel AI SDK's `tool()` shape:
+ *   { description, inputSchema: ZodSchema, execute: (args) => result }
+ *
+ * MCP's tool shape:
+ *   { name, description, inputSchema: JSONSchema }
+ *   + a separate handler that takes (name, args) and returns the result
+ */
+interface McpTool {
+    name: string;
+    description: string;
+    inputSchema: object;
+}
+interface McpAdapter {
+    /** All MCP tool definitions (for ListTools response). */
+    tools: McpTool[];
+    /** Handler for CallTool — looks up the original Vercel AI SDK tool and runs execute. */
+    call: (name: string, args: unknown) => Promise<unknown>;
+}
+/**
+ * Bridge a Vercel AI SDK ToolSet → MCP tools + dispatcher.
+ *
+ * Throws on unknown tool name or if execute is missing (safety: every Vercel
+ * AI SDK tool ships with `execute` for server-side flows, which is what
+ * MCP needs).
+ */
+declare function adaptToolSetToMcp(toolSet: ToolSet): McpAdapter;
+/**
+ * Combine multiple Vercel AI SDK ToolSets into a single McpAdapter. Tool
+ * name collisions throw at adapter-build time.
+ */
+declare function combineToolSets(toolSets: Array<ToolSet | null>): McpAdapter;
+
+/**
+ * Build the @ar-agents/identity tool set from environment variables.
+ * Returns null when AFIP env vars are missing (the algorithm-only `validate_cuit`
+ * is always available; lookup_cuit_afip falls back to UnconfiguredAfipPadronAdapter).
+ */
+declare function buildIdentityTools(): ToolSet;
+declare function describeIdentityConfig(): string;
+
+/**
+ * Build @ar-agents/mercadopago tools if MP_ACCESS_TOKEN is set.
+ * Returns null when not configured.
+ */
+declare function buildMercadoPagoTools(): ToolSet | null;
+declare function describeMercadoPagoConfig(): string;
+
+declare function buildWhatsAppTools(): ToolSet | null;
+declare function describeWhatsAppConfig(): string;
+/** Returns the configured client, used by identity-attest's WhatsAppOtpAdapter. */
+declare function getWhatsAppClient(): WhatsAppClient | null;
+
+/**
+ * Build @ar-agents/identity-attest tools if ATTEST_SIGNING_SECRET is set
+ * and at least one adapter can be configured (WhatsApp client present
+ * OR email sender configured via SMTP_URL / RESEND_API_KEY).
+ */
+declare function buildIdentityAttestTools(): ToolSet | null;
+declare function describeIdentityAttestConfig(): string;
+
+export { type McpAdapter, type McpTool, adaptToolSetToMcp, buildIdentityAttestTools, buildIdentityTools, buildMercadoPagoTools, buildWhatsAppTools, combineToolSets, createServer, describeIdentityAttestConfig, describeIdentityConfig, describeMercadoPagoConfig, describeWhatsAppConfig, getWhatsAppClient, startStdio };

package/dist/index.js

@@ -0,0 +1,231 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import { identityTools } from '@ar-agents/identity';
+import { WsaaWscdcAfipPadronAdapter } from '@ar-agents/identity/wsaa';
+import { WhatsAppOtpAdapter, EmailMagicLinkAdapter, AttestationClient, identityAttestTools } from '@ar-agents/identity-attest';
+import { whatsappTools, WhatsAppClient } from '@ar-agents/whatsapp';
+import { MercadoPagoClient, mercadoPagoTools, InMemoryStateAdapter } from '@ar-agents/mercadopago';
+
+// src/server.ts
+function adaptToolSetToMcp(toolSet) {
+  const tools = [];
+  const lookup = /* @__PURE__ */ new Map();
+  for (const [name, tool] of Object.entries(toolSet)) {
+    if (!tool || typeof tool !== "object") continue;
+    const description = "description" in tool && typeof tool.description === "string" ? tool.description : "";
+    const inputSchema = "inputSchema" in tool && tool.inputSchema ? z.toJSONSchema(tool.inputSchema) : { type: "object", properties: {}, additionalProperties: false };
+    tools.push({ name, description, inputSchema });
+    const exec = "execute" in tool ? tool.execute : null;
+    if (!exec) {
+      continue;
+    }
+    lookup.set(name, exec);
+  }
+  return {
+    tools,
+    call: async (name, args) => {
+      const fn = lookup.get(name);
+      if (!fn) {
+        throw new Error(`Tool "${name}" not found or has no execute fn (MCP requires server-side tools).`);
+      }
+      return fn(args);
+    }
+  };
+}
+function combineToolSets(toolSets) {
+  const tools = [];
+  const lookup = /* @__PURE__ */ new Map();
+  const seen = /* @__PURE__ */ new Set();
+  for (const ts of toolSets) {
+    if (!ts) continue;
+    const adapter = adaptToolSetToMcp(ts);
+    for (const tool of adapter.tools) {
+      if (seen.has(tool.name)) {
+        throw new Error(
+          `Tool name collision: "${tool.name}" appears in multiple registered tool sets. Rename one or skip a registry.`
+        );
+      }
+      seen.add(tool.name);
+      tools.push(tool);
+      const sourceAdapter = adapter;
+      const toolName = tool.name;
+      lookup.set(toolName, (args) => sourceAdapter.call(toolName, args));
+    }
+  }
+  return {
+    tools,
+    call: async (name, args) => {
+      const fn = lookup.get(name);
+      if (!fn) throw new Error(`Tool "${name}" not found in combined set.`);
+      return fn(args);
+    }
+  };
+}
+function buildIdentityTools() {
+  const afip = buildAfipAdapter();
+  return identityTools(afip ? { afip } : {});
+}
+function buildAfipAdapter() {
+  const cuit = process.env.AFIP_CUIT_REPRESENTADO?.trim();
+  if (!cuit) return void 0;
+  const env = process.env.AFIP_ENV?.trim() ?? "prod";
+  const certPem = process.env.AFIP_CERT_PEM;
+  const keyPem = process.env.AFIP_KEY_PEM;
+  if (certPem && keyPem) {
+    return new WsaaWscdcAfipPadronAdapter({ certPem, keyPem, cuitRepresentado: cuit, env });
+  }
+  const certPath = process.env.AFIP_CERT_PATH?.trim();
+  const keyPath = process.env.AFIP_KEY_PATH?.trim();
+  if (certPath && keyPath) {
+    return new WsaaWscdcAfipPadronAdapter({ certPath, keyPath, cuitRepresentado: cuit, env });
+  }
+  return void 0;
+}
+function describeIdentityConfig() {
+  const cuit = process.env.AFIP_CUIT_REPRESENTADO?.trim();
+  if (!cuit) return "validate_cuit only (no AFIP cert configured)";
+  const certConfigured = !!process.env.AFIP_CERT_PEM || !!process.env.AFIP_CERT_PATH;
+  return certConfigured ? `validate_cuit + lookup_cuit_afip (AFIP cert configured for CUIT ${cuit})` : `validate_cuit only (cert not configured)`;
+}
+function buildWhatsAppTools() {
+  const accessToken = process.env.WA_ACCESS_TOKEN?.trim();
+  const phoneNumberId = process.env.WA_PHONE_NUMBER_ID?.trim();
+  if (!accessToken || !phoneNumberId) return null;
+  return whatsappTools(new WhatsAppClient({ accessToken, phoneNumberId }));
+}
+function describeWhatsAppConfig() {
+  const accessToken = process.env.WA_ACCESS_TOKEN?.trim();
+  const phoneNumberId = process.env.WA_PHONE_NUMBER_ID?.trim();
+  if (!accessToken || !phoneNumberId)
+    return "not configured (set WA_ACCESS_TOKEN + WA_PHONE_NUMBER_ID)";
+  return `phone_number_id=${phoneNumberId.slice(0, 6)}\u2026`;
+}
+function getWhatsAppClient() {
+  const accessToken = process.env.WA_ACCESS_TOKEN?.trim();
+  const phoneNumberId = process.env.WA_PHONE_NUMBER_ID?.trim();
+  if (!accessToken || !phoneNumberId) return null;
+  return new WhatsAppClient({ accessToken, phoneNumberId });
+}
+
+// src/registries/identity-attest.ts
+function buildIdentityAttestTools() {
+  const signingSecret = process.env.ATTEST_SIGNING_SECRET?.trim();
+  if (!signingSecret) return null;
+  const adapters = {};
+  const wa = getWhatsAppClient();
+  if (wa) {
+    adapters["whatsapp_otp"] = new WhatsAppOtpAdapter({
+      whatsappClient: wa,
+      businessName: process.env.BUSINESS_NAME?.trim() ?? "this app"
+    });
+  }
+  const resendKey = process.env.RESEND_API_KEY?.trim();
+  const callbackUrl = process.env.ATTEST_CALLBACK_URL?.trim();
+  if (resendKey && callbackUrl) {
+    const fromEmail = process.env.ATTEST_FROM_EMAIL?.trim() ?? "noreply@example.com";
+    const sender = async ({ to, subject, html, text }) => {
+      const res = await fetch("https://api.resend.com/emails", {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${resendKey}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({ from: fromEmail, to, subject, html, text })
+      });
+      if (!res.ok) {
+        throw new Error(`Resend send failed: ${res.status} ${await res.text()}`);
+      }
+    };
+    adapters["email_magic_link"] = new EmailMagicLinkAdapter({
+      sender,
+      callbackBaseUrl: callbackUrl,
+      businessName: process.env.BUSINESS_NAME?.trim() ?? "this app"
+    });
+  }
+  if (Object.keys(adapters).length === 0) return null;
+  const client = new AttestationClient({ signingSecret, adapters });
+  return identityAttestTools(client);
+}
+function describeIdentityAttestConfig() {
+  const signingSecret = process.env.ATTEST_SIGNING_SECRET?.trim();
+  if (!signingSecret) return "not configured (set ATTEST_SIGNING_SECRET)";
+  const adapters = [];
+  if (getWhatsAppClient()) adapters.push("whatsapp_otp");
+  if (process.env.RESEND_API_KEY?.trim() && process.env.ATTEST_CALLBACK_URL?.trim())
+    adapters.push("email_magic_link");
+  if (adapters.length === 0)
+    return "configured but no adapters (set WhatsApp creds and/or RESEND_API_KEY + ATTEST_CALLBACK_URL)";
+  return adapters.join(", ");
+}
+function buildMercadoPagoTools() {
+  const accessToken = process.env.MP_ACCESS_TOKEN?.trim();
+  if (!accessToken) return null;
+  const client = new MercadoPagoClient({ accessToken });
+  const backUrl = process.env.MP_BACK_URL?.trim() ?? "https://example.com/done";
+  return mercadoPagoTools(client, {
+    state: new InMemoryStateAdapter(),
+    backUrl
+  });
+}
+function describeMercadoPagoConfig() {
+  const token = process.env.MP_ACCESS_TOKEN?.trim();
+  if (!token) return "not configured (set MP_ACCESS_TOKEN)";
+  const isTest = token.startsWith("TEST-");
+  const backUrl = process.env.MP_BACK_URL?.trim();
+  return `${isTest ? "TEST" : "PROD"} mode${backUrl ? ` \xB7 back_url=${backUrl}` : " \xB7 using default back_url"}`;
+}
+
+// src/server.ts
+var SERVER_NAME = "ar-agents";
+var SERVER_VERSION = "0.1.0";
+async function createServer() {
+  const adapter = combineToolSets([
+    buildIdentityTools(),
+    buildMercadoPagoTools(),
+    buildWhatsAppTools(),
+    buildIdentityAttestTools()
+  ]);
+  const summary = [
+    `${SERVER_NAME}@${SERVER_VERSION} starting with ${adapter.tools.length} tools registered:`,
+    `  identity      \u2192 ${describeIdentityConfig()}`,
+    `  mercadopago   \u2192 ${describeMercadoPagoConfig()}`,
+    `  whatsapp      \u2192 ${describeWhatsAppConfig()}`,
+    `  identity-attest \u2192 ${describeIdentityAttestConfig()}`
+  ];
+  const server = new Server(
+    { name: SERVER_NAME, version: SERVER_VERSION },
+    { capabilities: { tools: {} } }
+  );
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: adapter.tools
+  }));
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+      const result = await adapter.call(name, args ?? {});
+      return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+      };
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return {
+        content: [{ type: "text", text: `Error calling ${name}: ${msg}` }],
+        isError: true
+      };
+    }
+  });
+  return { server, summary };
+}
+async function startStdio() {
+  const { server, summary } = await createServer();
+  for (const line of summary) console.error(line);
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("ar-agents MCP server connected via stdio");
+}
+
+export { adaptToolSetToMcp, buildIdentityAttestTools, buildIdentityTools, buildMercadoPagoTools, buildWhatsAppTools, combineToolSets, createServer, describeIdentityAttestConfig, describeIdentityConfig, describeMercadoPagoConfig, describeWhatsAppConfig, getWhatsAppClient, startStdio };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapter.ts","../src/registries/identity.ts","../src/registries/whatsapp.ts","../src/registries/identity-attest.ts","../src/registries/mercadopago.ts","../src/server.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { ToolSet } from \"ai\";\nimport { z } from \"zod\";\n\n/**\n * Convert a Vercel AI SDK ToolSet to MCP-compatible tool definitions.\n *\n * Vercel AI SDK's `tool()` shape:\n *   { description, inputSchema: ZodSchema, execute: (args) => result }\n *\n * MCP's tool shape:\n *   { name, description, inputSchema: JSONSchema }\n *   + a separate handler that takes (name, args) and returns the result\n */\n\nexport interface McpTool {\n  name: string;\n  description: string;\n  inputSchema: object; // JSON Schema\n}\n\nexport interface McpAdapter {\n  /** All MCP tool definitions (for ListTools response). */\n  tools: McpTool[];\n  /** Handler for CallTool — looks up the original Vercel AI SDK tool and runs execute. */\n  call: (name: string, args: unknown) => Promise<unknown>;\n}\n\n/**\n * Bridge a Vercel AI SDK ToolSet → MCP tools + dispatcher.\n *\n * Throws on unknown tool name or if execute is missing (safety: every Vercel\n * AI SDK tool ships with `execute` for server-side flows, which is what\n * MCP needs).\n */\nexport function adaptToolSetToMcp(toolSet: ToolSet): McpAdapter {\n  const tools: McpTool[] = [];\n  const lookup = new Map<string, (args: unknown) => Promise<unknown>>();\n\n  for (const [name, tool] of Object.entries(toolSet)) {\n    if (!tool || typeof tool !== \"object\") continue;\n    const description =\n      \"description\" in tool && typeof tool.description === \"string\" ? tool.description : \"\";\n    const inputSchema =\n      \"inputSchema\" in tool && tool.inputSchema\n        ? (z.toJSONSchema(tool.inputSchema as z.ZodType) as object)\n        : { type: \"object\", properties: {}, additionalProperties: false };\n\n    tools.push({ name, description, inputSchema });\n\n    const exec = \"execute\" in tool ? (tool.execute as (args: unknown) => Promise<unknown>) : null;\n    if (!exec) {\n      // Server-side execution required for MCP; skip tools without execute.\n      continue;\n    }\n    lookup.set(name, exec);\n  }\n\n  return {\n    tools,\n    call: async (name, args) => {\n      const fn = lookup.get(name);\n      if (!fn) {\n        throw new Error(`Tool \"${name}\" not found or has no execute fn (MCP requires server-side tools).`);\n      }\n      return fn(args);\n    },\n  };\n}\n\n/**\n * Combine multiple Vercel AI SDK ToolSets into a single McpAdapter. Tool\n * name collisions throw at adapter-build time.\n */\nexport function combineToolSets(toolSets: Array<ToolSet | null>): McpAdapter {\n  const tools: McpTool[] = [];\n  const lookup = new Map<string, (args: unknown) => Promise<unknown>>();\n  const seen = new Set<string>();\n\n  for (const ts of toolSets) {\n    if (!ts) continue;\n    const adapter = adaptToolSetToMcp(ts);\n    for (const tool of adapter.tools) {\n      if (seen.has(tool.name)) {\n        throw new Error(\n          `Tool name collision: \"${tool.name}\" appears in multiple registered tool sets. Rename one or skip a registry.`,\n        );\n      }\n      seen.add(tool.name);\n      tools.push(tool);\n      // Bind this specific tool's call through the source adapter\n      const sourceAdapter = adapter;\n      const toolName = tool.name;\n      lookup.set(toolName, (args: unknown) => sourceAdapter.call(toolName, args));\n    }\n  }\n\n  return {\n    tools,\n    call: async (name, args) => {\n      const fn = lookup.get(name);\n      if (!fn) throw new Error(`Tool \"${name}\" not found in combined set.`);\n      return fn(args);\n    },\n  };\n}\n","import { identityTools, type AfipPadronAdapter } from \"@ar-agents/identity\";\nimport { WsaaWscdcAfipPadronAdapter } from \"@ar-agents/identity/wsaa\";\nimport type { ToolSet } from \"ai\";\n\n/**\n * Build the @ar-agents/identity tool set from environment variables.\n * Returns null when AFIP env vars are missing (the algorithm-only `validate_cuit`\n * is always available; lookup_cuit_afip falls back to UnconfiguredAfipPadronAdapter).\n */\nexport function buildIdentityTools(): ToolSet {\n  const afip = buildAfipAdapter();\n  return identityTools(afip ? { afip } : {}) as ToolSet;\n}\n\nfunction buildAfipAdapter(): AfipPadronAdapter | undefined {\n  const cuit = process.env.AFIP_CUIT_REPRESENTADO?.trim();\n  if (!cuit) return undefined;\n  const env = (process.env.AFIP_ENV?.trim() ?? \"prod\") as \"homo\" | \"prod\";\n  const certPem = process.env.AFIP_CERT_PEM;\n  const keyPem = process.env.AFIP_KEY_PEM;\n  if (certPem && keyPem) {\n    return new WsaaWscdcAfipPadronAdapter({ certPem, keyPem, cuitRepresentado: cuit, env });\n  }\n  const certPath = process.env.AFIP_CERT_PATH?.trim();\n  const keyPath = process.env.AFIP_KEY_PATH?.trim();\n  if (certPath && keyPath) {\n    return new WsaaWscdcAfipPadronAdapter({ certPath, keyPath, cuitRepresentado: cuit, env });\n  }\n  return undefined;\n}\n\nexport function describeIdentityConfig(): string {\n  const cuit = process.env.AFIP_CUIT_REPRESENTADO?.trim();\n  if (!cuit) return \"validate_cuit only (no AFIP cert configured)\";\n  const certConfigured =\n    !!process.env.AFIP_CERT_PEM || !!process.env.AFIP_CERT_PATH;\n  return certConfigured\n    ? `validate_cuit + lookup_cuit_afip (AFIP cert configured for CUIT ${cuit})`\n    : `validate_cuit only (cert not configured)`;\n}\n","import { WhatsAppClient, whatsappTools } from \"@ar-agents/whatsapp\";\nimport type { ToolSet } from \"ai\";\n\nexport function buildWhatsAppTools(): ToolSet | null {\n  const accessToken = process.env.WA_ACCESS_TOKEN?.trim();\n  const phoneNumberId = process.env.WA_PHONE_NUMBER_ID?.trim();\n  if (!accessToken || !phoneNumberId) return null;\n  return whatsappTools(new WhatsAppClient({ accessToken, phoneNumberId })) as ToolSet;\n}\n\nexport function describeWhatsAppConfig(): string {\n  const accessToken = process.env.WA_ACCESS_TOKEN?.trim();\n  const phoneNumberId = process.env.WA_PHONE_NUMBER_ID?.trim();\n  if (!accessToken || !phoneNumberId)\n    return \"not configured (set WA_ACCESS_TOKEN + WA_PHONE_NUMBER_ID)\";\n  return `phone_number_id=${phoneNumberId.slice(0, 6)}…`;\n}\n\n/** Returns the configured client, used by identity-attest's WhatsAppOtpAdapter. */\nexport function getWhatsAppClient(): WhatsAppClient | null {\n  const accessToken = process.env.WA_ACCESS_TOKEN?.trim();\n  const phoneNumberId = process.env.WA_PHONE_NUMBER_ID?.trim();\n  if (!accessToken || !phoneNumberId) return null;\n  return new WhatsAppClient({ accessToken, phoneNumberId });\n}\n","import {\n  AttestationClient,\n  identityAttestTools,\n  WhatsAppOtpAdapter,\n  EmailMagicLinkAdapter,\n  type EmailSender,\n} from \"@ar-agents/identity-attest\";\nimport type { ToolSet } from \"ai\";\nimport { getWhatsAppClient } from \"./whatsapp\";\n\n/**\n * Build @ar-agents/identity-attest tools if ATTEST_SIGNING_SECRET is set\n * and at least one adapter can be configured (WhatsApp client present\n * OR email sender configured via SMTP_URL / RESEND_API_KEY).\n */\nexport function buildIdentityAttestTools(): ToolSet | null {\n  const signingSecret = process.env.ATTEST_SIGNING_SECRET?.trim();\n  if (!signingSecret) return null;\n\n  const adapters: Record<string, ConstructorParameters<typeof AttestationClient>[0][\"adapters\"][string]> = {};\n\n  // WhatsApp OTP — requires WhatsApp client\n  const wa = getWhatsAppClient();\n  if (wa) {\n    adapters[\"whatsapp_otp\"] = new WhatsAppOtpAdapter({\n      whatsappClient: wa,\n      businessName: process.env.BUSINESS_NAME?.trim() ?? \"this app\",\n    });\n  }\n\n  // Email magic-link — requires Resend API key + callback URL\n  const resendKey = process.env.RESEND_API_KEY?.trim();\n  const callbackUrl = process.env.ATTEST_CALLBACK_URL?.trim();\n  if (resendKey && callbackUrl) {\n    const fromEmail = process.env.ATTEST_FROM_EMAIL?.trim() ?? \"noreply@example.com\";\n    const sender: EmailSender = async ({ to, subject, html, text }) => {\n      const res = await fetch(\"https://api.resend.com/emails\", {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${resendKey}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({ from: fromEmail, to, subject, html, text }),\n      });\n      if (!res.ok) {\n        throw new Error(`Resend send failed: ${res.status} ${await res.text()}`);\n      }\n    };\n    adapters[\"email_magic_link\"] = new EmailMagicLinkAdapter({\n      sender,\n      callbackBaseUrl: callbackUrl,\n      businessName: process.env.BUSINESS_NAME?.trim() ?? \"this app\",\n    });\n  }\n\n  if (Object.keys(adapters).length === 0) return null;\n\n  const client = new AttestationClient({ signingSecret, adapters });\n  return identityAttestTools(client) as ToolSet;\n}\n\nexport function describeIdentityAttestConfig(): string {\n  const signingSecret = process.env.ATTEST_SIGNING_SECRET?.trim();\n  if (!signingSecret) return \"not configured (set ATTEST_SIGNING_SECRET)\";\n  const adapters: string[] = [];\n  if (getWhatsAppClient()) adapters.push(\"whatsapp_otp\");\n  if (process.env.RESEND_API_KEY?.trim() && process.env.ATTEST_CALLBACK_URL?.trim())\n    adapters.push(\"email_magic_link\");\n  if (adapters.length === 0)\n    return \"configured but no adapters (set WhatsApp creds and/or RESEND_API_KEY + ATTEST_CALLBACK_URL)\";\n  return adapters.join(\", \");\n}\n","import {\n  InMemoryStateAdapter,\n  MercadoPagoClient,\n  mercadoPagoTools,\n} from \"@ar-agents/mercadopago\";\nimport type { ToolSet } from \"ai\";\n\n/**\n * Build @ar-agents/mercadopago tools if MP_ACCESS_TOKEN is set.\n * Returns null when not configured.\n */\nexport function buildMercadoPagoTools(): ToolSet | null {\n  const accessToken = process.env.MP_ACCESS_TOKEN?.trim();\n  if (!accessToken) return null;\n  const client = new MercadoPagoClient({ accessToken });\n  const backUrl = process.env.MP_BACK_URL?.trim() ?? \"https://example.com/done\";\n  return mercadoPagoTools(client, {\n    state: new InMemoryStateAdapter(),\n    backUrl,\n  }) as ToolSet;\n}\n\nexport function describeMercadoPagoConfig(): string {\n  const token = process.env.MP_ACCESS_TOKEN?.trim();\n  if (!token) return \"not configured (set MP_ACCESS_TOKEN)\";\n  const isTest = token.startsWith(\"TEST-\");\n  const backUrl = process.env.MP_BACK_URL?.trim();\n  return `${isTest ? \"TEST\" : \"PROD\"} mode${backUrl ? ` · back_url=${backUrl}` : \" · using default back_url\"}`;\n}\n","import { Server } from \"@modelcontextprotocol/sdk/server/index.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport {\n  CallToolRequestSchema,\n  ListToolsRequestSchema,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport { combineToolSets } from \"./adapter\";\nimport { buildIdentityTools, describeIdentityConfig } from \"./registries/identity\";\nimport {\n  buildIdentityAttestTools,\n  describeIdentityAttestConfig,\n} from \"./registries/identity-attest\";\nimport {\n  buildMercadoPagoTools,\n  describeMercadoPagoConfig,\n} from \"./registries/mercadopago\";\nimport { buildWhatsAppTools, describeWhatsAppConfig } from \"./registries/whatsapp\";\n\nconst SERVER_NAME = \"ar-agents\";\nconst SERVER_VERSION = \"0.1.0\";\n\n/**\n * Build the @ar-agents/mcp server. Inspects environment variables to decide\n * which package's tools to register. Always registers @ar-agents/identity\n * (algorithm-only `validate_cuit` works without any env vars).\n */\nexport async function createServer(): Promise<{ server: Server; summary: string[] }> {\n  const adapter = combineToolSets([\n    buildIdentityTools(),\n    buildMercadoPagoTools(),\n    buildWhatsAppTools(),\n    buildIdentityAttestTools(),\n  ]);\n\n  const summary = [\n    `${SERVER_NAME}@${SERVER_VERSION} starting with ${adapter.tools.length} tools registered:`,\n    `  identity      → ${describeIdentityConfig()}`,\n    `  mercadopago   → ${describeMercadoPagoConfig()}`,\n    `  whatsapp      → ${describeWhatsAppConfig()}`,\n    `  identity-attest → ${describeIdentityAttestConfig()}`,\n  ];\n\n  const server = new Server(\n    { name: SERVER_NAME, version: SERVER_VERSION },\n    { capabilities: { tools: {} } },\n  );\n\n  server.setRequestHandler(ListToolsRequestSchema, async () => ({\n    tools: adapter.tools,\n  }));\n\n  server.setRequestHandler(CallToolRequestSchema, async (request) => {\n    const { name, arguments: args } = request.params;\n    try {\n      const result = await adapter.call(name, args ?? {});\n      return {\n        content: [{ type: \"text\", text: JSON.stringify(result, null, 2) }],\n      };\n    } catch (err) {\n      const msg = err instanceof Error ? err.message : String(err);\n      return {\n        content: [{ type: \"text\", text: `Error calling ${name}: ${msg}` }],\n        isError: true,\n      };\n    }\n  });\n\n  return { server, summary };\n}\n\n/**\n * Start the MCP server over stdio. Called by the CLI binary.\n * Logs the registered-tools summary to stderr (stdout is reserved for MCP\n * protocol messages).\n */\nexport async function startStdio(): Promise<void> {\n  const { server, summary } = await createServer();\n  for (const line of summary) console.error(line);\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n  console.error(\"ar-agents MCP server connected via stdio\");\n}\n"]}

package/package.json

@@ -0,0 +1,112 @@
+{
+  "name": "@ar-agents/mcp",
+  "version": "0.1.0",
+  "description": "MCP (Model Context Protocol) server that exposes the entire @ar-agents/* toolkit (identity, identity-attest, mercadopago, whatsapp) to any MCP host (Claude Desktop, Cursor, Codeium, etc.). One install, one config, all AR integrations.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude-desktop",
+    "cursor",
+    "ar-agents",
+    "argentina",
+    "afip",
+    "mercadopago",
+    "whatsapp"
+  ],
+  "license": "MIT",
+  "author": "Nazareno Clemente <naza@helloastro.co>",
+  "homepage": "https://github.com/ar-agents/ar-agents/tree/main/packages/mcp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ar-agents/ar-agents.git",
+    "directory": "packages/mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/ar-agents/ar-agents/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "bin": {
+    "ar-agents-mcp": "./bin/ar-agents-mcp.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "AGENTS.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "echo 'no lint configured yet'",
+    "validate": "publint && attw --pack .",
+    "size": "size-limit",
+    "clean": "rm -rf dist"
+  },
+  "size-limit": [
+    {
+      "name": "ESM",
+      "path": "dist/index.js",
+      "limit": "60 KB",
+      "ignore": [
+        "@modelcontextprotocol/sdk",
+        "node:crypto",
+        "crypto",
+        "node:fs",
+        "fs",
+        "node:path",
+        "path",
+        "node:child_process",
+        "node:url",
+        "node:util",
+        "node:http",
+        "node:https",
+        "node-forge"
+      ]
+    }
+  ],
+  "dependencies": {
+    "@ar-agents/identity": "workspace:*",
+    "@ar-agents/identity-attest": "workspace:*",
+    "@ar-agents/mercadopago": "workspace:*",
+    "@ar-agents/whatsapp": "workspace:*",
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "peerDependencies": {
+    "ai": ">=6.0.0",
+    "zod": ">=3.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.39",
+    "ai": "^6.0.175",
+    "tsup": "^8.3.5",
+    "typescript": "^5.9.3",
+    "vitest": "^2.1.8",
+    "zod": "^4.4.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}