Conectar IPinfo MCP con Gemini CLI: consultas IP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → IPinfo, instálalo sin clave, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

IPinfo + Gemini

Datos de direcciones IP de IPinfo: geolocalización, ASN y operador de la red, detección de VPN, proxy, Tor y proxies residenciales, empresa, operador móvil, contactos de abuso, dominios alojados, rangos de IP y WHOIS, de una en una o hasta 1.000 por lote. Solo lectura; algunas consultas funcionan sin token y un token gratuito desbloquea IPinfo Lite ilimitado.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

(ninguna obligatoria; opcional: IPINFO_TOKEN)

Paso 1 — Configurar el conector

Funciona sin token, mejor con uno: la configuración lleva menos de 2 minutos. El conector lee dos hosts de IPinfo, la API actual en https://api.ipinfo.io (Lite, lookup, places, batch) y la API clásica en https://ipinfo.io (todo lo demás).

1. En la tienda de conectores elige IPinfo e instálalo. Sin token solo funcionan ipinfo_get_my_ip, ipinfo_get_ip_details e ipinfo_get_ip_field, con una pequeña cuota diaria; las demás herramientas responden 400 o 403.
2. Recomendado: regístrate en https://ipinfo.io/signup. El plan gratuito ofrece consultas IPinfo Lite ilimitadas (país, continente y ASN). Copia el access token de https://ipinfo.io/dashboard/token en IPINFO_TOKEN, sin el prefijo Bearer. Se envía como Authorization: Bearer <token>.
3. Compruébalo con ipinfo_get_my_ip y, con token, con ipinfo_get_token_info: muestra el plan, las peticiones hechas y restantes hoy y este mes y, en features, los productos de datos que puede usar el token.

Qué herramienta para qué plan:

• Sin token: ipinfo_get_my_ip, ipinfo_get_ip_details, ipinfo_get_ip_field.
• Token gratuito: además ipinfo_lite_lookup, ipinfo_lite_me e ipinfo_batch_lite.
• Plan Core, Plus o Max: ipinfo_lookup (geolocalización a nivel de ciudad, tipo de ASN, indicadores de privacidad y móvil) e ipinfo_batch; Plus y Max también ipinfo_get_place.
• Business, enterprise o la API individual correspondiente: ipinfo_get_privacy, ipinfo_get_residential_proxy (complemento de proxies residenciales), ipinfo_get_company, ipinfo_get_carrier, ipinfo_get_abuse_contact, ipinfo_get_hosted_domains, ipinfo_get_asn, ipinfo_get_ip_ranges, ipinfo_whois_net, ipinfo_whois_org e ipinfo_whois_poc. Un token sin el producto responde 403.

Qué lee:

• Dónde está una IP y quién la opera: ipinfo_lite_lookup con token gratuito, ipinfo_lookup con uno de pago, ipinfo_get_ip_details en el formato clásico con hostname, ciudad, región, país, coordenadas, código postal, zona horaria y organización AS. ipinfo_get_ip_field devuelve un solo valor como texto, por ejemplo solo el país o la ciudad.
• Muchas IP a la vez: ipinfo_batch_lite (gratis) o ipinfo_batch (de pago, mezcla IP, campos como 8.8.8.8/country, ASN como AS15169 y rutas como resproxy/1.1.1.1), hasta 1.000 entradas por llamada; la IA divide las listas más largas.
• Controles de fraude y seguridad: indicadores de VPN, proxy, Tor, relay y hosting con ipinfo_get_privacy, salidas de redes de proxies residenciales con ipinfo_get_residential_proxy, a quién denunciar un abuso con ipinfo_get_abuse_contact y los dominios alojados en una IP (IP inversa) con ipinfo_get_hosted_domains.
• Redes y organizaciones: sistemas autónomos con prefijos, peers, upstreams y downstreams (ipinfo_get_asn), los rangos de IP de una empresa a partir de su dominio (ipinfo_get_ip_ranges), la empresa detrás de una IP (ipinfo_get_company), el operador móvil con MCC y MNC (ipinfo_get_carrier), el lugar público al que pertenece una IP, como un hotel o un aeropuerto (ipinfo_get_place), y registros WHOIS por red, organización o punto de contacto.
• ipinfo_get_my_ip e ipinfo_lite_me informan de la IP pública del servidor de AnythingMCP, no de la tuya.

Solo lectura: todas las herramientas solo leen, así que ninguna está desactivada al instalar. Las herramientas de lote se envían como POST pero solo leen.

Formatos de datos: la API clásica devuelve loc como "latitude,longitude" y org como "AS15169 Google LLC"; la API actual los separa en geo.latitude, geo.longitude y as.asn, as.name. Los países son códigos ISO 3166-1 alpha-2 (US, DE) y las zonas horarias nombres IANA (Europe/Berlin). Las direcciones privadas y reservadas vuelven con bogon: true y sin ubicación. La ubicación es una estimación de dónde está la red, no una persona; en Plus, radius indica la precisión en km. Las respuestas de lote son un objeto con la entrada como clave.

Paginación: ipinfo_get_hosted_domains acepta page (desde 0) y limit (100 por defecto, hasta 1.000). Las herramientas WHOIS devuelven 50 registros por página y aceptan page (desde 0).

Límites y errores frecuentes: Lite es ilimitado; los planes de pago tienen una cuota mensual y responden 429 cuando se agota. 400 con "Token not passed" o "API Access Token Required" significa que la herramienta necesita un token, 403 "Unknown token" un token incorrecto, 403 con un token válido un producto que tu plan no incluye, 404 "Wrong ip" una dirección IP mal formada.

El conector no localiza personas, no cambia nada en tu cuenta de IPinfo y no descarga las bases de datos de IPinfo.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de IPinfo.

Herramientas disponibles

Ejemplos de prompts

• "¿Dónde está la IP 8.8.8.8 y a qué red y organización pertenece?"
• "Consulta estas 50 IP de nuestro registro de inicios de sesión y agrúpalas por país y ASN."
• "¿Es 185.220.101.1 una dirección de VPN, proxy, Tor o hosting?"
• "¿Quién es el contacto de abuso de 203.0.113.45 y qué rango de red cubre?"
• "¿Qué plan tiene mi token de IPinfo y cuántas peticiones me quedan este mes?"

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot