APOGEOAPI

@apogeoapi/mcp

Servidor MCP (Model Context Protocol) para ApogeoAPI — datos geográficos, tipos de cambio en vivo y geolocalización de IP para Claude Desktop, Cursor y cualquier asistente de IA compatible con MCP.

Qué hace

Este servidor expone los endpoints REST de ApogeoAPI como herramientas que los asistentes de IA pueden llamar directamente. Pregúntale a Claude "¿Cuál es la tasa USD actual para Argentina?" o "Geolocaliza la IP 8.8.8.8" y llamará automáticamente a la herramienta correcta.

Herramientas disponibles

Herramienta	Descripción	Plan requerido
get_country	Datos completos del país por código ISO2/ISO3 — nombre, capital, región, población, moneda, tasa USD en vivo, zonas horarias, código telefónico	Gratis
list_countries	Lista paginada de los más de 250 países	Gratis
search_countries	Buscar países por nombre parcial	Gratis
get_states	Todos los estados/provincias de un país	Basic+
get_cities	Todas las ciudades de un estado por ID numérico de estado	Basic+
get_currency_rate	Tasa de cambio USD en vivo para la moneda de un país (actualizada cada 4 horas)	Basic+
geolocate_ip	País, región, ciudad, coordenadas, zona horaria y membresía en la UE para cualquier IPv4/IPv6	Basic+
global_search	Búsqueda en países, estados y ciudades en una sola consulta	Gratis

Instalación

Claude Desktop

Agrega lo siguiente a tu claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "apogeoapi": {
      "command": "npx",
      "args": ["-y", "@apogeoapi/mcp"],
      "env": {
        "APOGEOAPI_KEY": "apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Reinicia Claude Desktop después de guardar el archivo. Las herramientas de ApogeoAPI aparecerán en la lista de herramientas de Claude.

Cursor

Agrega el mismo bloque en mcpServers en el archivo de configuración MCP de Cursor (~/.cursor/mcp.json).

Compilación manual

git clone https://github.com/APOGEOAPI/apogeoapi-mcp.git
cd apogeoapi-mcp
npm install
npm run build

Luego referencia el archivo compilado directamente:

{
  "mcpServers": {
    "apogeoapi": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"],
      "env": {
        "APOGEOAPI_KEY": "apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Cómo obtener una clave API

1. Crea una cuenta gratuita en app.apogeoapi.com
2. Ve a API Keys y genera una nueva clave
3. Pega la clave en la variable de entorno APOGEOAPI_KEY anterior

No se requiere tarjeta de crédito para el plan Gratis (1,000 solicitudes/mes).

Requisitos del plan

Característica	Gratis	Basic ($19/mes)	Starter ($29/mes)	Professional ($79/mes)
Países (lista, búsqueda, obtener)	Sí	Sí	Sí	Sí
Búsqueda global	Sí	Sí	Sí	Sí
Estados y ciudades	No	Sí	Sí	Sí
Tipos de cambio en vivo	No	Sí	Sí	Sí
Geolocalización de IP	No	Sí	Sí	Sí
Solicitudes mensuales	1,000	15,000	100,000	500,000

Mejora tu plan en app.apogeoapi.com/dashboard/billing.

Variables de entorno

Variable	Requerida	Descripción
APOGEOAPI_KEY	Sí	Tu clave API del panel de control
APOGEOAPI_BASE_URL	No	Sobrescribe la URL base de la API (predeterminada: https://api.apogeoapi.com)

Licencia

MIT