Skip to content
Agentmart
Submit a tool

IPGeolocation.io MCP Server

IP geolocation, security, ASN, abuse, time zones, astronomy, and user-agent parsing over stdio.

Connector by IPGeolocation · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 4
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/ipgeolocation-ipgeolocation-io-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

IP geolocation, security, ASN, abuse, time zones, astronomy, and user-agent parsing over stdio.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
17 read · 0 write · 0 deleteRead-only
Secrets
1 (API keys, tokens or passwords)
Install scripts
None found
Runs as
Node.js package

Tools by what they do 17

Read from the source code; the running server may list different tools.

Read 17 · Look things up without changing anything.

  • bulk_lookup_ip
  • bulk_parse_user_agent
  • bulk_security_check
  • check_security
  • convert_timezone
  • get_abuse_contact
  • get_astronomy
  • get_astronomy_time_series
  • get_cached_result
  • get_my_ip
  • get_timezone
  • lookup_asn
Show 5 more tools
  • lookup_company
  • lookup_currency
  • lookup_ip
  • lookup_network
  • parse_user_agent

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • IPGEOLOCATION_API_KEY

Network hosts it talks to 8

  • agent-plugins.org · found in code
  • api.ipgeolocation.io · found in code
  • app.ipgeolocation.io · found in code
  • cdn.mpak.dev · found in code
  • github.com · found in code
  • glama.ai · found in code
  • ipgeolocation.io · found in code
  • static.ipgeolocation.io · found in code

Files it touches

  • Any path the agent passes to its tools

Tools (17)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • bulk_lookup_ipBulk IP Geolocationread-only

    Description is built at runtime.

  • bulk_parse_user_agentBulk User-Agent Parserread-only

    Description is built at runtime.

  • bulk_security_checkBulk Security Checkread-only

    Description is built at runtime.

  • check_securityVPN/Proxy/Threat Detectionread-only

    Read-only security lookup via GET /v3/security. Paid only. Cost: 2 credits. This endpoint is dedicated to security and threat data; lookup_ip with include=security provides security data together with location, ASN/company, network, timezone, currency, or abuse. Returns { ip, security } with threat_score, VPN, proxy, residential proxy, Tor, relay, anonymity, bot, spam, known attacker, and cloud-provider fields; provider names, confidence scores, and last_seen dates appear when available. fields/excludes accept comma-separated security.* dot paths; ip is always returned. Threat scores and fla…

  • convert_timezoneTimezone Conversionread-only

    Read-only time conversion via GET /v3/timezone/convert. Works on free and paid plans. Cost: 1 credit. The conversion requires one source selector and one destination selector; get_timezone provides a single place's current time and metadata. Source/destination selectors are tz_from/tz_to, location_from/location_to, iata_from/iata_to, icao_from/icao_to, locode_from/locode_to, or lat_from+long_from and lat_to+long_to. time is optional and must be yyyy-MM-dd HH:mm or yyyy-MM-dd HH:mm:ss. Returns original time, converted time, diff_hour, and diff_min.

  • get_abuse_contactAbuse Contact Lookupread-only

    Read-only abuse contact lookup via GET /v3/abuse. Paid only. Cost: 1 credit. This endpoint is dedicated to abuse contact data; lookup_ip with include=abuse provides abuse data together with location, security, ASN/company, timezone, network, or currency. Returns { ip, abuse } with route, country, name, organization, kind, address, emails, and phone_numbers for reporting abuse. fields/excludes accept comma-separated abuse.* paths such as abuse.emails; ip is always returned. force_refresh bypasses cached data, makes a new upstream request, and can consume credits.

  • get_astronomyAstronomy Dataread-only

    Read-only single-date astronomy lookup via GET /v3/astronomy. Works on free and paid plans. Cost: 1 credit. This endpoint covers one date or real-time sun/moon position; get_astronomy_time_series provides daily sunrise, moon, and twilight data across a date range. Returns { location, astronomy } plus ip for IP/server-address lookups. astronomy includes date/current_time, sunrise/sunset, moonrise/moonset, twilight blocks, day_length, sun/moon position, distance, status, moon_phase, moon_illumination_percentage, and moon_angle. Selector priority is lat/long, location, ip, then the server's pub…

  • get_astronomy_time_seriesAstronomy Time Seriesread-only

    Read-only daily astronomy series via GET /v3/astronomy/timeSeries. Works on free and paid plans. Cost: 1 credit per request. This endpoint covers date ranges up to 90 days; get_astronomy provides one-date and real-time sun/moon data. Returns { location, astronomy: [...] } with one daily item per date containing sunrise/sunset, moonrise/moonset, twilight blocks, day_length, sun/moon status, and moon_phase. Selector priority is lat/long, location, ip, then the server's public egress IP when no selector is provided. dateStart and dateEnd are required YYYY-MM-DD values with a maximum 90-day span…

  • get_cached_resultRead Cached Result Pageread-only

    Returns one page of a previously returned result using page.cursor or page.next_cursor. Costs 0 credits and never calls any upstream API, including on failure. The json_fragment strings concatenate in offset order into the complete original structuredContent JSON, including nested arrays and bulk item errors. The last page has no next_cursor. Cursors are scoped to the same API key and server process. Successful reads extend idle expiry by the configured cache TTL (five minutes by default); eviction or restart can remove a result. An unavailable cursor returns a local error and never starts ano…

  • get_my_ipGet My IP Addressread-only

    Returns the public IP address of the machine running this MCP server via GET /v3/getip. Takes no input parameters and requires no API key, account, or credits. The response is a plain IP address string, not geolocation data; lookup_ip provides location, ASN, timezone, currency, security, and abuse data.

  • get_timezoneTimezone Lookupread-only

    Read-only timezone lookup via GET /v3/timezone. Works on free and paid plans. Cost: 1 credit. This endpoint provides current local time and metadata for one place, IP, airport, UN/LOCODE, or IANA timezone; convert_timezone provides source-to-destination conversion. Returns { time_zone } plus selector context such as location, airport, city, or ip. time_zone includes the zone name, current time, UTC offsets, date/time variants, abbreviations, and DST status/transition fields when available. Selector priority is tz, lat/long, location, ip, iata_code, icao_code, then lo_code. lat and long must …

  • lookup_asnASN Detailsread-only

    Read-only ASN enrichment via GET /v3/asn. Paid only. Cost: 1 credit. Queries accept asn or ip, with asn taking priority. The response covers ASN relationships, route prefixes, allocation details, and WHOIS; lookup_ip provides basic ASN data together with geolocation. Returns { asn } core fields plus included peers, downstreams, upstreams, routes, or whois_response. include accepts those five values. fields/excludes accept full asn.* paths or root-relative paths such as upstreams.as_number. fields automatically enables required optional datasets; excludes alone never requests extra datasets. f…

  • lookup_companyCompany/Organization Lookupread-only

    Read-only ownership lookup via GET /v3/ipgeo. Company details require a paid plan; free plans return basic ASN ownership only. Cost: 1 credit. This response is limited to company and ASN ownership; lookup_ip can return ownership together with location, security, abuse, network, timezone, or currency. Returns { company, asn }: company name/type/domain plus ASN allocation fields when available. ip omitted means the server's public egress IP. force_refresh bypasses cached data, makes a new upstream request, and can consume credits.

  • lookup_currencyCurrency and Country Metadataread-only

    Read-only currency and country metadata lookup via GET /v3/ipgeo. Works on free and paid plans. Cost: 1 credit per successful lookup. Returns { currency, country_metadata }: currency code/name/symbol plus country calling_code, tld, and languages. ip selects the IP used to derive country and currency; omit it for the server machine's public egress IP. force_refresh bypasses cached data, makes a new upstream request, and can consume credits. This response is limited to currency and country metadata. lookup_ip can return these fields together with other IP data.

  • lookup_ipIP Geolocation Lookupread-only

    Read-only unified IP lookup via GET /v3/ipgeo. Base IP data costs 1 credit; security adds 2 and abuse adds 1. Selecting only security costs 2, only abuse costs 1, and security plus abuse without base data costs 3 credits. The unified response can cover multiple data domains for one IP or domain: location, company/ASN, network, timezone, currency, security, abuse, user_agent, hostname, geo_accuracy, and dma_code. Returns root IP/domain data plus selected objects such as location, country_metadata, currency, asn, network, company, time_zone, security, abuse, user_agent, or hostname. geo_accurac…

Show 2 more tools
  • lookup_networkNetwork/Routing Inforead-only

    Read-only network lookup via GET /v3/ipgeo. Network details require a paid plan. Cost: 1 credit. Returns { network } with route CIDR prefix, connection_type, and is_anycast. If the API omits network data, returns a local error without inventing an HTTP status; credits may already have been used. ip omitted means the server's public egress IP. force_refresh bypasses cached data, makes a new upstream request, and can consume credits. This response is limited to network data; lookup_ip can return network data together with location, ASN/company, timezone, currency, security, or abuse.

  • parse_user_agentUser-Agent Parserread-only

    Read-only custom user-agent parsing via POST /v3/user-agent. Paid only for POST payload parsing. Cost: 1 credit per successful string. Parses only the explicit uaString value; it cannot read caller headers or transport metadata. Returns { user_agent_string, name, type, version, version_major, device, engine, operating_system }. Type fields can identify desktop/mobile clients, robots, malformed or scripted strings, anonymized strings, or unknown values. uaString must be the exact non-empty user-agent string; empty/null strings are rejected locally before any API call. force_refresh bypasses ca…

Compare and alternatives

    Featured in

    Signals

    Stars
    4
    Forks
    4
    Open issues
    0
    Last commit
    Oct 16, 2026 (12 days ago)
    Last release
    Oct 11, 2026 (17 days ago)

    From GitHub (fetched Oct 24, 2026).

    Details

    Registry name
    io.github.IPGeolocation/ipgeolocation-io-mcp
    Version
    2.0.1
    Auth
    API key
    Packages
    npm ipgeolocation-io-mcp
    License
    MIT
    Repository
    github.com/IPGeolocation/ipgeolocation-io-mcp
    Website
    ipgeolocation.io/integrations/ipgeolocation-io-mcp
    First seen
    Oct 24, 2026
    Last checked
    Oct 24, 2026
    Source
    Official MCP Registrygithub-graphql
    Cite this page

    IPGeolocation.io MCP Server. Agent Mart. https://agentmart.dev/connectors/ipgeolocation-ipgeolocation-io-mcp (last updated 2026-10-24)