MCP server and REST API for Argentine data: connect Claude, ChatGPT or your app to dollar rates, series, the tax registry and prices

Plans and quota

Can I use the API or the MCP from my own backend?

Yes. Any server can call the REST API (https://argentinadata.mymcps.dev/api/v1) or connect to the MCP with the header Authorization: Bearer YOUR_API_KEY. You do not need Claude or ChatGPT, and there is no separate key type for backends: the same key works everywhere. There is a step-by-step guide with curl, Node and Python examples (in Spanish).

Do MCP and REST API calls share the same quota?

Yes. Each key has a single allowance, and MCP and REST calls add up in the same counter.

How many calls does each plan include?

The Free plan includes 20 calls per day, 100 per week and 300 per month, no card required. The Pro plan includes 100 per day, 500 per week and 1,500 per month. All three limits apply at once: reaching any of them pauses calls until it frees up.

Do the limits reset at midnight?

No, they are rolling windows. The daily limit counts calls from the last 24 hours, the weekly one the last 7 days and the monthly one the last 30 days. Each call stops counting on its own when it leaves the window. With consultar_cuota (or GET /api/v1/fiscal/cuota) you can see how much you used and how much is left.

Which calls do not use quota?

The discovery and status tools: que_puedo_consultar, data_health, consultar_cuota and enviar_feedback. For supermarket price queries, calls that return no data (for example, an EAN that does not exist) do not count either, nor do calls that fail because of an error on our side. Calls with a misspelled or invalid parameter do count. A barcode batch (eans, up to 50) counts as one call per 10 codes with data, rounded up.

What happens when the quota runs out?

The REST API answers 402 on every plan. The body includes your usage and a link to upgrade or top up credit, and the Retry-After header gives the seconds until the exhausted limit frees up (it is omitted when topping up credit is the only way out). Over MCP, the tool returns the notice as text. If you have prepaid credit, calls keep going through automatically. If not, wait for older calls to leave the window or move to a higher plan.

Is there a rate limit?

Yes, per API key: up to 5 requests per second sustained and up to 4 in parallel, on both the REST API and the MCP. The meta-tools (consultar_cuota, data_health, que_puedo_consultar and enviar_feedback) have more headroom and do not count toward the parallel cap, so you can check your quota while requests are in flight. If you go over, the API answers 429 with a Retry-After header (seconds) and a body with error rate_limited. A 429 uses no quota and no credit. Limits are applied per server, so with more than one server behind the balancer the effective cap can be higher; do not count on it as extra allowance.

How should I retry on errors?

On 429, wait the seconds in Retry-After and retry. On 5xx and network errors, retry with exponential backoff plus a little jitter, up to about 5 attempts. Do not retry other 4xx errors (400, 401, 404): the request is wrong or the key is missing. On 402, stop: the quota is used up, so wait for the reset (Retry-After) or top up credit. The backend guide (in Spanish) has a Python and a Node example.

Can I buy extra calls without changing plans?

Yes, with prepaid credit, which you top up with Mercado Pago from the plans page (argentinadata.mymcps.dev/upgrade). Credit is used only after your plan allowance runs out, never expires and deducts one call for each response with data or with an invalid parameter (a barcode batch deducts one per 10 codes with data). Calls without data and calls that fail because of an error on our side do not spend it.

How much does a product price history query cost?

One query per call to /sepa/historial (or to the historial_precios_sepa tool), no matter how many stores or days it returns. If the product has no history at that store, the response does not use quota. It is a beta feature, included in the Pro plan.

I need high volume. Is there a custom option?

Yes, there is a custom plan for systems with sustained traffic. Write to [email protected] and tell us what you query and how many calls per day you need.

Frequently asked questions

How do I get an API key?

Go to argentinadata.mymcps.dev, sign in with Google and you get the key instantly, no card required. The same key works for the MCP endpoint and for the REST API. In Claude.ai and ChatGPT you do not need to copy it: the connection is authorized via OAuth with the same account.

What are the Free plan limits?

20 queries per day, 100 per week and 300 per month, with all stable tools. The meta-tools (que_puedo_consultar, data_health, consultar_cuota and enviar_feedback) do not count against the quota. The Pro plan costs ARS 1,300 per month and adds the beta channel.

What is the difference between the stable and beta channels?

Every new key starts on stable and receives only the stable tools, whose response contract does not change without notice. The beta channel adds the tools in beta (for example the historical comparator and the weekly economic summary) and comes with the Pro plan. You can see which tools each channel gets on each endpoint at /api/mcp/domains.

Is there a Python or JavaScript client?

You do not need a dedicated one: the REST API is standard HTTP with a Bearer token, and the OpenAPI specification at /api/docs lets you generate a client or call it with requests, fetch or whatever HTTP client you use. For agents, any MCP client with HTTP transport connects directly.

Is it open source, and can I run it myself?

The code is at github.com/abenassi/argentina-data-mcp with the installation guide in docs/install.md. You can read how each tool is built, open an issue or send feedback from the server itself with enviar_feedback.