mcp-mexico 0.1.0__tar.gz

mcp_mexico-0.1.0/.env.example

@@ -0,0 +1,4 @@
+# Banxico SIE API token (free): https://www.banxico.org.mx/SieAPIRest/service/v1/token
+BANXICO_TOKEN=
+# INEGI Indicators API token (free): https://www.inegi.org.mx/app/desarrolladores/generatoken/Usuarios/token_Verify
+INEGI_TOKEN=

mcp_mexico-0.1.0/.gitignore

@@ -0,0 +1,231 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#   Usually these files are written by a python script from a template
+#   before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+*.lcov
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+# Pipfile.lock
+
+# uv
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+# uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+# poetry.lock
+# poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+# pdm.lock
+# pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+# pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi/*
+!.pixi/config.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule*
+celerybeat.pid
+
+# Redis
+*.rdb
+*.aof
+*.pid
+
+# RabbitMQ
+mnesia/
+rabbitmq/
+rabbitmq-data/
+
+# ActiveMQ
+activemq-data/
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#   JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#   be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#   and can be added to the global gitignore or merged into this file.  For a more nuclear
+#   option (not recommended) you can uncomment the following to ignore the entire idea folder.
+# .idea/
+
+# Abstra
+#   Abstra is an AI-powered process automation framework.
+#   Ignore directories containing user credentials, local state, and settings.
+#   Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#   Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore that
+#   can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#   and can be added to the global gitignore or merged into this file. However, if you prefer, you
+#   could uncomment the following to ignore the entire vscode folder
+# .vscode/
+# Temporary file for partial code execution
+tempCodeRunnerFile.py
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Streamlit
+.streamlit/secrets.toml
+
+# --- Workspace additions ---
+# macOS
+.DS_Store
+# Editors
+.vscode/
+.idea/
+# Secrets (commit .env.example only)
+.env
+.env.*
+!.env.example

mcp_mexico-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Diego Tepichin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mcp_mexico-0.1.0/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.5
+Name: mcp-mexico
+Version: 0.1.0
+Summary: MCP server that gives AI agents access to official Mexican public data: Banxico, INEGI, UMA and ISR tables.
+Project-URL: Homepage, https://github.com/DiegoTepichin/mcp-mexico
+Project-URL: Repository, https://github.com/DiegoTepichin/mcp-mexico
+Project-URL: Issues, https://github.com/DiegoTepichin/mcp-mexico/issues
+Author: Diego Tepichin
+License-Expression: MIT
+License-File: LICENSE
+Keywords: banxico,inegi,isr,mcp,mexico,model-context-protocol,sat,uma
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.28
+Requires-Dist: mcp<2.3,>=2.2
+Requires-Dist: pydantic>=2
+Description-Content-Type: text/markdown
+
+# mcp-mexico
+
+MCP server that gives AI agents official Mexican public data: Banxico exchange and interest rates, INEGI inflation, UMA values and ISR tax tables.
+
+[![CI](https://github.com/DiegoTepichin/mcp-mexico/actions/workflows/ci.yml/badge.svg)](https://github.com/DiegoTepichin/mcp-mexico/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+[Leer en español](README.es.md)
+
+![Claude Code answering questions about the FIX exchange rate, inflation and ISR with mcp-mexico](https://raw.githubusercontent.com/DiegoTepichin/mcp-mexico/main/docs/demo.gif)
+
+*Claude Code using `mcp-mexico`. Response wait times are cut from the recording.*
+
+## Why
+
+AI assistants either make up Mexican economic figures or use stale ones, so you end up looking them up by hand at Banxico, INEGI or the SAT and pasting them in. `mcp-mexico` lets any [MCP](https://modelcontextprotocol.io) client (Claude Desktop, Claude Code, Cursor) fetch them directly. Every result names its official source and the date it applies to.
+
+## Tools
+
+| Tool | What it returns | Source | Token |
+|---|---|---|---|
+| `get_fix_rate` | FIX USD/MXN exchange rate, latest or for a date. On weekends and holidays it returns the previous business day. | Banxico SIE | `BANXICO_TOKEN` |
+| `get_fix_rate_range` | Daily FIX between two dates (max 366 days). | Banxico SIE | `BANXICO_TOKEN` |
+| `get_interest_rate` | Banxico target rate, 28-day TIIE, overnight TIIE de Fondeo or 28-day CETES; latest or for a date. | Banxico SIE | `BANXICO_TOKEN` |
+| `get_interest_rate_range` | One of those rates between two dates (max 366 days). | Banxico SIE | `BANXICO_TOKEN` |
+| `get_inflation` | INPC index and monthly, annual and year-to-date inflation for a month (latest by default). | INEGI | `INEGI_TOKEN` |
+| `get_inflation_range` | The same for each month in a range (max 240 months). | INEGI | `INEGI_TOKEN` |
+| `get_uma` | UMA daily, monthly and annual values, 2020–2026, with validity dates. | INEGI | none |
+| `get_isr_table` | ISR tables for individuals, 2020–2026: monthly (LISR Art. 96) and annual (LISR Art. 152). | Anexo 8 of the RMF (SAT / DOF) | none |
+
+`get_uma` and `get_isr_table` work offline with no configuration. Their data ships inside the package; each table cites the document it was taken from and the date it was verified.
+
+## Get your tokens
+
+Both are free and take a couple of minutes.
+
+1. **Banxico**: open the [SIE API token page](https://www.banxico.org.mx/SieAPIRest/service/v1/token), solve the captcha and click "Generar token". The 64-character token appears on the page.
+2. **INEGI**: enter your email in the [INEGI token form](https://www.inegi.org.mx/app/desarrolladores/generatoken/Usuarios/token_Verify). The token arrives by email.
+
+You can start with only one token, or none: tools whose token is missing return a message explaining how to get it.
+
+## Install
+
+You need [uv](https://docs.astral.sh/uv/getting-started/installation/). The server runs with `uvx mcp-mexico`; you don't start it yourself, your MCP client does.
+
+### Claude Code
+
+```bash
+claude mcp add mcp-mexico -e BANXICO_TOKEN=your-token -e INEGI_TOKEN=your-token -- uvx mcp-mexico
+```
+
+### Claude Desktop
+
+Add this to `claude_desktop_config.json` (Settings → Developer → Edit Config) and restart Claude Desktop:
+
+```json
+{
+  "mcpServers": {
+    "mcp-mexico": {
+      "command": "uvx",
+      "args": ["mcp-mexico"],
+      "env": {
+        "BANXICO_TOKEN": "your-token",
+        "INEGI_TOKEN": "your-token"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Add the same `mcpServers` block to `~/.cursor/mcp.json`.
+
+## Try it
+
+Ask your assistant:
+
+- "What is today's FIX exchange rate?"
+- "What was annual inflation in Mexico in December 2024?"
+- "How much is 30 UMAs in pesos this year?"
+- "Using the 2026 monthly ISR table, how much tax is withheld on a 25,000 peso salary?"
+
+## Configuration
+
+| Variable | Required | Description |
+|---|---|---|
+| `BANXICO_TOKEN` | For Banxico tools | Banxico SIE API token. |
+| `INEGI_TOKEN` | For INEGI tools | INEGI Indicators API token. |
+
+Responses are cached in memory only: up to 1 hour for latest values, 24 hours for past Banxico ranges and 6 hours for the INPC series. Nothing is written to disk.
+
+## Development
+
+```bash
+uv sync
+uv run pytest
+uv run ruff check . && uv run ruff format --check . && uv run mypy .
+uv run mcp-mexico      # starts the server over stdio
+```
+
+Tests never touch the network: they replay responses recorded from the real APIs. See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Disclaimer
+
+This project is not affiliated with Banco de México, INEGI or the SAT. Figures come from their public sources, but check the cited source before relying on them for tax or legal decisions.
+
+## License
+
+[MIT](LICENSE) © Diego Tepichin

mcp_mexico-0.1.0/README.es.md

@@ -0,0 +1,110 @@
+# mcp-mexico
+
+Servidor MCP que da a los agentes de IA datos públicos oficiales de México: tipo de cambio y tasas de Banxico, inflación de INEGI, valores de la UMA y tablas de ISR.
+
+[![CI](https://github.com/DiegoTepichin/mcp-mexico/actions/workflows/ci.yml/badge.svg)](https://github.com/DiegoTepichin/mcp-mexico/actions/workflows/ci.yml)
+[![Licencia: MIT](https://img.shields.io/badge/Licencia-MIT-blue.svg)](LICENSE)
+
+[Read in English](README.md)
+
+![Claude Code respondiendo preguntas sobre el tipo de cambio FIX, la inflación y el ISR con mcp-mexico](https://raw.githubusercontent.com/DiegoTepichin/mcp-mexico/main/docs/demo.gif)
+
+*Claude Code usando `mcp-mexico`. La grabación recorta los tiempos de espera de las respuestas.*
+
+## Por qué
+
+Los asistentes de IA inventan las cifras económicas de México o usan datos viejos, así que terminas buscándolas a mano en Banxico, INEGI o el SAT para pegarlas en el chat. Con `mcp-mexico`, cualquier cliente [MCP](https://modelcontextprotocol.io) (Claude Desktop, Claude Code, Cursor) las consulta directamente. Cada resultado dice su fuente oficial y la fecha a la que corresponde.
+
+## Herramientas
+
+| Herramienta | Qué regresa | Fuente | Token |
+|---|---|---|---|
+| `get_fix_rate` | Tipo de cambio FIX USD/MXN, el más reciente o el de una fecha. En fines de semana y días festivos regresa el del día hábil anterior. | Banxico SIE | `BANXICO_TOKEN` |
+| `get_fix_rate_range` | FIX diario entre dos fechas (máximo 366 días). | Banxico SIE | `BANXICO_TOKEN` |
+| `get_interest_rate` | Tasa objetivo de Banxico, TIIE a 28 días, TIIE de Fondeo o CETES a 28 días; la más reciente o la de una fecha. | Banxico SIE | `BANXICO_TOKEN` |
+| `get_interest_rate_range` | Una de esas tasas entre dos fechas (máximo 366 días). | Banxico SIE | `BANXICO_TOKEN` |
+| `get_inflation` | INPC e inflación mensual, anual y acumulada en el año para un mes (por defecto, el último publicado). | INEGI | `INEGI_TOKEN` |
+| `get_inflation_range` | Lo mismo para cada mes de un rango (máximo 240 meses). | INEGI | `INEGI_TOKEN` |
+| `get_uma` | Valores diario, mensual y anual de la UMA, 2020–2026, con su vigencia. | INEGI | ninguno |
+| `get_isr_table` | Tablas de ISR para personas físicas, 2020–2026: mensual (art. 96 LISR) y anual (art. 152 LISR). | Anexo 8 de la RMF (SAT / DOF) | ninguno |
+
+`get_uma` y `get_isr_table` funcionan sin conexión y sin configurar nada. Sus datos vienen dentro del paquete; cada tabla cita el documento del que salió y la fecha en que se verificó.
+
+## Consigue tus tokens
+
+Los dos son gratuitos y se obtienen en un par de minutos.
+
+1. **Banxico**: abre la [página de token de la API del SIE](https://www.banxico.org.mx/SieAPIRest/service/v1/token), resuelve el captcha y da clic en "Generar token". El token de 64 caracteres aparece en la misma página.
+2. **INEGI**: escribe tu correo en el [formulario de token de INEGI](https://www.inegi.org.mx/app/desarrolladores/generatoken/Usuarios/token_Verify). El token llega por correo.
+
+Puedes empezar con un solo token, o con ninguno: las herramientas a las que les falta su token regresan un mensaje que explica cómo conseguirlo.
+
+## Instalación
+
+Necesitas [uv](https://docs.astral.sh/uv/getting-started/installation/). El servidor corre con `uvx mcp-mexico`; no lo arrancas tú, lo arranca tu cliente MCP.
+
+### Claude Code
+
+```bash
+claude mcp add mcp-mexico -e BANXICO_TOKEN=tu-token -e INEGI_TOKEN=tu-token -- uvx mcp-mexico
+```
+
+### Claude Desktop
+
+Agrega esto a `claude_desktop_config.json` (Settings → Developer → Edit Config) y reinicia Claude Desktop:
+
+```json
+{
+  "mcpServers": {
+    "mcp-mexico": {
+      "command": "uvx",
+      "args": ["mcp-mexico"],
+      "env": {
+        "BANXICO_TOKEN": "tu-token",
+        "INEGI_TOKEN": "tu-token"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Agrega el mismo bloque `mcpServers` a `~/.cursor/mcp.json`.
+
+## Pruébalo
+
+Pregúntale a tu asistente:
+
+- "¿Cuál es el tipo de cambio FIX de hoy?"
+- "¿Cuál fue la inflación anual de México en diciembre de 2024?"
+- "¿Cuánto son 30 UMAs en pesos este año?"
+- "Con la tabla mensual de ISR 2026, ¿cuánto se retiene a un sueldo de 25,000 pesos?"
+
+## Configuración
+
+| Variable | Obligatoria | Descripción |
+|---|---|---|
+| `BANXICO_TOKEN` | Para las herramientas de Banxico | Token de la API del SIE de Banxico. |
+| `INEGI_TOKEN` | Para las herramientas de INEGI | Token de la API de Indicadores de INEGI. |
+
+Las respuestas se guardan solo en memoria: hasta 1 hora los valores más recientes, 24 horas los rangos pasados de Banxico y 6 horas la serie del INPC. No se escribe nada en disco.
+
+## Desarrollo
+
+```bash
+uv sync
+uv run pytest
+uv run ruff check . && uv run ruff format --check . && uv run mypy .
+uv run mcp-mexico      # arranca el servidor por stdio
+```
+
+Los tests nunca tocan la red: reproducen respuestas grabadas de las APIs reales. Consulta [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Aviso
+
+Este proyecto no está afiliado al Banco de México, al INEGI ni al SAT. Las cifras vienen de sus fuentes públicas, pero revisa la fuente citada antes de usarlas para decisiones fiscales o legales.
+
+## Licencia
+
+[MIT](LICENSE) © Diego Tepichin

mcp_mexico-0.1.0/README.md

@@ -0,0 +1,110 @@
+# mcp-mexico
+
+MCP server that gives AI agents official Mexican public data: Banxico exchange and interest rates, INEGI inflation, UMA values and ISR tax tables.
+
+[![CI](https://github.com/DiegoTepichin/mcp-mexico/actions/workflows/ci.yml/badge.svg)](https://github.com/DiegoTepichin/mcp-mexico/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+[Leer en español](README.es.md)
+
+![Claude Code answering questions about the FIX exchange rate, inflation and ISR with mcp-mexico](https://raw.githubusercontent.com/DiegoTepichin/mcp-mexico/main/docs/demo.gif)
+
+*Claude Code using `mcp-mexico`. Response wait times are cut from the recording.*
+
+## Why
+
+AI assistants either make up Mexican economic figures or use stale ones, so you end up looking them up by hand at Banxico, INEGI or the SAT and pasting them in. `mcp-mexico` lets any [MCP](https://modelcontextprotocol.io) client (Claude Desktop, Claude Code, Cursor) fetch them directly. Every result names its official source and the date it applies to.
+
+## Tools
+
+| Tool | What it returns | Source | Token |
+|---|---|---|---|
+| `get_fix_rate` | FIX USD/MXN exchange rate, latest or for a date. On weekends and holidays it returns the previous business day. | Banxico SIE | `BANXICO_TOKEN` |
+| `get_fix_rate_range` | Daily FIX between two dates (max 366 days). | Banxico SIE | `BANXICO_TOKEN` |
+| `get_interest_rate` | Banxico target rate, 28-day TIIE, overnight TIIE de Fondeo or 28-day CETES; latest or for a date. | Banxico SIE | `BANXICO_TOKEN` |
+| `get_interest_rate_range` | One of those rates between two dates (max 366 days). | Banxico SIE | `BANXICO_TOKEN` |
+| `get_inflation` | INPC index and monthly, annual and year-to-date inflation for a month (latest by default). | INEGI | `INEGI_TOKEN` |
+| `get_inflation_range` | The same for each month in a range (max 240 months). | INEGI | `INEGI_TOKEN` |
+| `get_uma` | UMA daily, monthly and annual values, 2020–2026, with validity dates. | INEGI | none |
+| `get_isr_table` | ISR tables for individuals, 2020–2026: monthly (LISR Art. 96) and annual (LISR Art. 152). | Anexo 8 of the RMF (SAT / DOF) | none |
+
+`get_uma` and `get_isr_table` work offline with no configuration. Their data ships inside the package; each table cites the document it was taken from and the date it was verified.
+
+## Get your tokens
+
+Both are free and take a couple of minutes.
+
+1. **Banxico**: open the [SIE API token page](https://www.banxico.org.mx/SieAPIRest/service/v1/token), solve the captcha and click "Generar token". The 64-character token appears on the page.
+2. **INEGI**: enter your email in the [INEGI token form](https://www.inegi.org.mx/app/desarrolladores/generatoken/Usuarios/token_Verify). The token arrives by email.
+
+You can start with only one token, or none: tools whose token is missing return a message explaining how to get it.
+
+## Install
+
+You need [uv](https://docs.astral.sh/uv/getting-started/installation/). The server runs with `uvx mcp-mexico`; you don't start it yourself, your MCP client does.
+
+### Claude Code
+
+```bash
+claude mcp add mcp-mexico -e BANXICO_TOKEN=your-token -e INEGI_TOKEN=your-token -- uvx mcp-mexico
+```
+
+### Claude Desktop
+
+Add this to `claude_desktop_config.json` (Settings → Developer → Edit Config) and restart Claude Desktop:
+
+```json
+{
+  "mcpServers": {
+    "mcp-mexico": {
+      "command": "uvx",
+      "args": ["mcp-mexico"],
+      "env": {
+        "BANXICO_TOKEN": "your-token",
+        "INEGI_TOKEN": "your-token"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Add the same `mcpServers` block to `~/.cursor/mcp.json`.
+
+## Try it
+
+Ask your assistant:
+
+- "What is today's FIX exchange rate?"
+- "What was annual inflation in Mexico in December 2024?"
+- "How much is 30 UMAs in pesos this year?"
+- "Using the 2026 monthly ISR table, how much tax is withheld on a 25,000 peso salary?"
+
+## Configuration
+
+| Variable | Required | Description |
+|---|---|---|
+| `BANXICO_TOKEN` | For Banxico tools | Banxico SIE API token. |
+| `INEGI_TOKEN` | For INEGI tools | INEGI Indicators API token. |
+
+Responses are cached in memory only: up to 1 hour for latest values, 24 hours for past Banxico ranges and 6 hours for the INPC series. Nothing is written to disk.
+
+## Development
+
+```bash
+uv sync
+uv run pytest
+uv run ruff check . && uv run ruff format --check . && uv run mypy .
+uv run mcp-mexico      # starts the server over stdio
+```
+
+Tests never touch the network: they replay responses recorded from the real APIs. See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Disclaimer
+
+This project is not affiliated with Banco de México, INEGI or the SAT. Figures come from their public sources, but check the cited source before relying on them for tax or legal decisions.
+
+## License
+
+[MIT](LICENSE) © Diego Tepichin

mcp_mexico-0.1.0/pyproject.toml

@@ -0,0 +1,68 @@
+[project]
+name = "mcp-mexico"
+version = "0.1.0"
+description = "MCP server that gives AI agents access to official Mexican public data: Banxico, INEGI, UMA and ISR tables."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Diego Tepichin" }]
+requires-python = ">=3.11"
+keywords = ["mcp", "model-context-protocol", "mexico", "banxico", "inegi", "sat", "isr", "uma"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Financial and Insurance Industry",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Typing :: Typed",
+]
+dependencies = [
+    "httpx>=0.28",
+    "mcp>=2.2,<2.3",
+    "pydantic>=2",
+]
+
+[project.urls]
+Homepage = "https://github.com/DiegoTepichin/mcp-mexico"
+Repository = "https://github.com/DiegoTepichin/mcp-mexico"
+Issues = "https://github.com/DiegoTepichin/mcp-mexico/issues"
+
+[project.scripts]
+mcp-mexico = "mcp_mexico.server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.sdist]
+include = ["src", "tests", "scripts", "README.md", "README.es.md", "LICENSE", ".env.example"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "W", "F", "I", "B", "UP", "SIM", "RUF", "N", "PT", "ANN", "TC"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["ANN"]
+
+[tool.mypy]
+strict = true
+python_version = "3.11"
+files = ["src", "tests", "scripts"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-ra --strict-markers"
+
+[dependency-groups]
+dev = [
+    "anyio>=4.15.1",
+    "mypy>=2.4.0",
+    "pytest>=9.1.1",
+    "ruff>=0.16.10",
+]