ar-agents
Show HN: Open infrastructure for Argentina's AI-run companies (36 NPM packages)
Last verified:
What is ar-agents?
AR Agents es un toolkit robusto diseñado para integrar la API de Mercado Pago con las capacidades experimentales de agentes del Vercel AI SDK 6, específicamente tailored para negocios argentinos. Ofrece 89 herramientas tipadas que cubren pagos, suscripciones, checkout, OAuth, gestión de órdenes y más, incluyendo métodos de pago locales como Cuotas.
El monorepo se extiende para proporcionar primitivas argentinas adicionales para validación de identidad (CUIT/CUIL), facturación electrónica AFIP/ARCA, integración con WhatsApp Business Cloud API, operaciones bancarias (CBU/CVU) y servicios de envío. Está optimizado para Edge Runtime con adaptadores Vercel KV, e incluye características avanzadas como instrumentación OpenTelemetry, idempotencia determinística y Human-In-The-Loop (HITL) programático.
Este toolkit es ideal para desarrolladores que construyen agentes de IA para automatizar flujos de trabajo financieros y operacionales complejos en Argentina. Es especialmente útil para empresas que necesitan integrar Mercado Pago con sistemas de IA, MSPs que automatizan el ciclo de cuenta a cobro, y cualquier negocio argentino que requiere integración completa con el ecosistema tecnológico local.
El paquete insignia @ar-agents/mercadopago es la pieza más madura del stack, usada en demos productivos y referenciada por el resto del toolkit. Los paquetes sidecar cubren el resto del stack argentino necesario para un negocio, cada uno publicado independientemente en npm.
ar-agents pricing
Pricing model: Freemium
Completamente gratuito bajo licencia MIT. Sin tier pago, sin telemetría, sin límites de uso. Todos los tarballs publicados llevan attestation de provenance npm SLSA v1. Todos los 16 packages se publican solo en npm y son free to use.
ar-agents pros
- 89 herramientas tipadas para Vercel AI SDK 6
- Idempotencia determinística por default
- HITL programático en 8 operaciones irreversibles
- Verificación de webhook HMAC con ventana de replay de 5 minutos
- Optimizado para Edge Runtime con Web Crypto
- Adaptadores Vercel KV listos para usar
- Instrumentación OpenTelemetry incluida
- Cobertura completa de Mercado Pago API
- Específico para Argentina (cuotas, ARCA, teléfono AR)
- Más herramientas que Stripe Agent Toolkit (89 vs 26)
- Licencia MIT completamente gratuita
- Sin telemetría ni límites de uso
- Attestation de provenance npm SLSA v1 en todos los tarballs
- Servidor MCP que bundlea 16 packages en uno
- Compatible con Claude Desktop, Cursor, Codeium, Continue, Cline
- Demo en vivo disponible para múltiples packages
- Zero-dependency TypeScript cliente para auto-incorporación
- Validador local pre-flight que atrapa 10 motivos de rechazo AFIP
- Circuit breaker incluido para resiliencia
- Adapter pattern pluggable para state y audit log
ar-agents cons
- Solo funciona en contextos argentinos (no es multi-country)
- Requiere Vercel AI SDK 6 (experimental)
- Solo disponible en npm, sin instalación alternativa
- Dataset de IGJ es muestreo no real-time
- Sin API pública documentada para gde-tad aún
- Firma digital real requiere token físico (solo verificación)
- Necesita configuración de tokens MP (TEST- o APP_USR-)
- HITL requiere implementar callback requireConfirmation manualmente
Frequently asked questions about ar-agents
¿En qué se diferencia del SDK oficial mercadopago?
El SDK oficial mercadopago es un cliente REST básico. ar-agents agrega tool schemas del Vercel AI SDK 6, idempotency keys determinísticas resistentes a retry de LLM, verificación de webhook HMAC con ventana de replay de 5 minutos, HITL programático en 8 operaciones irreversibles, soporte Edge Runtime vía Web Crypto, adapters de Vercel KV, e instrumentación OpenTelemetry. Podés usar ambos packages en el mismo proyecto.
¿Corre en Edge Runtime?
Sí. Todo el package usa Web Crypto, sin dependencia de node:crypto. Corre en Vercel Edge, Cloudflare Workers, Deno, y cualquier runtime V8-isolate. Verificación de webhooks, HMAC, e idempotency keys usan la Web Crypto API.
¿Qué es HITL en operaciones irreversibles?
8 tools modifican estado irreversiblemente (refund_payment, cancel_subscription, delete_customer_card, etc). El toolkit acepta un callback requireConfirmation que bloquea la ejecución hasta que tu código devuelva true. Es un gate programático, no solo instrucciones al LLM.
¿Cómo funciona la idempotency determinística?
Cuatro tools (create_payment, create_subscription, create_payment_preference, refund_payment) derivan la idempotency key de un hash SHA-256 de los inputs relevantes. Mismos inputs → misma key → MP deduplica server-side. Un LLM que reintenta un tool devuelve el recurso existente en vez de cobrar dos veces.
¿Es gratis?
Sí. Licencia MIT. Sin tier pago, sin telemetría, sin límites de uso. Todos los tarballs publicados llevan attestation de provenance npm SLSA v1.
¿Qué hay de AFIP, WhatsApp, banking, shipping?
Packages sidecar cubren el resto del stack argentino: @ar-agents/identity (CUIT + padrón AFIP/ARCA con monotributo + IVA), @ar-agents/facturacion (factura electrónica WSFE), @ar-agents/whatsapp (Business Cloud API), @ar-agents/banking (CBU/CVU + BCRA Central de Deudores), @ar-agents/shipping (Andreani/OCA/Correo Argentino), @ar-agents/identity-attest (orquestador de verificación HMAC). Cada uno se publica independiente.
¿Hay servidor MCP?
Sí. @ar-agents/mcp bundlea los 7 packages en un único servidor MCP compatible con Claude Desktop, Cursor, Codeium, Continue, Cline. Listado en Glama y en el MCP Registry oficial como io.github.ar-agents/mcp.
¿Qué incluye en pagos?
Include create/capture/refund, OAuth marketplace, Checkout Pro, y Order Management. Tiene cobertura completa de Mercado Pago con 89 tools que abarcan todas las funcionalidades principales.
¿Cómo funciona Cuotas argentino?
Incluye catálogo de promos AR, cuotas, y resolución de challenge 3DS. Es específico para Argentina, diferenciándose de soluciones internacionales como Stripe que no tienen soporte para cuotas locales.
¿Qué agentes pueden usar este toolkit?
Agentes de IA que usan Vercel AI SDK 6, incluyendo ChatGPT, Claude, Gemini y otros clientes de agentic-commerce. El servidor MCP permite uso en Claude Desktop, Cursor, Codeium, Continue, y Cline con auto-detección de packages basada en env vars.