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).

ar-agents, open infrastructure for AI corporations in Argentina

Material listo-para-publicar sobre @ar-agents/*. One-pager + datos verificables + frases citables + contacto. Pensado para periodistas, investors, regulators y comms teams que necesitan describir el proyecto en una página.

Esta página existe para que cualquiera (periodista, asesor de ministro, VC, otro programador) pueda explicar el proyecto en su propia conversación sin tener que recolectar datos por primera vez. Todo lo de abajo es verificable cruzando con el repo, npm, y los archivos públicos del sitio.

One-pager, qué es @ar-agents en 8 líneas

Qué esToolkit open-source para construir sociedades-IA argentinas.

Status17 paquetes en npm, 168 herramientas, MIT, SLSA v1 provenance.

AutorNaza, 26 años, monotributista, Buenos Aires.

LicenciaMIT, copy, fork, comercializar permitido.

OrigenBuild privado iniciado nov 2025; npm pública desde may 2026.

Estado régimenAnuncio Sturzenegger 28-abr-2026; ley estimada H1 2027.

Alcance funcional16 de las 17 piezas (TAD escritura sigue rolling out).

FilosofíaEdge-Runtime first, Web Crypto only, AbortSignal everywhere.

Frases citables (es)

Cada una está testeada para sobrevivir el test de un editor: ninguna afirmación se inventa, ninguna requiere defensa adicional más allá del repo público.

“ar-agents es la implementación de referencia open-source para sociedades-IA argentinas, la propuesta del ministro Sturzenegger del 28 de abril de 2026.”

“17 paquetes npm, 168 herramientas, todas auditables. MIT-licensed. Cualquier operador serio puede leer el código línea por línea.”

“El stack cubre 16 de las 17 piezas operativas que una empresa argentina necesita: identity, banking, factura electrónica, MP, ML, WhatsApp, BCRA, Boletín Oficial, IGJ, GDE/TAD, AP2, ACP bridge.”

“RFC-001 es el marco de responsabilidad propuesto: tres capas (operador / proveedor de modelo / autor de librería) que convierten el ataque ¿quién paga si la IA rompe algo? en una conversación contractual concreta.”

“El threat model público (14 amenazas explícitas, 14 mitigaciones) está en /security. No esconde nada.”

Números verificables

17

Paquetes en npm

168

Tools expuestas

17

Recetas de cookbook

4

Subpaths de testing

300+

Tests automatizados

SLSA v1, en cada release

Provenance attestations

~6 meses

Tiempo desde primer commit a 17 paquetes

USD 0

Costo upfront para usar

Endpoints públicos (machine-readable)

Tres surfaces hosted que un agente externo puede invocar directamente, sin instalar ningún paquete, sin ningún wrapper:

POST /api/auto-incorporate: auto-incorporación de una sociedad-IA en una sola llamada. Devuelve package.json, agent.ts, .env.example, README.md, una URL de deploy de Vercel one-click, checklist legal, y referencia firmada al audit log. Pensado para que un agente USA-LLC self-incorporate programáticamente.
POST /api/play, agent loop en vivo con 12 tools mockeados pero realistas. Streaming via Vercel AI Gateway. Cada tool call queda HMAC-firmado en el audit log keyed por x-play-session.
GET /api/play/audit/{sessionId}?verify=1: público y verificable. Devuelve las entradas del audit log con su firma HMAC-SHA256; el query param hace que el server reverifique y reporte si alguna entrada fue tampered.
GET /api/discovery + ?format=openapi, inventario de los 16 paquetes + las 168 tools + estos 3 endpoints como OpenAPI 3.1 stub. Un agente que crawlea el toolkit lo lee y decide qué llamar.

Cómo verificar

Todo lo de arriba es chequeable sin pedir nada al autor:

El código: git clone https://github.com/ar-agents/ar-agents. Repo público, MIT, sin claves de pago bloqueando el acceso.

Los paquetes: npm view @ar-agents/identity dist.attestations. Devuelve la entrada de Sigstore transparency-log + el commit de GitHub que produjo el tarball. Todos los paquetes ship esto.

El surface de tools: curl https://ar-agents.ar/api/discovery. JSON machine-readable con los 16 paquetes y las 168 tools listadas explícitamente. ?format=openapi devuelve un OpenAPI 3.1.0 stub para auditing tools.

La supply-chain: scorecard.dev audita 18 prácticas semanalmente. La cifra es pública.

Capturas + recursos visuales

Las páginas siguientes son screenshot-ready (Geist Sans + Geist Mono, fondo blanco, sin ads):

/, landing
/architecture: diagrama Mermaid de los 16 paquetes
/security: threat model con 14 amenazas
/incorporar: wizard live (genera repo + checklist legal)
/playbook (en) · /es/playbook (es), narrativa flagship
/sociedades-ia: terminal demo + framing del régimen
/rfcs/001: RFC con marco de responsabilidad de tres capas
/vs, tabla comparativa con AfipSDK / handrolled / consultoría

Contacto

Emailnaza@naza.ar

GitHubgithub.com/ar-agents/ar-agents

npm scope@ar-agents/* (17 paquetes públicos)

Sitioar-agents.ar

Carta abierta al Ministroar-agents.ar/al-ministro

RFC-001ar-agents.ar/rfcs/001

Threat modelar-agents.ar/security

Wizard de incorporaciónar-agents.ar/incorporar

Propuesta AAIF working groupgithub.com/ar-agents/ar-agents/blob/main/AAIF-WORKING-GROUP-PROPOSAL.md

Disponibilidad para entrevistas / consultas regulatorias: primera respuesta en menos de 48hs vía email. Idiomas: español (nativo), inglés (técnico). Zona horaria: UTC-3 (Buenos Aires) habitualmente, UTC+1 (Madrid) ocasional.

Press kit.