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

/registro · public · self-listed · 2026-05-11

Registro público de implementaciones.

Cada sociedad-IA o demo argentina que implementa RFC-001..004 puede listarse aquí. Metadata pública únicamente: sin números de clientes, sin facturación, sin PII. Auto-suscripción vía PR a github.com/ar-agents/ar-agents.

Disclosure honesto. Hoy las 5 entradas listadas son operadas por el mismo CUIT (20-41758101-5, Nazareno Clemente). Esto NO es un ecosistema multi-operador — es una reference implementation + 4 demos del autor del proyecto. Cero (0) sociedades-IA productivas (con clientes reales, facturas reales, cobros reales): la ley de sociedades-IA aún no fue sancionada y el régimen no existe jurídicamente. Cuando un tercero adopte los RFCs y opere bajo su propio CUIT, su entrada se sumará vía PR. Mientras tanto, lo que ves es: una propuesta técnica completa, validada end-to-end por una sola persona.

1

Reference impl

4

Demos live

0

Productive sociedades

5

Total live

ar-agents (this site, reference implementation)
AR · Nazareno Clemente · CUIT 20-41758101-5
Reference impllive
Reference implementation of the spec. Hosts /play (interactive demo), /verify (HMAC verification), /api/play/audit/* (audit endpoints), /test-vectors (conformance vectors). Not a productive sociedad — i.e. does not transact with real customers, does not emit facturas, does not cobrar. Source of truth for the spec.
https://ar-agents.vercel.app· RFCs: rfc-001-v1, rfc-002-v1, rfc-003-draft, rfc-004-draft· listed since 2026-05-05
mp-hello demo
AR · Nazareno Clemente · CUIT 20-41758101-5
Demolive
Mercado Pago Subscriptions integration demo. Wired to a real MP sandbox + production app 178743372667921. Shows the @ar-agents/mercadopago lib end-to-end. Not a productive sociedad.
https://ar-agents-mp-hello.vercel.app· RFCs: rfc-001-v1· listed since 2026-05-05
cuit-hello demo
AR · Nazareno Clemente · CUIT 20-41758101-5
Demolive
AFIP/ARCA padron lookup + CUIT validation demo. Uses a real AFIP cert (homo for safety; prod cert available). Shows the @ar-agents/identity lib end-to-end. Not a productive sociedad.
https://ar-agents-cuit-hello.vercel.app· RFCs: rfc-001-v1· listed since 2026-05-05
whatsapp-hello demo
AR · Nazareno Clemente · CUIT 20-41758101-5
Demolive
WhatsApp Business Cloud API demo combining identity + MP + WhatsApp libs. Webhook handler + chat UI. Limited by Meta verification 5-recipient dev cap until business verification passes.
https://ar-agents-whatsapp-hello.vercel.app· RFCs: rfc-001-v1· listed since 2026-05-05
bridge-hello demo
AR · Nazareno Clemente · CUIT 20-41758101-5
Demolive
Agentic Commerce Bridge demo. AP2 + ACP + MCP protocol surfaces wired to MP. Shows how a foreign agent (Wyoming DAO LLC) interacts with an AR sociedad-IA per cookbook recipe 21.
https://ar-agents-bridge-hello.vercel.app· RFCs: rfc-001-v1· listed since 2026-05-05
(your sociedad-IA here)
AR · —
Productive sociedaddraft
Open a PR adding your sociedad-IA's metadata to apps/landing/src/app/registro/page.tsx in github.com/ar-agents/ar-agents. Provide: name, operator name + CUIT, public URL, RFCs you conform to, plain-English disclosure. The PR will be reviewed for honest claims (e.g. claimed RFC-001 conformance must include a /.well-known/agents.json that resolves).

Cómo agregar tu sociedad-IA

Asegurate de que tu sociedad-IA serve /.well-known/agents.json con metadata pública (RFC-002).
Asegurate de que tu endpoint de auditoría retorna entradas firmadas que pasan los vectores de conformidad RFC-004 (/test-vectors).
Abrí un PR a github.com/ar-agents/ar-agents modificando apps/landing/src/app/registro/page.tsx con tu entrada.
El PR se aprueba si los endpoints declarados responden + el disclosure es honesto. Sin más requisitos.