IPinfo MCP Server
IPinfo API MCP Server for Residential Proxy, Lite, Core, and Plus bundles.
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
| Variable | Default | Description |
|---|---|---|
IPINFO_TOKEN |
API token | |
IPINFO_API_BASE_URL |
https://api.ipinfo.io |
Base URL for api.ipinfo.io endpoints |
IPINFO_LEGACY_BASE_URL |
https://ipinfo.io |
Base URL for legacy ipinfo.io endpoints (e.g. /me) |
IPINFO_CACHE_TTL |
3600 |
Seconds a cached IP result stays fresh |
IPINFO_TRANSPORT |
stdio |
Transport type (stdio or http) |
IPINFO_HOST |
0.0.0.0 |
HTTP host (only for http transport) |
IPINFO_PORT |
8000 |
HTTP 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 .
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ipinfo_mcp_server-0.1.10.tar.gz.
File metadata
- Download URL: ipinfo_mcp_server-0.1.10.tar.gz
- Upload date:
- Size: 97.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
619d0d68ae778622e609f02ebf7dc2bee5e45a462288d339823898498b3c8244
|
|
| MD5 |
6afc5ca9a008c58b80dfe19951be9c08
|
|
| BLAKE2b-256 |
57550d380504fc364b3992209cac0d8d94efae4e129c81830841d3e7ff903459
|
File details
Details for the file ipinfo_mcp_server-0.1.10-py3-none-any.whl.
File metadata
- Download URL: ipinfo_mcp_server-0.1.10-py3-none-any.whl
- Upload date:
- Size: 41.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
eacc1730e1b3a6c91fdf68898a27fb6ee10da307260c3b9d8859be9c3b38485c
|
|
| MD5 |
61198fddab106503b13b8fc1317b2eb8
|
|
| BLAKE2b-256 |
58458e2d141ac249bbb4c613c3ee57feae7eefa78fb744c3fae1d8ec4bca7850
|
