Datos públicos argentinos para tu agente de comercio: CUIT del cliente, impuestos vigentes, precios de mercado y dólar por MCP

Si estás construyendo un agente que vende, cobra o factura por un comercio argentino, ya resolviste la capa transaccional: el catálogo, el checkout, el link de pago, la factura electrónica, el envío. Lo que le falta a ese agente para no inventar es la capa de datos públicos: quién es el cliente ante ARCA, qué alícuota o categoría de monotributo está vigente hoy, a cuánto venden el mismo producto las cadenas y a cuánto está el dólar. Argentina Data MCP es esa capa, con datos oficiales y la fecha de actualización en cada respuesta.

Tu agente se conecta al servidor MCP remoto en https://argentinadata.mymcps.dev/mcp, o sólo al dominio que necesita: /mcp/afip para el padrón, /mcp/legal y /mcp/fiscal para impuestos, /mcp/supermercados para precios y /mcp/dolar para cotizaciones. Si tu backend no habla MCP, las mismas tools están como API REST en https://argentinadata.mymcps.dev/api/v1, con la especificación OpenAPI en /api/docs. Una sola API key sirve para las dos.

Nosotros sólo leemos datos públicos: no emitimos facturas, no cobramos ni guardamos datos de tus clientes. Por eso encajamos al lado de tu stack transaccional y no en su lugar. Todas las tools de esta página son estables: su contrato de respuesta no cambia sin aviso, y entran en el plan Free (20 consultas por día, 100 por semana y 300 por mes, sin tarjeta).

Lo que resolvés con una pregunta

Validar el CUIT del cliente antes de facturar

Antes de emitir un comprobante, el agente consulta afip_cuit_lookup con el CUIT que le pasó el cliente (con o sin guiones) y recibe la razón social y la condición ante IVA, Ganancias y Monotributo según el padrón de ARCA, que se actualiza cada semana. Un dígito verificador incorrecto vuelve como error de tipeo, para pedirle al cliente que lo revise. Un CUIT válido que no figura en el padrón (por ejemplo, un CUIL de alguien en relación de dependencia) vuelve con encontrado: false y una explicación, no como error. Si el cliente sólo da el nombre, afip_search_by_name lo busca por razón social.

El cliente me pasó el CUIT 30-54668997-9. ¿Qué razón social tiene y cuál es su condición frente al IVA, así sé qué comprobante emitirle?

Saber qué alícuota o categoría aplica hoy

legislacion_tributaria devuelve los valores vigentes de monotributo (categorías A a K, cuotas y topes), IVA (21%, 10,5% y 27%), Ganancias, autónomos e Ingresos Brutos de CABA, Buenos Aires, Córdoba, Santa Fe y Mendoza. El parámetro tema es obligatorio. Cada respuesta trae vigencia_vencida: si viene en true, el agente tiene que avisar que el organismo todavía no publicó los valores nuevos en vez de presentar los viejos como vigentes. Para el monotributo del propio vendedor (su categoría, cuánto paga y cuándo vence), está monotributo_consulta.

Soy monotributista y vendo productos. ¿Cuál es el tope de facturación anual de cada categoría y qué alícuota de IVA lleva un producto de la canasta con alícuota reducida?

Receta: ¿mi precio está dentro de mercado?

No hace falta una tool especial: se resuelve encadenando dos. Primero comparar_precios_sepa con el nombre o el código de barras del producto devuelve el precio promedio, mínimo y máximo en cada una de las 19 cadenas que informan al SEPA; si le pasás una dirección, se queda con las cadenas que tienen sucursal cerca y trae sus promociones, pero el precio de cada cadena sigue siendo su promedio nacional, porque el SEPA no publica precios por sucursal. Después el agente ubica el precio del vendedor contra ese rango (debajo del más barato, en la media, arriba del más caro) y, si el comercio piensa en dólares, lo convierte con dolar_cotizaciones. Sirve para productos de consumo masivo que venden los supermercados; para otros rubros no hay una fuente pública equivalente.

Vendo la yerba Playadito de 1 kg a 4.900 pesos. Comparala con los precios de las cadenas de supermercados y decime si estoy por encima o por debajo del mercado, y cuánto es eso en dólares al oficial y al MEP.

Cotizar y convertir en dólares

Para un comercio que lista precios en dólares o los actualiza por el tipo de cambio, dolar_cotizaciones trae el oficial, el mayorista, el blue, el MEP, el CCL, el cripto y el tarjeta, con compra, venta y la fecha de cada valor. El agente tiene que decir qué cotización usó: entre el oficial y el MEP puede haber una diferencia que cambia el precio final.

Tengo un producto a 25 dólares. ¿Cuánto es en pesos al dólar oficial, al MEP y al tarjeta, y de qué fecha es cada cotización?

Conocer la zona antes de abrir o de hacer una campaña

censo_market_research recibe una dirección y un radio y devuelve el perfil de la población de la zona según el Censo 2022: edad, nivel socioeconómico, vivienda, educación y empleo, comparado con el departamento, la provincia y el país. Le sirve a un agente que ayuda al comercio a decidir dónde abrir, qué surtido tener o a quién apuntar una campaña.

Quiero abrir un local en Av. Cabildo 2000, CABA. ¿Cómo es la población en 800 metros a la redonda comparada con el promedio de la ciudad?

Conectar tu agente sólo al dominio que usa

Cada dominio temático registra sus tools más las meta-tools de estado y cuota, así el agente carga menos schemas en su contexto. Un agente de facturación puede montar /mcp/afip y /mcp/legal; uno de pricing, /mcp/supermercados y /mcp/dolar. La autenticación es por API key en el header Authorization, o por OAuth en Claude.ai y ChatGPT.

claude mcp add argentina-afip --transport http https://argentinadata.mymcps.dev/mcp/afip

Llamar la tool desde tu propio cliente MCP o por REST

El transporte es HTTP streamable estándar: después del initialize, cada llamada es un tools/call de JSON-RPC como el de abajo, con la key en Authorization: Bearer. Si preferís REST, la misma consulta es GET /api/v1/afip/cuit/30546689979, y la de impuestos, GET /api/v1/legislacion/tributaria?tema=iva. Una diferencia con el MCP: por REST, un CUIT válido que no figura en el padrón vuelve como 404, con la explicación en error. Un parámetro obligatorio que falta o un valor que la tool no reconoce vuelven como 400 con el mensaje que explica qué pasar.

{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"afip_cuit_lookup","arguments":{"cuit":"30-54668997-9"}}}

Los datos que te importan

Herramientas que lo responden

Cada herramienta está disponible por MCP y, salvo que se indique lo contrario, también como recurso de la API REST. El catálogo completo está en la página principal.

afip_cuit_lookup

Buscar contribuyente por CUIT en el padrón de contribuyentes registrados (no todo CUIT/CUIL). Condiciones de IVA, Ganancias y Monotributo.

Fuente: ARCA
afip_search_by_name

Buscar contribuyentes por nombre sobre 6M+ registros del padrón.

Fuente: ARCA
legislacion_tributaria

Monotributo, Ganancias, IVA: datos estructurados de legislación fiscal vigente.

Fuente: ARCA
monotributo_consulta

Categorías del monotributo, topes de facturación, cuotas, vencimientos y requisitos vigentes.

comparar_precios_sepa

Compará el precio de un producto entre cadenas. Identifica la más barata y la más cara.

buscar_producto_sepa

Buscá productos en 19 cadenas de supermercados. Precios de 70.000+ productos actualizados a diario.

dolar_cotizaciones

Cotizaciones actuales: oficial, Banco Nación, blue, MEP, CCL, mayorista, cripto, tarjeta.

censo_market_research

Datos del Censo 2022: población, viviendas y segmentación por zona para análisis de mercado.

data_health

Estado del servicio: operativo, degradado o caído.

Preguntas frecuentes

¿Argentina Data MCP emite facturas o cobra?

No. Sólo lee datos públicos: padrón de ARCA, legislación tributaria vigente, precios del SEPA, cotizaciones y censo. La emisión de comprobantes, los cobros y la logística quedan en tu stack. Por eso se usa como capa de datos al lado de esas herramientas, no en su lugar.

¿Qué tan actualizado está el padrón de ARCA?

Se importa cada semana del padrón público de ARCA, así que un alta o un cambio de condición puede tardar hasta 7 días en aparecer. Cada respuesta trae la fecha de importación, para que el agente la cite si la decisión depende de un cambio reciente.

¿Qué pasa si una alícuota o una escala vence y todavía no salió la nueva?

La respuesta de legislacion_tributaria lo dice: vigencia_vencida viene en true y trae una advertencia. El agente tiene que transmitirla en vez de presentar los valores como vigentes. Es el caso típico de Ganancias al cierre de cada semestre.

¿Cuántas consultas puede hacer mi agente?

El plan Free incluye 20 consultas por día, 100 por semana y 300 por mes, con todas las tools estables, sin tarjeta. Las meta-tools de estado y cuota no descuentan. Si tu agente necesita más volumen, escribinos a [email protected].

¿Tengo que usar MCP o puedo integrarlo como API?

Las dos cosas. Cualquier cliente MCP con transporte HTTP se conecta directo a /mcp o a un dominio temático, y la misma API key sirve para la API REST bajo /api/v1, documentada con OpenAPI en /api/docs.

Cómo empezar, en dos minutos

  1. Creá tu cuenta gratis con Google: 20 consultas por día, sin tarjeta.
  2. Conectá Argentina Data en tu asistente siguiendo la guía paso a paso para Claude, ChatGPT, Cursor o VS Code.
  3. Hacé la pregunta como se la harías a una persona. El asistente elige la herramienta y te responde citando la fuente.

Empezá gratis con Google ¿Qué es MCP?