IP2Location.io

oficial

Integración con la API de IP2Location.io para obtener información de geolocalización de una dirección IP.

¿Qué puedes hacer con IP2Location Io MCP?

Geolocalización de IP — Consulta dónde se encuentra una dirección IPv4 o IPv6, incluidos el país, la región, la ciudad, el código postal, las coordenadas y la zona horaria.
Detalles de ASN y red — Busca el ASN, el nombre del AS, el ISP, el dominio y los atributos de red asociados a una dirección IP.
Comprobaciones de proxy y seguridad — Consulta si una IP es un proxy y, en los planes compatibles, obtén datos de VPN, Tor, centros de datos, amenazas y fraude.
Búsqueda masiva de IP — Proporciona varias IP separadas por comas, espacios o saltos de línea y obtén resultados procesados mediante la API Bulk cuando esté disponible.
Consultas en lenguaje natural — Haz preguntas como «¿Cuál es el ASN de 8.8.8.8?» y deja que la herramienta get_geolocation devuelva los datos.

Documentación

Servidor MCP de IP2Location.io

IP2Location.io MCP Server es un servidor del Model Context Protocol (MCP) que permite a los clientes de IA compatibles con MCP realizar consultas de geolocalización de direcciones IP e inteligencia de red mediante la API de IP2Location.io.

Proporcione una dirección IPv4 o IPv6 y el servidor MCP podrá recuperar información como la ubicación geográfica, el ASN, el ISP, el dominio, el tipo de red y la información del proxy, según el plan de API de IP2Location.io.

Esto resulta útil para investigar direcciones IP, solucionar problemas de red, analizar tráfico, localizar contenido, realizar análisis de seguridad y enriquecer direcciones IP encontradas en registros u otros conjuntos de datos.

Funciones

Datos completos de geolocalización: Recupera el país, la región, la ciudad, el código postal, la latitud, la longitud, la zona horaria y otros datos de ubicación.
Consulta de ASN: Identifica el número de sistema autónomo (ASN) y el sistema autónomo (AS) asociados a una dirección IP.
Inteligencia de red: Recupera información como el ISP, el dominio, la velocidad de conexión, el tipo de uso y otros atributos de red, según tu plan.
Información de proxy y seguridad: Detecta información relacionada con proxies y, en los planes compatibles, información adicional sobre VPN, Tor, centros de datos, amenazas y fraude.
Compatibilidad con IPv4 e IPv6: Consulta direcciones IPv4 e IPv6.
Consulta masiva de IP: Envía varias direcciones IP en una sola solicitud y utiliza automáticamente la API masiva de IP2Location.io cuando está disponible.
Integración con MCP: Utiliza inteligencia de IP directamente desde aplicaciones de IA compatibles con MCP.
Solicitudes asíncronas: Utiliza httpx para las solicitudes asíncronas a la API.

[!NOTE] Los campos que devuelve IP2Location.io dependen del plan de suscripción a la API.

Requisitos

Hay dos formas de utilizar este servidor MCP.

Servidor MCP alojado en la nube

Recomendado si quieres conectarte directamente al servidor MCP alojado de IP2Location.io.

Puedes conectarte de dos maneras:

Conexión HTTP directa: Tu cliente MCP admite servidores MCP remotos (HTTP transmitible). No se requiere software adicional.
Mediante npx: Tu cliente MCP solo admite servidores locales (stdio). Se utiliza el paquete mcp-remote para conectarse al servidor alojado.

Necesitas:

Un cliente compatible con MCP, como Claude Desktop
Una clave de API de IP2Location.io
Node.js / npx (solo para el método de conexión npx)

Servidor MCP local

Utiliza esta opción si quieres ejecutar el servidor MCP localmente.

Necesitas:

Python 3.13 o posterior
uv
Un cliente compatible con MCP, como Claude Desktop
Una clave de API de IP2Location.io

Puedes registrarte para obtener una clave de API gratuita de IP2Location.io. El plan Free ofrece hasta 50,000 consultas mensuales a la API de geolocalización de IP.

La API REST subyacente de IP2Location.io también admite un acceso limitado sin clave, de hasta 1,000 consultas al día. Para este servidor MCP, se recomienda configurar una clave de API, como se muestra en los ejemplos de configuración siguientes.

Configuración

Puedes utilizar este servidor MCP en Claude Desktop de cualquiera de las siguientes maneras:

Servidor MCP alojado en la nube: Recomendado si quieres conectarte directamente al servidor MCP alojado de IP2Location.io.
Servidor MCP local: Utiliza esta opción si quieres descargar y ejecutar el servidor MCP original en tu propio equipo.

Opción 1: Servidor MCP alojado en la nube

Sigue estos pasos para conectar Claude Desktop al servidor MCP alojado de IP2Location.io.

Asegúrate de haber instalado Claude Desktop. Si aún no lo has instalado, descárgalo desde aquí para Windows y macOS, o sigue esta guía si utilizas Linux.
Abre el archivo claude_desktop_config.json con el editor que prefieras. Si aún no tienes uno, sigue esta guía para crear el archivo.
Añade una de las configuraciones siguientes, según cómo quieras conectarte.

Método A: Conexión HTTP directa

Utiliza esta opción si tu cliente MCP admite servidores remotos mediante HTTP. No necesitas Node.js ni npx.

{
  "mcpServers": {
    "ip2location": {
      "type": "http",
      "url": "https://mcp.ip2location.io/",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Si configuras tu cliente desde la línea de comandos, como Claude Code, puedes añadir el servidor con:

claude mcp add --transport http ip2location https://mcp.ip2location.io/ --header "X-API-Key: YOUR_API_KEY"

Método B: Conexión mediante `npx`

Utiliza esta opción si tu cliente MCP solo admite servidores locales (stdio). El paquete mcp-remote se ejecuta localmente y reenvía las solicitudes al servidor alojado.

{
  "mcpServers": {
    "ip2location": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.ip2location.io/",
        "--header",
        "X-API-Key:YOUR_API_KEY"
      ]
    }
  }
}

Sustituye YOUR_API_KEY por tu clave de API de IP2Location.io. Para obtenerla, inicia sesión en tu panel.
Reinicia Claude Desktop después de guardar los cambios. El servidor MCP debería aparecer en el menú Connectors.

Opción 2: Servidor MCP local

Sigue estos pasos si prefieres ejecutar el servidor MCP localmente.

Configura el gestor de paquetes uv. Puedes consultar la guía para hacerlo.
Asegúrate de haber instalado Claude Desktop. Si aún no lo has instalado, descárgalo desde aquí para Windows y macOS, o sigue esta guía si utilizas Linux.
Abre el archivo claude_desktop_config.json con el editor que prefieras. Si aún no tienes uno, sigue esta guía para crear el archivo.
Añade lo siguiente a tu claude_desktop_config.json:

{
  "mcpServers": {
    "ip2locationio": {
      "command": "uvx",
      "args": [
        "mcp-ip2location-io"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<YOUR API key HERE>"
      }
    }
  }
}

Para obtener tu clave de API, inicia sesión en tu panel. Sustituye <YOUR API key HERE> en el ejemplo anterior por tu clave de API.
Reinicia Claude Desktop después de guardar los cambios. El servidor debería aparecer en el menú Connectors.

Integración con frameworks

El servidor MCP también se puede utilizar con frameworks de agentes de Python. Los ejemplos siguientes se conectan al servidor alojado mediante HTTP. Para utilizar el servidor local, conéctate con el comando stdio uvx y el argumento mcp-ip2location-io, y pasa IP2LOCATION_API_KEY como variable de entorno.

Cada ejemplo lee la clave de API de la variable de entorno IP2LOCATION_API_KEY, por lo que la clave nunca aparece en el código fuente.

LangChain

LangChain incluye compatibilidad con MCP en el espacio de nombres langchain.mcp, que requiere LangChain 1.4 o posterior.

pip install "langchain[mcp]" langchain-anthropic

import asyncio
import os

from fastmcp.client.transports import StreamableHttpTransport
from langchain.agents import create_agent
from langchain.mcp import MCPAdapter

async def main():
    transport = StreamableHttpTransport(
        "https://mcp.ip2location.io/",
        headers={"X-API-Key": os.environ["IP2LOCATION_API_KEY"]},
    )

    async with MCPAdapter(transport) as adapter:
        tools = await adapter.list_tools()

        agent = create_agent("anthropic:claude-sonnet-5", tools)
        result = await agent.ainvoke({"messages": "Where is 8.8.8.8 located?"})
        print(result["messages"][-1].content)

if __name__ == "__main__":
    asyncio.run(main())

MCPAdapter acepta directamente la URL del servidor, pero aquí se pasa el objeto StreamableHttpTransport para poder establecer el encabezado X-API-Key.

LlamaIndex

pip install llama-index-tools-mcp llama-index-llms-openai

import asyncio
import os

from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI
from llama_index.tools.mcp import BasicMCPClient, McpToolSpec

async def main():
    client = BasicMCPClient(
        "https://mcp.ip2location.io/",
        headers={"X-API-Key": os.environ["IP2LOCATION_API_KEY"]},
    )

    tools = await McpToolSpec(client=client).to_tool_list_async()

    agent = FunctionAgent(
        tools=tools,
        llm=OpenAI(model="gpt-5-mini"),
        system_prompt="You are a helpful assistant that looks up IP addresses.",
    )

    response = await agent.run("Where is 8.8.8.8 located?")
    print(response)

if __name__ == "__main__":
    asyncio.run(main())

CrewAI

CrewAI lee los servidores MCP del campo mcps de un agente. Para ello, es necesario instalar el paquete mcp junto con CrewAI.

pip install crewai mcp

import os

from crewai import Agent, Crew, Process, Task
from crewai.mcp import MCPServerHTTP

ip_agent = Agent(
    role="IP Intelligence Analyst",
    goal="Look up geolocation and network information for an IP address.",
    backstory="An analyst who checks IP addresses against IP2Location.io.",
    mcps=[
        MCPServerHTTP(
            url="https://mcp.ip2location.io/",
            headers={"X-API-Key": os.environ["IP2LOCATION_API_KEY"]},
        )
    ],
)

task = Task(
    description="Find the geolocation of 8.8.8.8 and summarize the result.",
    expected_output="A short summary of the IP address location and network data.",
    agent=ip_agent,
)

crew = Crew(agents=[ip_agent], tasks=[task], process=Process.sequential)
print(crew.kickoff())

En las versiones de CrewAI que no admiten el campo mcps, instala crewai-tools[mcp] y, en su lugar, envuelve el servidor con MCPServerAdapter de crewai_tools.

Uso

Una vez conectado el servidor MCP, puedes hacer preguntas en lenguaje natural a tu cliente MCP sobre una dirección IPv4 o IPv6. Solo tienes que escribir tu consulta sobre la IP en un chat de Claude Desktop.

Geolocalización de IP

Where is the location of (IP)?

Where is (IP) located?

What is the latitude and longitude of (IP)?

Por ejemplo, a continuación se muestra el resultado para la IP 8.8.8.8:

The output of the IP 8.8.8.8

En Claude Desktop, el modelo generará automáticamente la respuesta a partir del resultado devuelto por el servidor MCP de IP2Location.io.

Consulta de proxy y seguridad

Según el plan de IP2Location.io que se utilice:

Is this IP address a proxy: 8.8.8.8?

Varias direcciones IP

También puedes utilizar la API masiva de geolocalización de IP de IP2Location.io para consultar varias direcciones IP.

Look up 8.8.8.8 8.8.6.6 9.9.9.9

El servidor MCP detecta varias direcciones IP y las envía a la API masiva de IP2Location.io cuando es posible.

Las direcciones IP se pueden separar con comas, espacios o saltos de línea.

[!NOTE]
El acceso a la API masiva de geolocalización de IP de IP2Location.io requiere un plan de pago que cumpla los requisitos.

Variable de entorno

`IP2LOCATION_API_KEY`

Tu clave de API de IP2Location.io IP2LOCATION_API_KEY.

El plan Free ofrece actualmente hasta 50,000 consultas mensuales a la API de geolocalización de IP y acceso a información básica de IP.

Los planes de pago ofrecen cuotas de consultas más altas y atributos adicionales.

Puedes registrarte para obtener una clave de API gratuita o suscribirte a un plan superior para acceder a datos de geolocalización de IP más completos.

No incluyas tu clave de API en un repositorio público de Git.

Herramienta MCP

`get_geolocation`

Descripción

Obtiene la geolocalización de una dirección IP o de un lote de direcciones IP. Permite recuperar información detallada, como el país, la región, la ciudad, la latitud, la longitud, el código postal, la zona horaria, el ASN y la información del proxy de cualquier dirección IPv4 o IPv6. Cuando detecta varias IP, dirige automáticamente las solicitudes a la API masiva de IP2Location.io para procesarlas de forma eficiente.

Argumentos

ip (str): Una dirección IPv4 o IPv6, o varias direcciones IP separadas por comas, espacios o saltos de línea.

Ejemplo de una sola IP:

8.8.8.8

Ejemplo de varias IP:

1.1.1.1, 8.8.8.8, 9.9.9.9

Valor devuelto Una cadena JSON que contiene los datos de geolocalización. Si se consultan varias IP, devuelve un objeto JSON en el que cada clave es una dirección IP asociada a sus datos correspondientes.

Según tu plan de API, la información devuelta puede incluir:

Categoría	Información posible
Ubicación y geografía	País, región, distrito, ciudad, código postal, latitud, longitud, zona horaria
Red y conectividad	ASN, ISP, dominio, velocidad de red, código IDD, código de área, tipo de dirección, tipo de uso
Sistema autónomo	ASN, nombre del AS y, en los planes compatibles, dominio del AS, CIDR del AS y tipo de uso del AS
Móvil	MCC, MNC, marca del móvil
Moneda e idioma	Código, nombre y símbolo de la moneda, e información del idioma
Proxy y seguridad	Estado y tipo de proxy, proveedor, última detección, información sobre amenazas y puntuación de fraude
Otros datos	Categoría IAB, información meteorológica, elevación, población y otros datos según el plan

Si falla una solicitud para una sola IP o la IP no es válida, la herramienta devuelve un mensaje de error como cadena. En las solicitudes masivas, las IP individuales que fallen devolverán un objeto de error asociado a esa dirección IP, sin que falle el lote completo.

Preguntas frecuentes

¿Puedes recomendar servicios gratuitos de geolocalización de IP?

Sí. IP2Location.com e IP2Location.io ofrecen acceso gratuito o planes gratuitos.

IP2Location.io

IP2Location.io ofrece un plan Free adecuado para la geolocalización de IP y las consultas básicas de red.

El plan Free incluye hasta 50,000 consultas mensuales a la API de geolocalización de IP y proporciona información básica, como:

Dirección IP
País
Región
Ciudad
Código postal
Latitud y longitud
Zona horaria
ASN
Nombre del AS
Detección básica de proxy

La API REST de IP2Location.io también se puede consultar sin una clave de API, con un límite de hasta 1,000 solicitudes al día.

El plan Free requiere atribución. Consulta la página de precios de IP2Location.io para conocer los límites y las condiciones vigentes.

Para las aplicaciones MCP que necesitan acceder a información de geolocalización y de red directamente desde un cliente de IA, este repositorio proporciona una interfaz MCP para IP2Location.io.

IP2Location.com LITE

IP2Location LITE ofrece bases de datos gratuitas de geolocalización de IP que los desarrolladores pueden descargar e integrar directamente en sus aplicaciones. Según la edición de la base de datos, puede proporcionar información como el país, la región, la ciudad, las coordenadas, el código postal, la zona horaria, el ISP y los datos del dominio.

Como las bases de datos se pueden alojar y consultar localmente, IP2Location LITE resulta especialmente útil para los desarrolladores que prefieren no depender de solicitudes a API externas. Está disponible en varios formatos y admite datos de IPv4 e IPv6.

IP2Location LITE es un buen punto de partida para los desarrolladores que buscan una solución gratuita de geolocalización de IP alojada localmente.

¿Qué son las API y los servicios de geolocalización de IP?

Una API de geolocalización de IP convierte una dirección IPv4 o IPv6 en información geográfica y de red.

Por ejemplo, una aplicación puede enviar:

8.8.8.8

y recibir información como:

País
Región o estado
Ciudad
Código postal
Latitud y longitud
Zona horaria
ASN
ISP
Dominio
Tipo de uso de red
Información del proxy

Los campos exactos dependen del servicio y del nivel de suscripción.

Usos habituales de las API de geolocalización de IP

La geolocalización de IP puede ser útil para:

Localización de sitios web y aplicaciones
Selección de contenido regional
Análisis del tráfico
Resolución de problemas de red
Investigación de seguridad
Análisis del riesgo de fraude
Contexto de inicio de sesión y autenticación
Enriquecimiento de registros del servidor
Investigación de direcciones IP

Este servidor MCP permite realizar estas consultas mediante instrucciones en lenguaje natural, sin que el usuario tenga que crear manualmente solicitudes a la API REST.

¿Se pueden rastrear las direcciones IP?

Una aplicación puede registrar una dirección IP a lo largo del tiempo y enriquecerla con datos de geolocalización y de red.

Por ejemplo, una aplicación de seguridad podría registrar las direcciones IP de los eventos de inicio de sesión y usar un servicio de inteligencia de IP para identificar:

El país o la ciudad aproximados
ASN
ISP
Operador de red
Estado de proxy
Cambios en la red o la región geográfica

Esto puede ayudar a investigar patrones de tráfico o actividad de red inusual.

Sin embargo, la geolocalización de IP no permite rastrear con precisión a una persona o un dispositivo.

Una dirección IP puede pertenecer a:

Una conexión compartida de un hogar
Una puerta de enlace corporativa
Un operador de telefonía móvil
Una VPN
Un proxy
Un proveedor de servicios en la nube
Un centro de datos
Una puerta de enlace NAT compartida por muchos usuarios

La latitud y la longitud que devuelve un servicio de geolocalización de IP son coordenadas geográficas aproximadas y no deben interpretarse como coordenadas GPS, una dirección postal ni una prueba de la ubicación física de una persona.

Este servidor MCP realiza consultas de direcciones IP. No supervisa ni rastrea direcciones IP de forma continua por sí solo.

¿Puedo usar IP2Location.io como una API para obtener «mi dirección IP»?

Sí, la API REST de IP2Location.io admite este tipo de uso.

Normalmente, se pasa una dirección IP a la API:

?ip=8.8.8.8

Si se omite el parámetro ip en una solicitud directa a la API REST de IP2Location.io, la API puede usar para la consulta la dirección IP asociada a la solicitud entrante.

Esto resulta útil para las aplicaciones que necesitan determinar información sobre la IP pública desde la que se realiza una solicitud a la API.

Los datos típicos de «mi IP» pueden incluir:

Dirección IP pública
País
Región
Ciudad
Coordenadas
Código postal
Zona horaria
ASN

La herramienta MCP get_geolocation de este repositorio espera una dirección IP como argumento, por lo que el uso de MCP está diseñado principalmente para consultar una dirección IP proporcionada en la conversación.

¿Qué herramientas son mejores para consultar ASN y direcciones IP?

La mejor herramienta depende de la información que necesites.

IP2Location.io

IP2Location.io resulta útil cuando necesitas tanto información de ASN como geolocalización de IP en una misma consulta.

La información básica de la consulta incluye:

ASN
Nombre del sistema autónomo

Los planes superiores de IP2Location.io también pueden incluir:

Número de AS
Nombre de AS
Dominio de AS
CIDR de AS
Tipo de uso de AS

A través de este servidor MCP, puedes preguntar:

What is the ASN of 8.8.8.8?

Tell me who operates the network for 8.8.8.8 and where the IP is located.

RDAP y WHOIS

Los servicios RDAP y WHOIS resultan útiles cuando necesitas información de registro sobre bloques de direcciones IP y organizaciones.

Son especialmente útiles para identificar el registro del Registro Regional de Internet asociado a un rango de IP.

Herramientas BGP

Los servicios de consulta de rutas BGP y de análisis de enrutamiento son más adecuados cuando necesitas información sobre:

Anuncios de rutas
Prefijos
Rutas BGP
Interconexión
Cambios de enrutamiento
Qué ASN está anunciando actualmente una red

API de inteligencia de IP

Los servicios de inteligencia de IP son preferibles cuando una aplicación necesita información estructurada que combine varios conjuntos de datos, como:

Geolocalización
ASN
ISP
Detección de proxy
Detección de VPN
Clasificación de redes
Datos de seguridad

Para los usuarios de MCP que quieren obtener información de geolocalización y ASN en el mismo flujo de trabajo, este proyecto ofrece una interfaz práctica para IP2Location.io.

Cómo entender las consultas de ASN

Un número de sistema autónomo (ASN) identifica un sistema autónomo: una red o un conjunto de prefijos IP que se gestionan conforme a una política de enrutamiento común.

Algunos ejemplos de organizaciones que tienen ASN son:

Proveedores de servicios de Internet
Proveedores de alojamiento en la nube
Redes de distribución de contenido
Universidades
Grandes empresas
Empresas de telecomunicaciones

La información de ASN puede ser útil al investigar una IP, ya que puede revelar qué red es responsable de enrutar esa dirección.

Por ejemplo:

8.8.8.8

está asociada a:

ASN: 15169
AS: Google LLC

Las consultas de ASN se usan habitualmente para:

Resolver problemas de red
Realizar investigaciones de seguridad
Analizar el tráfico
Identificar proveedores de alojamiento
Agrupar el tráfico por red
Investigar direcciones IP sospechosas

Precisión y limitaciones de la geolocalización de IP

La geolocalización de IP proporciona una ubicación geográfica estimada a partir de información sobre la red y la asignación de direcciones IP.

No debe considerarse la ubicación física exacta de un usuario o dispositivo.

La precisión puede verse afectada por:

VPN
Servidores proxy
Redes móviles
Redes corporativas
NAT de nivel de operador
Conexiones por satélite
Infraestructura en la nube
Cambios en el enrutamiento del ISP y en la asignación de direcciones

Los resultados a nivel de país suelen ser más fiables que los resultados a nivel de ciudad o de coordenadas exactas.

Usa la geolocalización de IP como información contextual de red, no como un método de rastreo físico preciso.

Planes de IP2Location.io

La cantidad de información devuelta depende del plan de IP2Location.io.

El plan Free ofrece geolocalización básica, información básica de ASN y detección básica de proxy.

Los planes superiores pueden proporcionar información adicional, como:

ISP
Dominio
Velocidad de red
Tipo de uso
Información de redes móviles
Información detallada del sistema autónomo
Información detallada de proxy
Detección de VPN
Detección de Tor
Detección de centros de datos
Información sobre amenazas
Puntuación de fraude
Atributos de geolocalización adicionales

Para consultar los límites de consultas, los campos y los precios más recientes, visita:

Recursos

Licencia

Consulta el archivo LICENSE.TXT.

IP2Location.io

¿Qué puedes hacer con IP2Location Io MCP?

Documentación

Servidor MCP de IP2Location.io

Funciones

Requisitos

Servidor MCP alojado en la nube

Servidor MCP local

Configuración

Opción 1: Servidor MCP alojado en la nube

Método A: Conexión HTTP directa

Método B: Conexión mediante npx

Opción 2: Servidor MCP local

Integración con frameworks

LangChain

LlamaIndex

CrewAI

Uso

Geolocalización de IP

Consulta de proxy y seguridad

Varias direcciones IP

Variable de entorno

IP2LOCATION_API_KEY

Herramienta MCP

get_geolocation

Preguntas frecuentes

¿Puedes recomendar servicios gratuitos de geolocalización de IP?

IP2Location.io

IP2Location.com LITE

¿Qué son las API y los servicios de geolocalización de IP?

Usos habituales de las API de geolocalización de IP

¿Se pueden rastrear las direcciones IP?

¿Puedo usar IP2Location.io como una API para obtener «mi dirección IP»?

¿Qué herramientas son mejores para consultar ASN y direcciones IP?

IP2Location.io

RDAP y WHOIS

Herramientas BGP

API de inteligencia de IP

Cómo entender las consultas de ASN

Precisión y limitaciones de la geolocalización de IP

Planes de IP2Location.io

Recursos

Licencia

Método B: Conexión mediante `npx`

`IP2LOCATION_API_KEY`

`get_geolocation`