New:Microsoft Teams Notifications Are Now Available in Socket.Learn more
Get Started

ipinfo-mcp-server

Package Overview
Dependencies
Maintainers
1
Versions
4
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

ipinfo-mcp-server

Official IPinfo MCP Server - IP intelligence tools for AI assistants

pipPyPI
Version
0.1.12
Weekly downloads
195
Maintainers
1
Created

IPinfo MCP Server

IPinfo API MCP Server for Residential Proxy, Lite, Core, and Plus bundles.

OpenSSF Scorecard smithery badge

Development

Prerequisites

  • Python 3.14+
  • uv

Setup

uv sync --dev
cp .env.example .env
# Add your IPinfo token to .env

Get a free API token at ipinfo.io/signup.

Running the server

The server supports two transports: stdio (default) and HTTP.

# stdio (default, used by MCP clients)
uv run ipinfo-mcp-server

# HTTP
IPINFO_TRANSPORT=http IPINFO_HOST=0.0.0.0 IPINFO_PORT=8000 uv run ipinfo-mcp-server

Environment variables

VariableDefaultDescription
IPINFO_TOKENAPI token
IPINFO_API_BASE_URLhttps://api.ipinfo.ioBase URL for api.ipinfo.io endpoints
IPINFO_LEGACY_BASE_URLhttps://ipinfo.ioBase URL for legacy ipinfo.io endpoints (e.g. /me)
IPINFO_CACHE_TTL3600Seconds a cached IP result stays fresh
IPINFO_TRANSPORTstdioTransport type (stdio or http)
IPINFO_HOST0.0.0.0HTTP host (only for http transport)
IPINFO_PORT8000HTTP port (only for http transport)

Tests

# All tests tests
uv run pytest

# Integration tests (requires IPINFO_TOKEN)
uv run pytest tests/integration/

Integration tests hit the real IPinfo API and validate response structure only (no exact value assertions). They require IPINFO_TOKEN to be set and are skipped otherwise.

Type checking

uv run pyright

Linting

uv run ruff check .
uv run ruff format .

FAQs

Related posts