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

/highlights · 90-second read · 2026-05-11

Open-source infrastructure
for Argentine sociedades-IA.

Argentina announced a regime for AI-only companies on 28 April 2026. We've built the technical scaffolding so the legislation has something to cite. Five RFCs, 30 cookbook recipes, a public certifier, test vectors with deterministic signatures, a registry where every implementation scores 100/100.

The reference implementation self-certifies in real time against RFC-002 (discovery) + RFC-004 (operational log) + RFC-005 (Ed25519 upgrade path). Click the badge to run the check yourself.

5

RFCs

30

Recipes

17

npm packages

103

vitest tests

14

HTTP APIs

5/5

Sociedades A

What it solves

Three concrete problems for the new regime:

Civil liability — RFC-001 specifies a three-layer framework (operator / sociedad-IA / model provider) anchored to the governance class tag on each action. Read RFC-001
Operational evidence — RFC-004 pins down the wire format of the audit log every sociedad must keep. With 7 hex-exact test vectors. The reference impl passes byte-for-byte. Read RFC-004 · View vectors
Public verifiability — anyone can paste any URL into the certifier and get a 0-100 score in seconds. No install. No auth. Open /certifier

Three URLs to bookmark

/auditor — Spanish-first 1-page regulator brief. Print-friendly. For journalists, inspectors, asesores who arrive cold.
/legislación / /en/legislation — Bilingual synthesis with suggested cite-by-reference legislative text. For ministry staff drafting the bill.
/registro — Public list of implementations with live cert badges + conformance sparklines. For anyone who wants proof we ship.

If you want to dig in

Operators (you want your own sociedad-IA listed): /operator-quickstart (15-min zero-to-listed), /incorporar (wizard).
Developers: /sdk, /examples, repo.
Researchers: /refs (BibTeX/APA/Chicago), CITATION.cff at repo root, /glossary.
Press: /auditor, /timeline, shipping-spree note, /share (outreach templates).
Other jurisdictions (Wyoming / Estonia / Delaware): /en/legislation + RFC-003 (cross-jurisdictional reciprocity envelope).

What's NOT here

Honest scoping. The work covers technical infrastructure + evidence format. It does NOT cover:

Tax doctrine (monotributo, IVA, ganancias, ganancia mínima).
Labor (can a sociedad-IA be an employer?).
Bankruptcy / quiebra (what happens to keys in concurso?).
Penal (mens rea of an entity without consciousness).
Productive sociedades. Today (2026-05-11) the registry has 1 reference + 4 demos. Zero productive entities transacting with real customers.
Distribution. The work is shipped but not yet promoted. Outreach is the next step.

Contact

Nazareno Clemente · author + maintainer · CUIT 20-41758101-5 · Monte Grande, BA, Argentina.

naza@helloastro.co · github discussions. No fees for ministry / regulator / scholar conversations.