indec-mcp 0.5.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. indec_mcp-0.5.0/.gitignore +11 -0
  2. indec_mcp-0.5.0/LICENSE +28 -0
  3. indec_mcp-0.5.0/PKG-INFO +265 -0
  4. indec_mcp-0.5.0/PRIVACY.md +53 -0
  5. indec_mcp-0.5.0/README.md +236 -0
  6. indec_mcp-0.5.0/pyproject.toml +59 -0
  7. indec_mcp-0.5.0/spec/indec-openapi.json +1 -0
  8. indec_mcp-0.5.0/src/indec_mcp/__init__.py +1 -0
  9. indec_mcp-0.5.0/src/indec_mcp/catalog.py +83 -0
  10. indec_mcp-0.5.0/src/indec_mcp/client.py +120 -0
  11. indec_mcp-0.5.0/src/indec_mcp/hosted.py +273 -0
  12. indec_mcp-0.5.0/src/indec_mcp/indices.py +260 -0
  13. indec_mcp-0.5.0/src/indec_mcp/living.py +195 -0
  14. indec_mcp-0.5.0/src/indec_mcp/mirror.py +775 -0
  15. indec_mcp-0.5.0/src/indec_mcp/paths.py +34 -0
  16. indec_mcp-0.5.0/src/indec_mcp/provider_ranges/openai-chatgpt-connectors.json +1 -0
  17. indec_mcp-0.5.0/src/indec_mcp/providers.py +112 -0
  18. indec_mcp-0.5.0/src/indec_mcp/ratelimit.py +182 -0
  19. indec_mcp-0.5.0/src/indec_mcp/scheduler.py +84 -0
  20. indec_mcp-0.5.0/src/indec_mcp/server.py +567 -0
  21. indec_mcp-0.5.0/src/indec_mcp/snapshot.py +213 -0
  22. indec_mcp-0.5.0/src/indec_mcp/stats_cli.py +82 -0
  23. indec_mcp-0.5.0/src/indec_mcp/sync.py +323 -0
  24. indec_mcp-0.5.0/src/indec_mcp/topics.py +314 -0
  25. indec_mcp-0.5.0/src/indec_mcp/usage.py +353 -0
  26. indec_mcp-0.5.0/tests/__init__.py +0 -0
  27. indec_mcp-0.5.0/tests/conftest.py +79 -0
  28. indec_mcp-0.5.0/tests/fixture_db.py +261 -0
  29. indec_mcp-0.5.0/tests/test_catalog.py +26 -0
  30. indec_mcp-0.5.0/tests/test_hosted.py +99 -0
  31. indec_mcp-0.5.0/tests/test_indices.py +93 -0
  32. indec_mcp-0.5.0/tests/test_living.py +84 -0
  33. indec_mcp-0.5.0/tests/test_mirror.py +265 -0
  34. indec_mcp-0.5.0/tests/test_providers_cache.py +170 -0
  35. indec_mcp-0.5.0/tests/test_ratelimit.py +87 -0
  36. indec_mcp-0.5.0/tests/test_scheduler.py +40 -0
  37. indec_mcp-0.5.0/tests/test_server.py +77 -0
  38. indec_mcp-0.5.0/tests/test_snapshot.py +131 -0
  39. indec_mcp-0.5.0/tests/test_stdio_e2e.py +36 -0
  40. indec_mcp-0.5.0/tests/test_sync.py +124 -0
  41. indec_mcp-0.5.0/tests/test_topics.py +108 -0
  42. indec_mcp-0.5.0/tests/test_usage.py +136 -0
indec_mcp-0.5.0/.gitignore ADDED
@@ -0,0 +1,11 @@
1
+ .env
2
+ *.duckdb
3
+ *.duckdb.wal
4
+ data/
5
+ __pycache__/
6
+ node_modules/
7
+ .venv/
8
+ *.egg-info/
9
+ .pytest_cache/
10
+ *.duckdb.tmp
11
+ dist/
indec_mcp-0.5.0/LICENSE ADDED
@@ -0,0 +1,28 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 MagcDEV
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
22
+
23
+ ---
24
+
25
+ The data served by this software belongs to INDEC (Instituto Nacional de
26
+ Estadística y Censos, Argentina) and is subject to INDEC's terms of use:
27
+ https://api.indec.gob.ar/ayuda/terminos. This project is not affiliated with
28
+ or endorsed by INDEC.
indec_mcp-0.5.0/PKG-INFO ADDED
@@ -0,0 +1,265 @@
1
+ Metadata-Version: 2.5
2
+ Name: indec-mcp
3
+ Version: 0.5.0
4
+ Summary: MCP server for Argentina's official statistics (INDEC): inflation, wages, poverty, trade, population. Unofficial.
5
+ Project-URL: Homepage, https://github.com/MagcDEV/indec-mcp
6
+ Project-URL: Documentation, https://github.com/MagcDEV/indec-mcp/blob/main/docs/development.md
7
+ Project-URL: Issues, https://github.com/MagcDEV/indec-mcp/issues
8
+ Project-URL: Hosted server, https://indec-mcp-production.up.railway.app/mcp
9
+ Author: MagcDEV
10
+ License-Expression: MIT
11
+ License-File: LICENSE
12
+ Keywords: argentina,duckdb,indec,inflation,mcp,model-context-protocol,statistics
13
+ Classifier: Development Status :: 4 - Beta
14
+ Classifier: Intended Audience :: Developers
15
+ Classifier: Intended Audience :: Science/Research
16
+ Classifier: Natural Language :: Spanish
17
+ Classifier: Operating System :: OS Independent
18
+ Classifier: Programming Language :: Python :: 3
19
+ Classifier: Programming Language :: Python :: 3.12
20
+ Classifier: Programming Language :: Python :: 3.13
21
+ Classifier: Topic :: Scientific/Engineering :: Information Analysis
22
+ Requires-Python: >=3.12
23
+ Requires-Dist: duckdb>=1.1
24
+ Requires-Dist: httpx>=0.27
25
+ Requires-Dist: mcp<3,>=2.3
26
+ Provides-Extra: dev
27
+ Requires-Dist: pytest>=8; extra == 'dev'
28
+ Description-Content-Type: text/markdown
29
+
30
+ <img src="https://raw.githubusercontent.com/MagcDEV/indec-mcp/main/docs/img/icon.png" alt="" width="72" align="right">
31
+
32
+ # INDEC en tu asistente de IA
33
+
34
+ <!-- mcp-name: io.github.MagcDEV/indec-mcp -->
35
+
36
+ **Preguntale a Claude, ChatGPT o Cursor por la inflación, los salarios, la pobreza, las exportaciones o la población de Argentina, y te responde con los datos oficiales del INDEC.**
37
+ Sin registrarte, sin token y sin instalar nada: pegás una URL y listo.
38
+
39
+ ![Demo: se agrega el servidor y se pregunta cuánto se exportó a China](https://raw.githubusercontent.com/MagcDEV/indec-mcp/main/docs/img/demo.gif)
40
+
41
+ > Servicio **no oficial**, no afiliado al INDEC. Los datos son del INDEC (Catálogo API-INDEC). Fuente: INDEC.
42
+
43
+ ---
44
+
45
+ ## Empezá en 1 minuto
46
+
47
+ ![Tres pasos: copiar la URL, agregarla como conector, preguntar](https://raw.githubusercontent.com/MagcDEV/indec-mcp/main/docs/img/conectar.png)
48
+
49
+ Esta es la única URL que necesitás:
50
+
51
+ ```
52
+ https://indec-mcp-production.up.railway.app/mcp
53
+ ```
54
+
55
+ Elegí tu aplicación:
56
+
57
+ <details open>
58
+ <summary><b>Claude Code</b> (terminal)</summary>
59
+
60
+ ```bash
61
+ claude mcp add --transport http indec https://indec-mcp-production.up.railway.app/mcp
62
+ ```
63
+
64
+ Agregá `--scope user` para tenerlo en todos tus proyectos. Después abrí `claude` y preguntá.
65
+ </details>
66
+
67
+ <details>
68
+ <summary><b>Claude</b> (claude.ai o la app de escritorio)</summary>
69
+
70
+ 1. Andá a **Configuración → Conectores** y elegí **Agregar conector personalizado**.
71
+ 2. Nombre: `INDEC`. URL: `https://indec-mcp-production.up.railway.app/mcp`. No requiere autenticación.
72
+ 3. En un chat nuevo, activá el conector **INDEC** y preguntá.
73
+
74
+ *Los conectores personalizados pueden depender de tu plan.*
75
+ </details>
76
+
77
+ <details>
78
+ <summary><b>ChatGPT</b></summary>
79
+
80
+ Con el **modo desarrollador** activado, creá un conector o app nueva de tipo servidor MCP con la URL `https://indec-mcp-production.up.railway.app/mcp`, sin autenticación. Después activalo en el chat.
81
+
82
+ *La disponibilidad depende de tu plan y del menú de ChatGPT, que cambia seguido.*
83
+ </details>
84
+
85
+ <details>
86
+ <summary><b>Cursor</b></summary>
87
+
88
+ En `~/.cursor/mcp.json` (para todos tus proyectos) o en `.cursor/mcp.json` (solo uno):
89
+
90
+ ```json
91
+ {
92
+ "mcpServers": {
93
+ "indec": { "url": "https://indec-mcp-production.up.railway.app/mcp" }
94
+ }
95
+ }
96
+ ```
97
+ </details>
98
+
99
+ <details>
100
+ <summary><b>VS Code</b> (GitHub Copilot)</summary>
101
+
102
+ En `.vscode/mcp.json`:
103
+
104
+ ```json
105
+ {
106
+ "servers": {
107
+ "indec": { "type": "http", "url": "https://indec-mcp-production.up.railway.app/mcp" }
108
+ }
109
+ }
110
+ ```
111
+ </details>
112
+
113
+ <details>
114
+ <summary><b>Otra aplicación</b></summary>
115
+
116
+ Sirve cualquier cliente MCP que acepte servidores remotos por **Streamable HTTP**: usá la URL de arriba, sin autenticación.
117
+ </details>
118
+
119
+ <details>
120
+ <summary><b>En tu computadora</b> (sin depender del servidor)</summary>
121
+
122
+ Si preferís que las consultas corran en tu máquina, instalá [uv](https://docs.astral.sh/uv/) y usá el paquete [`indec-mcp`](https://pypi.org/project/indec-mcp/). Tampoco necesitás token:
123
+
124
+ ```bash
125
+ claude mcp add indec -- uvx indec-mcp
126
+ ```
127
+
128
+ En Claude Desktop, Cursor u otra aplicación:
129
+
130
+ ```json
131
+ {
132
+ "mcpServers": {
133
+ "indec": { "command": "uvx", "args": ["indec-mcp"] }
134
+ }
135
+ }
136
+ ```
137
+
138
+ La primera vez descarga una copia de los datos (unos 12 MB) y después la actualiza sola, cada 6 horas como máximo. Las consultas se hacen en tu computadora. ¿Tenés tu propio token del INDEC y querés descargar todo directamente de la API? Mirá [docs/development.md](https://github.com/MagcDEV/indec-mcp/blob/main/docs/development.md#run-it-locally).
139
+ </details>
140
+
141
+ ---
142
+
143
+ ## Qué le podés preguntar
144
+
145
+ | Tema | Por ejemplo |
146
+ |---|---|
147
+ | **Inflación** | "¿Cuánto fue la inflación del último mes? ¿Y la núcleo?" · "¿Cómo viene alimentos en el NOA comparado con GBA?" |
148
+ | **Salarios** | "¿Los salarios le ganaron a la inflación desde enero de 2024?" · "¿Y los del sector público?" |
149
+ | **Canasta básica y crianza** | "¿Cuánto necesita una familia tipo para no ser pobre?" · "¿Cuánto cuesta criar a un chico de 2 años?" |
150
+ | **Pobreza y empleo** | "¿Cómo evolucionó la pobreza desde 2016?" · "¿Cuál es la desocupación hoy?" |
151
+ | **Actividad e industria** | "¿Está creciendo la economía según el EMAE?" · "¿Cómo viene la producción industrial? ¿Y la automotriz?" · "¿Cuánto creció la producción de petróleo?" |
152
+ | **Precios mayoristas y construcción** | "¿Cuánto subieron los precios mayoristas este año?" · "¿Le ganó el costo de la mano de obra en la construcción a los salarios?" |
153
+ | **Comercio exterior** | "¿Cuánto le exportamos a China en 2025 y qué productos?" · "¿Cuánto importamos en bienes de capital por año?" |
154
+ | **Población** | "¿Cuánta gente vive en Córdoba?" · "¿Cuál es el departamento más poblado de Mendoza?" |
155
+ | **Lo que quieras** | Redeterminación de obras públicas, cruces entre datasets y más: el asistente puede consultar los 19 datasets con SQL |
156
+
157
+ En los clientes que muestran *prompts* MCP también tenés atajos listos: **informe de inflación**, **panorama económico**, **evolución de la pobreza**, **comercio con un país** y **salario real**.
158
+
159
+ ## Ejemplos reales
160
+
161
+ Respuestas sin editar, generadas con Claude Code conectado a este servidor ([transcripciones](https://github.com/MagcDEV/indec-mcp/blob/main/docs/img/demos.json)):
162
+
163
+ ![Salarios vs. inflación desde 2024](https://raw.githubusercontent.com/MagcDEV/indec-mcp/main/docs/img/demo-1.png)
164
+
165
+ <details>
166
+ <summary>Más ejemplos: exportaciones a China · población e inflación de Córdoba</summary>
167
+
168
+ ![Exportaciones a China en 2025](https://raw.githubusercontent.com/MagcDEV/indec-mcp/main/docs/img/demo-2.png)
169
+
170
+ ![Población de Córdoba e inflación regional](https://raw.githubusercontent.com/MagcDEV/indec-mcp/main/docs/img/demo-3.png)
171
+ </details>
172
+
173
+ ---
174
+
175
+ ## Por qué usar este servidor
176
+
177
+ - **Es el más simple de usar.** Una URL y listo: no hace falta registrarse en el INDEC, pedir ni renovar un token, ni instalar Node o Python.
178
+ - **Responde con cuidado.** Le indica al asistente que cite "Fuente: INDEC" con el período de cada cifra, que avise cuando un dato es provisorio y que use las variaciones que publica el INDEC en lugar de calcularlas. Si el asistente calcula algo (por ejemplo, el salario real), tiene que decirlo.
179
+ - **No esconde los huecos.** En comercio exterior, parte de las filas de detalle son confidenciales por secreto estadístico (en los meses recientes, cerca de la mitad). El servidor informa siempre cuántas son, así el asistente no presenta una suma parcial como si fuera el total.
180
+ - **Es rápido y estable.** Trabaja sobre una copia de todos los datos que se actualiza cada día, así que no depende de que la API del INDEC (todavía en beta) esté funcionando en ese momento.
181
+ - **Cuida al INDEC.** Haya los usuarios que haya, la API del INDEC recibe solo unas 2.000 consultas por día, las de la actualización diaria.
182
+ - **Es código abierto** ([MIT](https://github.com/MagcDEV/indec-mcp/blob/main/LICENSE)), y podés correrlo vos mismo ([docs/development.md](https://github.com/MagcDEV/indec-mcp/blob/main/docs/development.md)).
183
+
184
+ ### Otras opciones
185
+
186
+ | | Este servidor | [indec-mcp de SantinoSpingola](https://github.com/SantinoSpingola/indec-mcp) | [OpenArg](https://openarg.org/) |
187
+ |---|---|---|---|
188
+ | Cómo se usa | Pegás una URL, o `uvx indec-mcp` en tu computadora | Se instala en tu computadora (Node) | Chat web, API y MCP |
189
+ | Registro o token | **No hace falta** | Token propio del INDEC | Clave de OpenArg |
190
+ | Uso gratis | 2.000 consultas por día | Lo que permita el INDEC | 200 consultas y 10 preguntas por mes |
191
+ | Cobertura | INDEC, en profundidad | INDEC, en profundidad | Más de 33.000 datasets de 38 portales públicos |
192
+
193
+ Si querés datos de muchos organismos además del INDEC, OpenArg cubre más fuentes. Si preferís consultar la API del INDEC en vivo con tu propio token, el proyecto de Santino es muy completo. Este servidor apunta a que cualquiera pueda preguntar sobre el INDEC sin ningún paso previo.
194
+
195
+ ---
196
+
197
+ ## Datos incluidos
198
+
199
+ Los **19 servicios de datos** del [Catálogo API-INDEC](https://api.indec.gob.ar), unos 2 millones de filas, actualizados todos los días a las 19:00 (hora de Argentina). El INDEC publica sus informes a las 16:00.
200
+
201
+ - **Precios:** IPC por región y categoría (desde dic-2016), canastas básicas CBA y CBT (desde abr-2016), precios mayoristas, costo de la construcción y redeterminación de obras públicas
202
+ - **Salarios:** índice de salarios por sector
203
+ - **Actividad:** EMAE (general y por sectores) e índice de producción industrial manufacturera y minera
204
+ - **Condiciones de vida:** pobreza e indigencia (semestral), mercado de trabajo (trimestral) y canasta de crianza
205
+ - **Comercio exterior:** exportaciones (desde 1986) e importaciones, por país y categoría
206
+ - **Población:** proyecciones 2022–2040 por provincia, sexo y edad, y estimaciones por departamento 2022–2035 (base Censo 2022)
207
+
208
+ Estado y fecha de la última actualización: <https://indec-mcp-production.up.railway.app/healthz>
209
+
210
+ ## Límites de uso
211
+
212
+ Para que el servicio siga siendo gratis y estable para todos, hay un límite por conexión:
213
+
214
+ - hasta **20 consultas seguidas**, después **30 por minuto**;
215
+ - hasta **2.000 por día**.
216
+
217
+ Una pregunta normal usa pocas consultas, entre 2 y 10. Si llegás al límite, el asistente recibe un aviso para esperar unos segundos.
218
+
219
+ ## Preguntas frecuentes
220
+
221
+ **¿Es oficial?** No. Es un proyecto independiente que usa la API pública del INDEC. Ante cualquier duda, la referencia es [indec.gob.ar](https://www.indec.gob.ar).
222
+
223
+ **¿Ven mis conversaciones?** No. El servidor solo recibe las consultas de datos que hace el asistente (por ejemplo, "IPC de Alimentos desde 2025"), no tu chat.
224
+
225
+ **¿Qué guarda el servidor?** Para saber cuánta gente lo usa, guarda **estadísticas anónimas durante 90 días**:
226
+ - un identificador cifrado de tu conexión (nunca la dirección IP);
227
+ - la app que usás (por ejemplo, "claude-code");
228
+ - qué herramienta se usó y el tema general de la consulta (por ejemplo, "IPC Núcleo@GBA" o "China").
229
+
230
+ Nunca guarda el texto de tus consultas SQL (solo los nombres de las tablas) ni tu conversación. La plataforma de hosting (Railway) puede tener sus propios registros de red. Tu conversación la procesa tu aplicación de IA (Claude, ChatGPT…) según sus propias políticas. Política completa: [PRIVACY.md](https://github.com/MagcDEV/indec-mcp/blob/main/PRIVACY.md).
231
+
232
+ **¿Cuesta algo?** El servidor es gratis. Lo que uses de tu asistente de IA depende de tu plan con ese servicio.
233
+
234
+ **¿Por qué una cifra no coincide exactamente con el informe del INDEC?** Puede pasar por redondeo cuando se calcula una variación, o porque en comercio exterior se excluyen los datos confidenciales. El asistente debería aclararlo en esos casos.
235
+
236
+ **¿Puedo instalarlo en mi propio servidor?** Sí: [docs/development.md](https://github.com/MagcDEV/indec-mcp/blob/main/docs/development.md) explica cómo correrlo y [docs/deploy.md](https://github.com/MagcDEV/indec-mcp/blob/main/docs/deploy.md) cómo publicarlo.
237
+
238
+ ## Para desarrolladores
239
+
240
+ - [docs/development.md](https://github.com/MagcDEV/indec-mcp/blob/main/docs/development.md): arquitectura, herramientas MCP, cómo correrlo localmente y tests
241
+ - [docs/deploy.md](https://github.com/MagcDEV/indec-mcp/blob/main/docs/deploy.md): despliegue, configuración, protección contra abuso y operación
242
+ - [docs/api-research.md](https://github.com/MagcDEV/indec-mcp/blob/main/docs/api-research.md): cómo funciona la API del INDEC, con mediciones reales
243
+ - [docs/datasets.md](https://github.com/MagcDEV/indec-mcp/blob/main/docs/datasets.md): los 19 datasets con sus columnas
244
+ - [docs/submissions.md](https://github.com/MagcDEV/indec-mcp/blob/main/docs/submissions.md): material para publicar en directorios de MCP
245
+ - [PRIVACY.md](https://github.com/MagcDEV/indec-mcp/blob/main/PRIVACY.md): política de privacidad
246
+
247
+ ## Créditos
248
+
249
+ - **Datos:** [INDEC](https://www.indec.gob.ar), mediante el [Catálogo API-INDEC](https://api.indec.gob.ar).
250
+ - **Ideas:** varias funciones (buscar códigos de comercio exterior por nombre, informar los datos confidenciales, herramientas dedicadas por tema (precios mayoristas, construcción, industria, salarios, actividad, canastas, pobreza y empleo), los *prompts* y la guía de signos convencionales) están inspiradas en [SantinoSpingola/indec-mcp](https://github.com/SantinoSpingola/indec-mcp) (MIT). Se reimplementaron en Python, sin copiar su código.
251
+ - **Licencia:** [MIT](https://github.com/MagcDEV/indec-mcp/blob/main/LICENSE).
252
+
253
+ ---
254
+
255
+ ## English
256
+
257
+ **Ask Claude, ChatGPT or Cursor about Argentina's official statistics (INDEC): inflation, wages, poverty, trade and population.** There's no signup, no API token and nothing to install. Add this remote MCP server (Streamable HTTP, no auth):
258
+
259
+ ```
260
+ https://indec-mcp-production.up.railway.app/mcp
261
+ ```
262
+
263
+ To run it on your own machine instead, use `uvx indec-mcp` (stdio). It downloads a ~12 MB copy of the data on first start and keeps it fresh, still with no token.
264
+
265
+ The server holds a daily copy of all 19 datasets in INDEC's new API. It offers 17 read-only tools: headline indicators; one tool per topic (CPI, wages, basic and child-raising baskets, poverty, labor market, EMAE by sector, wholesale prices, construction costs, industrial production, foreign trade with name lookup, population); series comparison such as real wages; and sandboxed SQL. It also has 5 prompts and resources. Answers cite INDEC with the period of each figure and flag provisional or confidential data. Limits are 20 requests in a burst, 30 per minute and 2,000 per day for each client. The project is unofficial and MIT-licensed. Technical documentation is in [docs/development.md](https://github.com/MagcDEV/indec-mcp/blob/main/docs/development.md).
indec_mcp-0.5.0/PRIVACY.md ADDED
@@ -0,0 +1,53 @@
1
+ # Política de privacidad · Privacy policy
2
+
3
+ *Vigente desde el 7 de noviembre de 2026 · Effective November 7, 2026*
4
+
5
+ Esta política cubre el servidor MCP público `https://indec-mcp-production.up.railway.app/mcp` («el servicio»). El servicio es un proyecto independiente y **no oficial**: no está afiliado al INDEC.
6
+
7
+ ## Español
8
+
9
+ **Qué datos recibe el servicio.** El servicio solo recibe las consultas de datos que tu asistente de IA le envía, por ejemplo: «inflación de Alimentos desde 2025» o «exportaciones a China en 2025». No recibe tu conversación, tu nombre ni tu cuenta. No requiere registro ni inicio de sesión.
10
+
11
+ **Qué guardamos y para qué.** Para medir el uso del servicio, cuidar su estabilidad y prevenir abusos, guardamos un registro por cada pedido con:
12
+ - un **identificador seudónimo**: un hash HMAC-SHA256 de la dirección IP de la conexión, calculado con una clave secreta. **La dirección IP en sí no se guarda**;
13
+ - el nombre de la aplicación cliente que ella misma informa (por ejemplo, «claude-code»);
14
+ - la herramienta usada y un **tema general** derivado de sus parámetros estructurados (por ejemplo, «Núcleo@GBA» o «China»). **Nunca se guarda el texto de las consultas SQL** (solo los nombres de las tablas consultadas);
15
+ - la fecha y hora, si hubo error, el tiempo de respuesta y si el pedido llegó desde los servidores de un proveedor de IA (Anthropic u OpenAI), según sus rangos de IP publicados.
16
+
17
+ Para aplicar los límites de uso, el servicio mantiene en memoria contadores por conexión, que se pierden al reiniciarse. No usamos cookies ni rastreadores, y no creamos perfiles.
18
+
19
+ **Dónde se guarda.** En una base de datos del propio servicio, alojada en Railway (Railway Corporation, Estados Unidos). Railway puede llevar sus propios registros técnicos de red según [su política de privacidad](https://railway.com/legal/privacy).
20
+
21
+ **Con quién compartimos.** Con nadie. No vendemos, cedemos ni compartimos estos datos con terceros, salvo que la ley lo exija. Las estadísticas agregadas (por ejemplo, «X consultas sobre inflación este mes») pueden publicarse.
22
+
23
+ **Cuánto tiempo.** Los registros de uso se borran automáticamente a los **90 días**.
24
+
25
+ **Tu asistente de IA.** Tu conversación la procesa la aplicación que uses (Claude, ChatGPT, Cursor…), según sus propias políticas. Este servicio no tiene acceso a ella.
26
+
27
+ **Contacto.** Para consultas sobre privacidad, o para pedir que eliminemos datos, abrí un issue en <https://github.com/MagcDEV/indec-mcp/issues>. Como no guardamos direcciones IP ni datos de identidad, en general no podemos asociar registros a una persona en particular.
28
+
29
+ **Cambios.** Si esta política cambia, se actualizará este archivo, y su historial queda visible en GitHub.
30
+
31
+ ## English
32
+
33
+ **What the service receives.** The service only receives the data queries your AI assistant sends it, for example "Food inflation since 2025" or "exports to China in 2025". It never receives your conversation, name or account, and it needs no signup or login.
34
+
35
+ **What we store and why.** To measure usage, keep the service stable and prevent abuse, we store one record per request with:
36
+ - a **pseudonymous ID**: an HMAC-SHA256 of the connection's IP address, computed with a secret key. **The IP address itself is not stored**;
37
+ - the client application's self-reported name (for example "claude-code");
38
+ - the tool used and a **coarse topic** derived from its structured arguments (for example "Núcleo@GBA" or "China"). **SQL query text is never stored**, only the names of the tables it queried;
39
+ - the timestamp, whether the request failed, the latency, and whether the request came from an AI provider's servers (Anthropic or OpenAI), based on their published IP ranges.
40
+
41
+ To enforce usage limits, the service keeps per-connection counters in memory, which are lost when it restarts. There are no cookies or trackers, and no profiling.
42
+
43
+ **Where it's stored.** In the service's own database, hosted on Railway (Railway Corporation, United States). Railway may keep its own network logs under [its privacy policy](https://railway.com/legal/privacy).
44
+
45
+ **Sharing.** None. We don't sell, transfer or share this data with third parties, unless the law requires it. Aggregate statistics (for example "X inflation queries this month") may be published.
46
+
47
+ **Retention.** Usage records are deleted automatically after **90 days**.
48
+
49
+ **Your AI assistant.** Your conversation is processed by the app you use (Claude, ChatGPT, Cursor…) under its own policies. This service has no access to it.
50
+
51
+ **Contact.** For privacy questions or deletion requests, open an issue at <https://github.com/MagcDEV/indec-mcp/issues>. Because we store no IP addresses or identity data, we generally can't link records to a specific person.
52
+
53
+ **Changes.** If this policy changes, this file is updated, and its history is visible on GitHub.
indec_mcp-0.5.0/README.md ADDED
@@ -0,0 +1,236 @@
1
+ <img src="https://raw.githubusercontent.com/MagcDEV/indec-mcp/main/docs/img/icon.png" alt="" width="72" align="right">
2
+
3
+ # INDEC en tu asistente de IA
4
+
5
+ <!-- mcp-name: io.github.MagcDEV/indec-mcp -->
6
+
7
+ **Preguntale a Claude, ChatGPT o Cursor por la inflación, los salarios, la pobreza, las exportaciones o la población de Argentina, y te responde con los datos oficiales del INDEC.**
8
+ Sin registrarte, sin token y sin instalar nada: pegás una URL y listo.
9
+
10
+ ![Demo: se agrega el servidor y se pregunta cuánto se exportó a China](https://raw.githubusercontent.com/MagcDEV/indec-mcp/main/docs/img/demo.gif)
11
+
12
+ > Servicio **no oficial**, no afiliado al INDEC. Los datos son del INDEC (Catálogo API-INDEC). Fuente: INDEC.
13
+
14
+ ---
15
+
16
+ ## Empezá en 1 minuto
17
+
18
+ ![Tres pasos: copiar la URL, agregarla como conector, preguntar](https://raw.githubusercontent.com/MagcDEV/indec-mcp/main/docs/img/conectar.png)
19
+
20
+ Esta es la única URL que necesitás:
21
+
22
+ ```
23
+ https://indec-mcp-production.up.railway.app/mcp
24
+ ```
25
+
26
+ Elegí tu aplicación:
27
+
28
+ <details open>
29
+ <summary><b>Claude Code</b> (terminal)</summary>
30
+
31
+ ```bash
32
+ claude mcp add --transport http indec https://indec-mcp-production.up.railway.app/mcp
33
+ ```
34
+
35
+ Agregá `--scope user` para tenerlo en todos tus proyectos. Después abrí `claude` y preguntá.
36
+ </details>
37
+
38
+ <details>
39
+ <summary><b>Claude</b> (claude.ai o la app de escritorio)</summary>
40
+
41
+ 1. Andá a **Configuración → Conectores** y elegí **Agregar conector personalizado**.
42
+ 2. Nombre: `INDEC`. URL: `https://indec-mcp-production.up.railway.app/mcp`. No requiere autenticación.
43
+ 3. En un chat nuevo, activá el conector **INDEC** y preguntá.
44
+
45
+ *Los conectores personalizados pueden depender de tu plan.*
46
+ </details>
47
+
48
+ <details>
49
+ <summary><b>ChatGPT</b></summary>
50
+
51
+ Con el **modo desarrollador** activado, creá un conector o app nueva de tipo servidor MCP con la URL `https://indec-mcp-production.up.railway.app/mcp`, sin autenticación. Después activalo en el chat.
52
+
53
+ *La disponibilidad depende de tu plan y del menú de ChatGPT, que cambia seguido.*
54
+ </details>
55
+
56
+ <details>
57
+ <summary><b>Cursor</b></summary>
58
+
59
+ En `~/.cursor/mcp.json` (para todos tus proyectos) o en `.cursor/mcp.json` (solo uno):
60
+
61
+ ```json
62
+ {
63
+ "mcpServers": {
64
+ "indec": { "url": "https://indec-mcp-production.up.railway.app/mcp" }
65
+ }
66
+ }
67
+ ```
68
+ </details>
69
+
70
+ <details>
71
+ <summary><b>VS Code</b> (GitHub Copilot)</summary>
72
+
73
+ En `.vscode/mcp.json`:
74
+
75
+ ```json
76
+ {
77
+ "servers": {
78
+ "indec": { "type": "http", "url": "https://indec-mcp-production.up.railway.app/mcp" }
79
+ }
80
+ }
81
+ ```
82
+ </details>
83
+
84
+ <details>
85
+ <summary><b>Otra aplicación</b></summary>
86
+
87
+ Sirve cualquier cliente MCP que acepte servidores remotos por **Streamable HTTP**: usá la URL de arriba, sin autenticación.
88
+ </details>
89
+
90
+ <details>
91
+ <summary><b>En tu computadora</b> (sin depender del servidor)</summary>
92
+
93
+ Si preferís que las consultas corran en tu máquina, instalá [uv](https://docs.astral.sh/uv/) y usá el paquete [`indec-mcp`](https://pypi.org/project/indec-mcp/). Tampoco necesitás token:
94
+
95
+ ```bash
96
+ claude mcp add indec -- uvx indec-mcp
97
+ ```
98
+
99
+ En Claude Desktop, Cursor u otra aplicación:
100
+
101
+ ```json
102
+ {
103
+ "mcpServers": {
104
+ "indec": { "command": "uvx", "args": ["indec-mcp"] }
105
+ }
106
+ }
107
+ ```
108
+
109
+ La primera vez descarga una copia de los datos (unos 12 MB) y después la actualiza sola, cada 6 horas como máximo. Las consultas se hacen en tu computadora. ¿Tenés tu propio token del INDEC y querés descargar todo directamente de la API? Mirá [docs/development.md](https://github.com/MagcDEV/indec-mcp/blob/main/docs/development.md#run-it-locally).
110
+ </details>
111
+
112
+ ---
113
+
114
+ ## Qué le podés preguntar
115
+
116
+ | Tema | Por ejemplo |
117
+ |---|---|
118
+ | **Inflación** | "¿Cuánto fue la inflación del último mes? ¿Y la núcleo?" · "¿Cómo viene alimentos en el NOA comparado con GBA?" |
119
+ | **Salarios** | "¿Los salarios le ganaron a la inflación desde enero de 2024?" · "¿Y los del sector público?" |
120
+ | **Canasta básica y crianza** | "¿Cuánto necesita una familia tipo para no ser pobre?" · "¿Cuánto cuesta criar a un chico de 2 años?" |
121
+ | **Pobreza y empleo** | "¿Cómo evolucionó la pobreza desde 2016?" · "¿Cuál es la desocupación hoy?" |
122
+ | **Actividad e industria** | "¿Está creciendo la economía según el EMAE?" · "¿Cómo viene la producción industrial? ¿Y la automotriz?" · "¿Cuánto creció la producción de petróleo?" |
123
+ | **Precios mayoristas y construcción** | "¿Cuánto subieron los precios mayoristas este año?" · "¿Le ganó el costo de la mano de obra en la construcción a los salarios?" |
124
+ | **Comercio exterior** | "¿Cuánto le exportamos a China en 2025 y qué productos?" · "¿Cuánto importamos en bienes de capital por año?" |
125
+ | **Población** | "¿Cuánta gente vive en Córdoba?" · "¿Cuál es el departamento más poblado de Mendoza?" |
126
+ | **Lo que quieras** | Redeterminación de obras públicas, cruces entre datasets y más: el asistente puede consultar los 19 datasets con SQL |
127
+
128
+ En los clientes que muestran *prompts* MCP también tenés atajos listos: **informe de inflación**, **panorama económico**, **evolución de la pobreza**, **comercio con un país** y **salario real**.
129
+
130
+ ## Ejemplos reales
131
+
132
+ Respuestas sin editar, generadas con Claude Code conectado a este servidor ([transcripciones](https://github.com/MagcDEV/indec-mcp/blob/main/docs/img/demos.json)):
133
+
134
+ ![Salarios vs. inflación desde 2024](https://raw.githubusercontent.com/MagcDEV/indec-mcp/main/docs/img/demo-1.png)
135
+
136
+ <details>
137
+ <summary>Más ejemplos: exportaciones a China · población e inflación de Córdoba</summary>
138
+
139
+ ![Exportaciones a China en 2025](https://raw.githubusercontent.com/MagcDEV/indec-mcp/main/docs/img/demo-2.png)
140
+
141
+ ![Población de Córdoba e inflación regional](https://raw.githubusercontent.com/MagcDEV/indec-mcp/main/docs/img/demo-3.png)
142
+ </details>
143
+
144
+ ---
145
+
146
+ ## Por qué usar este servidor
147
+
148
+ - **Es el más simple de usar.** Una URL y listo: no hace falta registrarse en el INDEC, pedir ni renovar un token, ni instalar Node o Python.
149
+ - **Responde con cuidado.** Le indica al asistente que cite "Fuente: INDEC" con el período de cada cifra, que avise cuando un dato es provisorio y que use las variaciones que publica el INDEC en lugar de calcularlas. Si el asistente calcula algo (por ejemplo, el salario real), tiene que decirlo.
150
+ - **No esconde los huecos.** En comercio exterior, parte de las filas de detalle son confidenciales por secreto estadístico (en los meses recientes, cerca de la mitad). El servidor informa siempre cuántas son, así el asistente no presenta una suma parcial como si fuera el total.
151
+ - **Es rápido y estable.** Trabaja sobre una copia de todos los datos que se actualiza cada día, así que no depende de que la API del INDEC (todavía en beta) esté funcionando en ese momento.
152
+ - **Cuida al INDEC.** Haya los usuarios que haya, la API del INDEC recibe solo unas 2.000 consultas por día, las de la actualización diaria.
153
+ - **Es código abierto** ([MIT](https://github.com/MagcDEV/indec-mcp/blob/main/LICENSE)), y podés correrlo vos mismo ([docs/development.md](https://github.com/MagcDEV/indec-mcp/blob/main/docs/development.md)).
154
+
155
+ ### Otras opciones
156
+
157
+ | | Este servidor | [indec-mcp de SantinoSpingola](https://github.com/SantinoSpingola/indec-mcp) | [OpenArg](https://openarg.org/) |
158
+ |---|---|---|---|
159
+ | Cómo se usa | Pegás una URL, o `uvx indec-mcp` en tu computadora | Se instala en tu computadora (Node) | Chat web, API y MCP |
160
+ | Registro o token | **No hace falta** | Token propio del INDEC | Clave de OpenArg |
161
+ | Uso gratis | 2.000 consultas por día | Lo que permita el INDEC | 200 consultas y 10 preguntas por mes |
162
+ | Cobertura | INDEC, en profundidad | INDEC, en profundidad | Más de 33.000 datasets de 38 portales públicos |
163
+
164
+ Si querés datos de muchos organismos además del INDEC, OpenArg cubre más fuentes. Si preferís consultar la API del INDEC en vivo con tu propio token, el proyecto de Santino es muy completo. Este servidor apunta a que cualquiera pueda preguntar sobre el INDEC sin ningún paso previo.
165
+
166
+ ---
167
+
168
+ ## Datos incluidos
169
+
170
+ Los **19 servicios de datos** del [Catálogo API-INDEC](https://api.indec.gob.ar), unos 2 millones de filas, actualizados todos los días a las 19:00 (hora de Argentina). El INDEC publica sus informes a las 16:00.
171
+
172
+ - **Precios:** IPC por región y categoría (desde dic-2016), canastas básicas CBA y CBT (desde abr-2016), precios mayoristas, costo de la construcción y redeterminación de obras públicas
173
+ - **Salarios:** índice de salarios por sector
174
+ - **Actividad:** EMAE (general y por sectores) e índice de producción industrial manufacturera y minera
175
+ - **Condiciones de vida:** pobreza e indigencia (semestral), mercado de trabajo (trimestral) y canasta de crianza
176
+ - **Comercio exterior:** exportaciones (desde 1986) e importaciones, por país y categoría
177
+ - **Población:** proyecciones 2022–2040 por provincia, sexo y edad, y estimaciones por departamento 2022–2035 (base Censo 2022)
178
+
179
+ Estado y fecha de la última actualización: <https://indec-mcp-production.up.railway.app/healthz>
180
+
181
+ ## Límites de uso
182
+
183
+ Para que el servicio siga siendo gratis y estable para todos, hay un límite por conexión:
184
+
185
+ - hasta **20 consultas seguidas**, después **30 por minuto**;
186
+ - hasta **2.000 por día**.
187
+
188
+ Una pregunta normal usa pocas consultas, entre 2 y 10. Si llegás al límite, el asistente recibe un aviso para esperar unos segundos.
189
+
190
+ ## Preguntas frecuentes
191
+
192
+ **¿Es oficial?** No. Es un proyecto independiente que usa la API pública del INDEC. Ante cualquier duda, la referencia es [indec.gob.ar](https://www.indec.gob.ar).
193
+
194
+ **¿Ven mis conversaciones?** No. El servidor solo recibe las consultas de datos que hace el asistente (por ejemplo, "IPC de Alimentos desde 2025"), no tu chat.
195
+
196
+ **¿Qué guarda el servidor?** Para saber cuánta gente lo usa, guarda **estadísticas anónimas durante 90 días**:
197
+ - un identificador cifrado de tu conexión (nunca la dirección IP);
198
+ - la app que usás (por ejemplo, "claude-code");
199
+ - qué herramienta se usó y el tema general de la consulta (por ejemplo, "IPC Núcleo@GBA" o "China").
200
+
201
+ Nunca guarda el texto de tus consultas SQL (solo los nombres de las tablas) ni tu conversación. La plataforma de hosting (Railway) puede tener sus propios registros de red. Tu conversación la procesa tu aplicación de IA (Claude, ChatGPT…) según sus propias políticas. Política completa: [PRIVACY.md](https://github.com/MagcDEV/indec-mcp/blob/main/PRIVACY.md).
202
+
203
+ **¿Cuesta algo?** El servidor es gratis. Lo que uses de tu asistente de IA depende de tu plan con ese servicio.
204
+
205
+ **¿Por qué una cifra no coincide exactamente con el informe del INDEC?** Puede pasar por redondeo cuando se calcula una variación, o porque en comercio exterior se excluyen los datos confidenciales. El asistente debería aclararlo en esos casos.
206
+
207
+ **¿Puedo instalarlo en mi propio servidor?** Sí: [docs/development.md](https://github.com/MagcDEV/indec-mcp/blob/main/docs/development.md) explica cómo correrlo y [docs/deploy.md](https://github.com/MagcDEV/indec-mcp/blob/main/docs/deploy.md) cómo publicarlo.
208
+
209
+ ## Para desarrolladores
210
+
211
+ - [docs/development.md](https://github.com/MagcDEV/indec-mcp/blob/main/docs/development.md): arquitectura, herramientas MCP, cómo correrlo localmente y tests
212
+ - [docs/deploy.md](https://github.com/MagcDEV/indec-mcp/blob/main/docs/deploy.md): despliegue, configuración, protección contra abuso y operación
213
+ - [docs/api-research.md](https://github.com/MagcDEV/indec-mcp/blob/main/docs/api-research.md): cómo funciona la API del INDEC, con mediciones reales
214
+ - [docs/datasets.md](https://github.com/MagcDEV/indec-mcp/blob/main/docs/datasets.md): los 19 datasets con sus columnas
215
+ - [docs/submissions.md](https://github.com/MagcDEV/indec-mcp/blob/main/docs/submissions.md): material para publicar en directorios de MCP
216
+ - [PRIVACY.md](https://github.com/MagcDEV/indec-mcp/blob/main/PRIVACY.md): política de privacidad
217
+
218
+ ## Créditos
219
+
220
+ - **Datos:** [INDEC](https://www.indec.gob.ar), mediante el [Catálogo API-INDEC](https://api.indec.gob.ar).
221
+ - **Ideas:** varias funciones (buscar códigos de comercio exterior por nombre, informar los datos confidenciales, herramientas dedicadas por tema (precios mayoristas, construcción, industria, salarios, actividad, canastas, pobreza y empleo), los *prompts* y la guía de signos convencionales) están inspiradas en [SantinoSpingola/indec-mcp](https://github.com/SantinoSpingola/indec-mcp) (MIT). Se reimplementaron en Python, sin copiar su código.
222
+ - **Licencia:** [MIT](https://github.com/MagcDEV/indec-mcp/blob/main/LICENSE).
223
+
224
+ ---
225
+
226
+ ## English
227
+
228
+ **Ask Claude, ChatGPT or Cursor about Argentina's official statistics (INDEC): inflation, wages, poverty, trade and population.** There's no signup, no API token and nothing to install. Add this remote MCP server (Streamable HTTP, no auth):
229
+
230
+ ```
231
+ https://indec-mcp-production.up.railway.app/mcp
232
+ ```
233
+
234
+ To run it on your own machine instead, use `uvx indec-mcp` (stdio). It downloads a ~12 MB copy of the data on first start and keeps it fresh, still with no token.
235
+
236
+ The server holds a daily copy of all 19 datasets in INDEC's new API. It offers 17 read-only tools: headline indicators; one tool per topic (CPI, wages, basic and child-raising baskets, poverty, labor market, EMAE by sector, wholesale prices, construction costs, industrial production, foreign trade with name lookup, population); series comparison such as real wages; and sandboxed SQL. It also has 5 prompts and resources. Answers cite INDEC with the period of each figure and flag provisional or confidential data. Limits are 20 requests in a burst, 30 per minute and 2,000 per day for each client. The project is unofficial and MIT-licensed. Technical documentation is in [docs/development.md](https://github.com/MagcDEV/indec-mcp/blob/main/docs/development.md).