MCP server y API REST de datos argentinos: conectá Claude, ChatGPT o tu app a dólar, series, padrón y precios

Planes y cuota

¿Puedo usar la API o el MCP desde mi propio backend?

Sí. Cualquier servidor puede llamar a la API REST (https://argentinadata.mymcps.dev/api/v1) o conectarse al MCP con el header Authorization: Bearer TU_API_KEY. No hace falta usar Claude ni ChatGPT, y no hay un tipo de key distinto para backends: la misma key sirve para todo. Hay una guía paso a paso con ejemplos en curl, Node y Python.

¿La cuota del MCP y la de la API REST son la misma?

Sí. Cada key tiene un único cupo, y las consultas por MCP y por API REST se suman en el mismo contador.

¿Cuántas consultas incluye cada plan?

El plan Free incluye 20 consultas por día, 100 por semana y 300 por mes, sin tarjeta. El plan Pro incluye 100 por día, 500 por semana y 1.500 por mes. Los tres topes rigen a la vez: alcanzar cualquiera de ellos pausa las consultas hasta que se libere.

¿Los límites se reinician a medianoche?

No: son ventanas móviles. El tope diario cuenta las consultas de las últimas 24 horas, el semanal las de los últimos 7 días y el mensual las de los últimos 30 días. Cada consulta deja de contar sola cuando sale de la ventana. Con consultar_cuota (o GET /api/v1/fiscal/cuota) ves cuánto usaste y cuánto te queda.

¿Qué consultas no consumen cuota?

Las herramientas de descubrimiento y estado: que_puedo_consultar, data_health, consultar_cuota y enviar_feedback. En las consultas de precios de supermercados, tampoco cuentan las que no devuelven datos (por ejemplo, un EAN que no existe) ni las que fallan por un error de nuestro lado. Las consultas con un parámetro mal escrito o inválido sí consumen cuota. En el lote de códigos de barras (eans, hasta 50, en buscar, comparar y sucursal-barata) se cuenta una consulta cada 5 códigos con datos.

¿Qué pasa cuando se termina la cuota?

La API REST responde 402 en todos los planes. El cuerpo incluye tu consumo y un link para ampliar el plan o cargar crédito, y el header Retry-After trae los segundos hasta que se libera el tope agotado (si la única salida es cargar crédito, no viene). Por MCP, la herramienta devuelve el aviso como texto. Si tenés crédito prepago, las consultas siguen pasando solas. Si no, esperá a que las consultas más viejas salgan de la ventana o pasá a un plan mayor.

¿Hay un límite de velocidad?

Sí, por API key: hasta 5 pedidos por segundo sostenidos y hasta 4 en paralelo, tanto en la API REST como en el MCP. Las meta-tools (consultar_cuota, data_health, que_puedo_consultar y enviar_feedback) tienen un margen más amplio y no cuentan para el tope de paralelo, así podés consultar tu cuota aunque tengas pedidos en curso. Si te pasás, la API responde 429 con el header Retry-After (segundos) y un cuerpo con error rate_limited. Un 429 no consume cuota ni crédito. Los topes se aplican en cada servidor: con más de un servidor detrás, el tope efectivo puede ser mayor, así que no cuentes con él como cupo extra.

¿Cómo reintento ante errores?

Ante 429, esperá los segundos de Retry-After y reintentá. Ante 5xx y errores de red, reintentá con espera exponencial más un poco de azar (jitter), hasta unos 5 intentos. Los demás 4xx (400, 401, 404) no se reintentan: el pedido está mal o falta la key. Ante 402 frená: se terminó el cupo, esperá al reinicio (Retry-After) o cargá crédito. La guía para backends tiene un ejemplo en Python y en Node.

¿Puedo comprar consultas extra sin cambiar de plan?

Sí: con el crédito prepago, que cargás con Mercado Pago desde la página de planes (argentinadata.mymcps.dev/upgrade). El crédito se usa solo cuando se terminó el cupo de tu plan, no vence y descuenta una consulta por cada respuesta con datos o con un parámetro inválido (en el lote de códigos de barras, una por cada 5 códigos con datos). Las consultas sin datos y las que fallan por un error nuestro no lo gastan.

¿Cuánto cuesta consultar el historial de precios de un producto?

Una consulta por llamada a /sepa/historial (o a la herramienta historial_precios_sepa), sin importar cuántas sucursales o cuántos días devuelva. Si el producto no tiene historia en esa sucursal, la respuesta no consume cuota. Es una función beta, incluida en el plan Pro.

Necesito mucho volumen. ¿Hay algo a medida?

Sí, hay un plan a medida para sistemas con tráfico sostenido. Escribinos a [email protected] contando qué consultás y cuántas consultas por día necesitás.

Preguntas frecuentes

¿Cómo obtengo la API key?

Entrás a argentinadata.mymcps.dev, iniciás sesión con Google y recibís la key al instante, sin tarjeta. La misma key sirve para el endpoint MCP y para la API REST. En Claude.ai y en ChatGPT no hace falta copiarla: la conexión se autoriza por OAuth con la misma cuenta.

¿Cuáles son los límites del plan Free?

20 consultas por día, 100 por semana y 300 por mes, con todas las tools stable. Las meta-tools (que_puedo_consultar, data_health, consultar_cuota y enviar_feedback) no descuentan cuota. El plan Pro cuesta ARS 1.300 por mes y suma el canal beta.

¿Qué diferencia hay entre el canal stable y el beta?

Toda key nueva arranca en stable y recibe solo las tools estables, con contrato de respuesta que no cambia sin aviso. El canal beta agrega las tools en beta (por ejemplo el comparador histórico y el resumen económico semanal) y viene con el plan Pro. Qué tools recibe cada canal en cada endpoint lo podés ver en /api/mcp/domains.

¿Hay un cliente para Python o JavaScript?

No hace falta uno propio: la API REST es HTTP estándar con Bearer token y la especificación OpenAPI en /api/docs sirve para generar un cliente o para llamar con requests, fetch o el cliente HTTP que uses. Para agentes, cualquier cliente MCP con transporte HTTP se conecta directo.

¿Es open source y puedo correrlo yo?

El código está en github.com/abenassi/argentina-data-mcp con las guías de instalación en docs/install-es.md. Podés leer cómo está armada cada tool, abrir un issue o mandar feedback desde el propio servidor con enviar_feedback.