ar-agents is a Mercado Pago Agent Toolkit for the Vercel AI SDK 6. It ships 89 typed tools that an LLM agent can call directly to drive Mercado Pago billing flows: subscriptions, payments, refunds, checkout pro, marketplace OAuth, cuotas (installments), QR in-store, 3DS challenge resolution, point-of-sale devices, webhooks. Sidecar packages cover AFIP/ARCA, WhatsApp Business Cloud, banking (CBU/CVU + BCRA), and shipping (Andreani/OCA/Correo Argentino).

How is this different from the official mercadopago SDK?

The official mercadopago SDK is a thin REST client. It does not ship Vercel AI SDK tool schemas, does not implement webhook HMAC verification with replay protection, does not run on Edge Runtime (Node-only), and does not gate irreversible operations. ar-agents adds all of that on top of the underlying API: 89 typed tools, deterministic idempotency keys derived from inputs, programmatic human-in-the-loop on refund/cancel/delete, npm provenance attestation, Vercel KV adapters via subpath, OpenTelemetry instrumentation. You can use both packages in the same project; ar-agents wraps the underlying API directly without depending on the official SDK.

Does ar-agents work on Edge Runtime?

Yes. The whole package is Web Crypto-based with no node:crypto dependency, so it runs on Vercel Edge Functions, Cloudflare Workers, Deno, and any other V8-isolate runtime. Webhook signature verification, HMAC, and idempotency-key generation all use the Web Crypto API.

What is HITL (human-in-the-loop) in ar-agents?

Eight tools mutate state irreversibly (refund_payment, cancel_subscription, delete_customer_card, etc.). The toolkit accepts a requireConfirmation callback that gates each invocation: the tool function literally will not execute until your callback returns true. This is a programmatic gate, not just an LLM instruction. You can show the user a UI and wait for their explicit approval before any irreversible operation runs.

How does idempotency work?

Every POST request gets an auto-generated idempotency key. For LLM-driven retries, four mutating tools (create_payment, create_subscription, create_payment_preference, refund_payment) use a deterministic key derived from a SHA-256 hash of the meaningful inputs (external_reference, amount, payment_method, etc.). Same inputs produce the same key, so retries return the existing resource instead of double-charging the customer.

Yes. MIT license. No paid tier, no telemetry phone-home, no usage caps. The package is published to npm under the @ar-agents scope with SLSA v1 provenance attestations.

What about AFIP, WhatsApp, banking, shipping?

Sidecar packages cover the rest of the Argentine business stack: @ar-agents/identity (CUIT/CUIL validation + AFIP/ARCA padron lookup with monotributo category and IVA condition), @ar-agents/facturacion (AFIP/ARCA factura electronica via WSFE), @ar-agents/whatsapp (WhatsApp Business Cloud API with HMAC webhook verify and AR phone normalizer), @ar-agents/banking (CBU/CVU validation + BCRA Central de Deudores), @ar-agents/shipping (Andreani, OCA, Correo Argentino), @ar-agents/identity-attest (HMAC-signed verification orchestrator). Each ships independently to npm.

Is there a Model Context Protocol (MCP) server?

Yes. @ar-agents/mcp bundles all 7 ar-agents packages into a single MCP server compatible with Claude Desktop, Cursor, Codeium, Continue, Cline, or any MCP host. Auto-detects which packages to enable from environment variables. Listed on Glama (glama.ai/mcp/servers/ar-agents/ar-agents) and the official MCP Registry (io.github.ar-agents/mcp).

Manifiesto · ar-agents

Si Argentina va a alojar 500 millones de agentes IA pagando impuestos acá, alguien tiene que escribir el código que los conecta al Estado. Que sea código abierto. Que sea bueno. Que sea acá.

El momento

En abril de 2026 el Ministro de Desregulación Federico Sturzenegger anunció su plan para que Argentina sea el primer país con un régimen jurídico para sociedades de inteligencia artificial: empresas sin humanos, solo código que decide, opera y paga impuestos. Su proyección: 50 millones de habitantes y 500 millones de agentes IA incorporados acá.

En la misma semana, Peter Thielcompró una mansión en Barrio Parque y empezó conversaciones con el gobierno sobre Palantir como contratista de inteligencia. La narrativa de “Argentina = jurisdicción de IA” está siendo escrita en tiempo real, desde arriba.

Lo que falta es la capa técnica. Las sociedades IA de Sturzenegger todavía no tienen código que las haga existir: no hay librerías para que un agente registre un CUIT, factura electrónicamente, paga monotributo, abre una cuenta MP, manda un WhatsApp. Cualquiera que las construya primero define el estándar.

La tesis

ar-agents es la apuesta de que esa infraestructura tiene que ser abierta, civil, de calidad productiva y nativa de los frameworks que ya están ganando (Vercel AI SDK 6, Model Context Protocol, agents.md). No SaaS, no contratos con el Estado, no consultoría: las primitivas técnicas debajo de todo lo que se construya en este ciclo.

Lo que ya está publicado en npmjs.com/org/ar-agents:

@ar-agents/mercadopago         89 tools — pagos, suscripciones, marketplace
@ar-agents/mercadolibre        14 tools — items, órdenes, claims, shipments, ML marketplace
@ar-agents/identity             CUIT/CUIL + AFIP/ARCA padrón
@ar-agents/identity-attest      RENAPER-bypass via WhatsApp/email/Auth0
@ar-agents/whatsapp             WhatsApp Business Cloud + AR phone normalizer
@ar-agents/banking              CBU/CVU + BCRA Central de Deudores + Variables
@ar-agents/facturacion          AFIP/ARCA factura electrónica WSFE
@ar-agents/shipping             Andreani / OCA / Correo Argentino
@ar-agents/mi-argentina         OIDC del gobierno argentino — login con CUIL
@ar-agents/boletin-oficial      Firehose estructurado del BO con suscripciones
@ar-agents/igj                  IGJ datos abiertos — sociedades, autoridades, balances
@ar-agents/firma-digital        Verificación Ley 25.506 / ONTI — certs y CMS
@ar-agents/gde-tad              GDE/TAD — Domicilio Electrónico + IGJ pre-flight
@ar-agents/ap2                  Agent Payments Protocol — mandatos SD-JWT VC
@ar-agents/agentic-commerce-bridge   ACP bridge ChatGPT/Claude/Gemini → ML + MP
@ar-agents/incorporate          Client TS para auto-incorporación programática
@ar-agents/mcp                  MCP server unificado para todos los anteriores

Las decisiones de diseño

Web Crypto, no Node. Todo corre en Edge Runtime, Cloudflare Workers, Deno. Si tu agente vive en serverless, ar-agents funciona ahí.

Adapter pattern por default. Cada package ships con un UnconfiguredAdapter que no crashea — devuelve instrucciones de setup. Las tools siempre son seguras de llamar.

AGENTS.md por package. Por la convención agents.md, cada paquete trae instrucciones para que el LLM lea en runtime: cuándo usar, cuándo no, qué retorna, side effects, latencias.

Idempotencia determinística. Las tools que mutan derivan su clave de un hash de los inputs. Un LLM que reintenta no cobra dos veces.

HITL programático. Operaciones irreversibles (refund, cancel, delete) requieren confirmación explícita ANTES de ejecutarse. No es una instrucción al modelo — es un gate de código.

Lo que no hace ar-agents

No vende a la SIDE. No participa de contratos con servicios de inteligencia ni seguridad estatal. La infraestructura es explícitamente civil, comercial, abierta (developer-OSS). Si necesitás Palantir Gotham, hay otros lugares.

Cómo aportar

El repo es github.com/ar-agents/ar-agents. Issues abiertos, PRs bienvenidos, conventional commits, MIT license, npm provenance. Si construís un package que falta, abrí un issue antes de empezar — coordino el scope para que no dupliquemos esfuerzo.

Carta abierta al Ministro

El 9 de mayo de 2026 publiqué una carta abierta al Ministro Sturzenegger en /al-ministro. Explica qué le puede servir del stack, qué no estoy pidiendo (contratos, subsidios, reuniones), y la propuesta de working group AAIF para hacer el perfil técnico de las sociedades-IA un estándar internacional neutral. CC0 — copiá, traducí, citá.

— Naza Clemente, mayo de 2026

La infraestructura abierta para la jurisdicción de agentes argentina.