Skip to content

This release includes 4 breaking changes for platform teams planning a safe upgrade.

Published 3mo MCP Data & Storage
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Affected surfaces

breaking_upgrade deps

Summary

AI summary

Batch IP lookup, residential proxy detection, map URL generation, and async architecture introduced.

Full changelog

Added

  • Batch IP lookup - get_ip_details now accepts a list of IPs for bulk lookups
  • Residential proxy detection - new get_residential_proxy_info tool
  • Map URL generation - new get_map_url tool for visualizing IP locations
  • Async architecture - switched to ipinfo.AsyncHandler with lifespan management for proper init/cleanup
  • Async-safe cache with asyncio.Lock and batch operation support
  • Configurable cache TTL via IPINFO_CACHE_TTL env var
  • Tool annotations (readOnlyHint, openWorldHint) for MCP clients
  • Comprehensive test suite - 59 tests with a new conftest.py and expanded test files
  • Typed sub-models for nested response fields (ASNDetails, PrivacyDetails, CarrierDetails, etc.)
  • region_code field in IPDetails
  • CHANGELOG.md added

Changed

  • get_ip_details returns list[IPDetails] instead of a single object (unified single/batch)
  • Parameter changed from ip: str | None to ips: list[str] | None
  • Cache methods are now async
  • Nested fields are typed Pydantic models instead of raw dicts
  • IP validation ordering improved (loopback before private)
  • Documentation fixes for API tier names and privacy.service type

Removed

  • get_ipinfo_api_token tool (redundant)
  • Separate get_batch_ip_details tool (merged into get_ip_details)

Infrastructure

  • Updated GitHub Actions checkout action
  • Removed duplication in CI workflow
  • Significant dependency updates in uv.lock

Breaking Changes

  • get_ip_details now returns list[IPDetails] instead of a single object
  • Parameter changed from ip: str | None to ips: list[str] | None
  • Removed get_ipinfo_api_token tool (redundant)
  • Removed separate get_batch_ip_details tool (merged into get_ip_details)

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track briandconnelly/mcp-server-ipinfo

Get notified when new releases ship.

Sign up free

About briandconnelly/mcp-server-ipinfo

IP address geolocation and network information using IPInfo API

All releases →

Related context

Earlier breaking changes

  • v0.6.0 Removed deprecated aliases get_ip_details, get_residential_proxy_info, get_map_url.
  • v0.6.0 detail="summary" now omits heavy nested blocks entirely.
  • v0.6.0 ipinfo_lookup_ips now defaults detail to "summary" (was "full").

Beta — feedback welcome: [email protected]