MCP Argentina Datos
# MCP Argentina Datos
Este proyecto es un servidor de [Model Context Protocol (MCP)](https://docs.modelcontext.io/) que utiliza la API de [Argentina Datos](https://argentinadatos.com/) para proveer herramientas que entregan información sobre Argentina.
## Instalación
Para instalar las dependencias, necesitás tener [pnpm](https://pnpm.io/installation) instalado. Luego, ejecutá:
```bash
pnpm install
```
## Uso
Para iniciar en modo desarrollo, ejecutá: (recomendado)
```bash
pnpm dev
```
Para iniciar el servidor, ejecutá:
```bash
pnpm start
```
Para inspeccionar el servidor, ejecutá:
```bash
npx -y @modelcontextprotocol/inspector npx -y tsx main.ts
```
## Herramientas Disponibles
- `get-feriados`: Devuelve los feriados del año actual.
- `get-feriados-timeframe`: Devuelve los feriados de un año específico. (Parámetro: `year`)
- `eventos-presidenciales`: Devuelve los eventos presidenciales.
- `dolares-historico`: Devuelve las cotizaciones de todas las casas de cambio.
- `dolares-por-casa`: Devuelve las cotizaciones del dólar de la casa de cambio especificada. (Parámetro: `casa`)
- `dolares-por-casa-fecha`: Devuelve la cotización del dólar de una casa de cambio en una fecha específica. (Parámetros: `casa`, `fecha`)
- `senadores`: Devuelve los senadores.
- `senado-actas`: Devuelve las actas del senado.
- `senado-actas-por-anio`: Devuelve las actas del senado de un año específico. (Parámetro: `anio`)
- `diputados`: Devuelve los diputados.
- `diputados-actas`: Devuelve las actas de los diputados.
- `diputados-actas-por-anio`: Devuelve las actas de los diputados de un año específico. (Parámetro: `anio`)
- `salud`: Devuelve el estado de la salud de la API.
TDQS
Scored across 13 tools
Most tools have distinct purposes targeting different data domains (diputados, dólares, eventos, feriados, salud, senado), but there is some overlap between 'diputados-actas' and 'diputados-actas-por-anio' where the latter could be seen as a filtered version of the former. Similarly for 'senado-actas' and 'senado-actas-por-anio'. However, the descriptions clarify the differences, so confusion is minimal.
The naming is mixed with some patterns: most use snake_case, but there's inconsistency in verb usage (e.g., 'get-feriados' uses 'get' while others use 'devuelve' implicitly). Tools like 'dolares-por-casa' and 'dolares-por-casa-fecha' follow a logical structure, but overall, the conventions vary without a strict verb_noun pattern, making it readable but not highly consistent.
With 13 tools, the count is reasonable for a server covering multiple Argentine data domains (legislative, currency, events, holidays, health). It's slightly on the higher side but well-scoped, as each tool serves a specific query without obvious redundancy, fitting the broad purpose effectively.
The tool set covers key areas like legislative data (diputados, senado), currency rates (dólares), events, holidays, and API health, with good granularity (e.g., year-specific queries). Minor gaps exist, such as no update or delete operations, but this is typical for a read-only data API, and agents can work around this for querying purposes.