@ipgeolocationapi/mcp

MCP server for ipgeolocationapi.io: IP intelligence as native tools for Claude Desktop, Cursor, and any MCP-compatible AI.

Ask "where is this visitor from, and is the IP a VPN?" and the AI fetches live data directly. No custom code.

Install (30 seconds)

Add to claude_desktop_config.json (Claude Desktop > Settings > Developer):

{
  "mcpServers": {
    "ipgeolocationapi": {
      "command": "npx",
      "args": ["-y", "@ipgeolocationapi/mcp"],
      "env": {
        "IPGEO_API_KEY": "ipa_optional_paid_key"
      }
    }
  }
}

Restart Claude Desktop. Done. The first run creates a small Python runtime (one time); macOS and Linux ship with a compatible Python by default.

Cursor and other MCP hosts: same shape, point the command at this package.

The 10 tools

Tool What it returns Tier
ip_lookup country, region, city, coordinates, timezone, currency, ASN free, keyless
security_check VPN, proxy, Tor, hosting, relay verdicts + threat score paid
company_lookup organization, registration country, PTR hostname paid
asn_lookup prefixes, route counts, network type free
timezone_info local time, offset, DST transitions free
timezone_convert convert timestamps between IANA zones free
astronomy sunrise, sunset, twilight tiers, golden hour, moon phase free
parse_user_agent browser, engine, OS, device class, bot verdict free
abuse_contact registry abuse mailbox and phone per range free
bulk_lookup up to 100 addresses per call, order preserved paid

Free tier: 5,000 calls/day, no key, no signup. Paid modules (security, company, bulk) need a Business or Max key from the dashboard.

Environment variables

  • IPGEO_API_KEY - optional. Unlocks the paid tools.
  • IPGEO_BASE - optional. Defaults to https://ipgeolocationapi.io.
  • IPGEO_PYTHON - optional. Explicit Python 3.10+ interpreter path.

Plain Python (no npm)

curl -O https://ipgeolocationapi.io/mcp/mcp_server.py
pip install "mcp==1.26.0" httpx
python mcp_server.py

License

MIT. The API terms apply to the data: https://ipgeolocationapi.io/terms

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.0.3)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for ipgeolocationapi from gravatar.com ipgeolocationapi

Credits

Author: ipgeolocationapi.io

License

MIT License (MIT)

Requires

Python >=3.9

Tags

ip geolocation ip-address geoip asn timezone vpn proxy api security

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ipgeolocateio-1.0.2.tar.gz (4.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ipgeolocateio-1.0.2-py3-none-any.whl (4.5 kB view details)

Uploaded Python 3

File details

Details for the file ipgeolocateio-1.0.2.tar.gz.

File metadata

  • Download URL: ipgeolocateio-1.0.2.tar.gz
  • Upload date:
  • Size: 4.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ipgeolocateio-1.0.2.tar.gz
Algorithm Hash digest
SHA256 8fb27f3a46abbb005df5077836c1b8d9d5a126acd9f2c8f6110388e729b4d886
MD5 7b7c3d73df431383baf79ad2c7059a33
BLAKE2b-256 a0bcf9561cde17476ff21acd27ec1c024329f544643b9c63bc20c453d5fbf328

See more details on using hashes here.

Provenance

The following attestation bundles were made for ipgeolocateio-1.0.2.tar.gz:

Publisher: pypi-publish.yml on thebigasif/ipgeolocationapi-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ipgeolocateio-1.0.2-py3-none-any.whl.

File metadata

  • Download URL: ipgeolocateio-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 4.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ipgeolocateio-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 63ef872a235b0fd83099c9040e1399eed207633cdf5e48c7e205b1a47288cea7
MD5 e12ecc0636b980c01356aae0c109127e
BLAKE2b-256 7ae6209ee0f2a78d70bf142692cc7a133fca65ebfdb442e3c114793669d45e9e

See more details on using hashes here.

Provenance

The following attestation bundles were made for ipgeolocateio-1.0.2-py3-none-any.whl:

Publisher: pypi-publish.yml on thebigasif/ipgeolocationapi-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

1.0.3

2 files

This release

1.0.2 This release

2 files

1.0.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page