The IPInfo MCP Server provides comprehensive IP address intelligence through 25+ tools that query the IPInfo API for detailed network, location, privacy, and organizational data.
Core IP Intelligence
Get comprehensive IP information including location, ASN, organization, company, and privacy detection
Batch operations: process multiple IPs simultaneously for lookups, summaries (up to 500,000 IPs), and visual mapping
Single-field queries: extract specific data like city, country code, region, coordinates, postal code, timezone, hostname, or organization
Network & Infrastructure
Retrieve ASN details including prefixes, peers, upstreams, and downstreams
Get company and mobile carrier information (with MCC/MNC codes)
Find domains hosted on specific IPs (with pagination) or IP ranges owned by domains/organizations
Privacy & Security
Detect VPNs, proxies, Tor exit nodes, relays, and hosting providers
Get abuse contact information for reporting
WHOIS Lookups
Query WHOIS records by IP address/range, domain, or ASN
Filter by source (ARIN, RIPE, AFRINIC, APNIC, LACNIC)
Account Management
Check API usage limits and available features
All tools support both specific IP lookups and current IP detection (when no IP is provided), with strongly-typed responses using Pydantic models for type safety.
MCP Server IPInfo
This is a version of the MCP Server for IPInfo that implements the complete IPInfo OpenAPI specification with strongly-typed models and comprehensive tool coverage.
Features
Full OpenAPI Spec Implementation: Complete implementation of IPInfo's OpenAPI specification
Strongly Typed: All API responses use Pydantic models for type safety
HTTP Transport: Supports streamable-http transport with health endpoint
Comprehensive Tools: 25+ MCP tools covering all IPInfo API endpoints
Backward Compatible: Maintains the original
get_ip_detailstool for compatibility
Installation
Configuration
Set your IPInfo API token as an environment variable:
Running the Server
As a standalone MCP server
In Claude Code
Add this configuration to your Claude Code settings:
Available MCP Tools
Core IP Information
get_ip_info(ip?)- Get comprehensive IP informationget_ip_details(ip?)- Legacy tool for backward compatibilityget_account_info()- Get API account limits and featuresbatch_lookup(ips[])- Batch lookup multiple IPssummarize_ips(ips[])- Get summary statistics for IP listmap_ips(ips[])- Create visual map of IP locations
ASN & Company
get_asn_info(asn)- Get Autonomous System informationget_company_info(ip)- Get company details for an IPget_carrier_info(ip)- Get mobile carrier information
Privacy & Security
get_privacy_info(ip)- Detect VPN, proxy, Tor, etc.get_abuse_contact(ip)- Get abuse contact information
Network Information
get_hosted_domains(ip, page?, limit?)- Get domains on an IPget_ip_ranges(domain)- Get IP ranges for a domain
WHOIS Lookups
whois_lookup_by_ip(ip, page?, source?)- WHOIS by IPwhois_lookup_by_domain(domain, page?, source?)- WHOIS by domainwhois_lookup_by_asn(asn, page?, source?)- WHOIS by ASN
Single Field Tools
get_ip_city(ip?)- Get just the cityget_ip_country(ip?)- Get just the country codeget_ip_region(ip?)- Get just the region/stateget_ip_location(ip?)- Get just the coordinatesget_ip_postal(ip?)- Get just the postal codeget_ip_timezone(ip?)- Get just the timezoneget_ip_hostname(ip?)- Get just the hostnameget_ip_org(ip?)- Get just the organization/ASN
Testing
Run the test client to verify the implementation:
API Client Usage
You can also use the API client directly in your Python code:
Type Safety
All models are strongly typed using Pydantic:
Requirements
Python 3.13+
aiohttp
fastmcp
pydantic
mcp
About
Part of the NimbleTools ecosystem. From the makers of NimbleBrain.
License
MIT
