ipinfo-mcp-server 0.2.2__tar.gz → 0.2.3__tar.gz

ipinfo_mcp_server-0.2.3/.cursor-plugin/marketplace.json

@@ -0,0 +1,17 @@
+{
+  "name": "ipinfo",
+  "owner": {
+    "name": "IPinfo",
+    "email": "support@ipinfo.io"
+  },
+  "metadata": {
+    "description": "Official IPinfo plugins"
+  },
+  "plugins": [
+    {
+      "name": "ipinfo",
+      "source": "./plugins/ipinfo",
+      "description": "IP address intelligence from IPinfo: geolocation, network ownership, and VPN, proxy, Tor, and residential proxy detection."
+    }
+  ]
+}

{ipinfo_mcp_server-0.2.2 → ipinfo_mcp_server-0.2.3}/.mcpbignore

@@ -9,3 +9,5 @@ tests
 .env.example
 .gitignore
 Dockerfile
+plugins
+.cursor-plugin

{ipinfo_mcp_server-0.2.2 → ipinfo_mcp_server-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ipinfo-mcp-server
-Version: 0.2.2
+Version: 0.2.3
 Summary: Official IPinfo MCP Server - IP intelligence tools for AI assistants
 Author-email: IPinfo <support@ipinfo.io>
 License-Expression: Apache-2.0
@@ -139,18 +139,19 @@ Takes no parameters. Returns `token` (omitted when connected with OAuth), `reque
 
 The server is configured through environment variables:
 
-| Variable                  | Default                          | Description                                                             |
-| ------------------------- | -------------------------------- | ----------------------------------------------------------------------- |
-| `IPINFO_TOKEN`            |                                  | API token (stdio transport; over HTTP the token comes from the request) |
-| `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`)                                      |
-| `HOST`                    | `0.0.0.0`                        | HTTP host (only for `http` transport)                                   |
-| `PORT`                    | `8000`                           | HTTP port (only for `http` transport)                                   |
-| `IPINFO_OAUTH_ISSUER`     |                                  | OAuth issuer whose access tokens are accepted; OAuth is off when unset  |
-| `IPINFO_MCP_RESOURCE_URL` |                                  | Public URL of this server, required with `IPINFO_OAUTH_ISSUER`          |
-| `IPINFO_OAUTH_JWKS_URI`   | `<issuer>/.well-known/jwks.json` | Where the issuer publishes its signing keys                             |
+| Variable                       | Default                          | Description                                                                           |
+| ------------------------------ | -------------------------------- | ------------------------------------------------------------------------------------- |
+| `IPINFO_TOKEN`                 |                                  | API token (stdio transport; over HTTP the token comes from the request)               |
+| `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`)                                                    |
+| `HOST`                         | `0.0.0.0`                        | HTTP host (only for `http` transport)                                                 |
+| `PORT`                         | `8000`                           | HTTP port (only for `http` transport)                                                 |
+| `IPINFO_OAUTH_ISSUER`          |                                  | OAuth issuer whose access tokens are accepted; OAuth is off when unset                |
+| `IPINFO_MCP_RESOURCE_URL`      |                                  | Public URL of this server, required with `IPINFO_OAUTH_ISSUER`                        |
+| `IPINFO_OAUTH_JWKS_URI`        | `<issuer>/.well-known/jwks.json` | Where the issuer publishes its signing keys                                           |
+| `IPINFO_OPENAI_APPS_CHALLENGE` |                                  | Token served at `/.well-known/openai-apps-challenge` for OpenAI's domain verification |
 
 With the `http` transport, each request authenticates with its own `Authorization: Bearer <token>` header.
 

{ipinfo_mcp_server-0.2.2 → ipinfo_mcp_server-0.2.3}/README.md

@@ -122,18 +122,19 @@ Takes no parameters. Returns `token` (omitted when connected with OAuth), `reque
 
 The server is configured through environment variables:
 
-| Variable                  | Default                          | Description                                                             |
-| ------------------------- | -------------------------------- | ----------------------------------------------------------------------- |
-| `IPINFO_TOKEN`            |                                  | API token (stdio transport; over HTTP the token comes from the request) |
-| `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`)                                      |
-| `HOST`                    | `0.0.0.0`                        | HTTP host (only for `http` transport)                                   |
-| `PORT`                    | `8000`                           | HTTP port (only for `http` transport)                                   |
-| `IPINFO_OAUTH_ISSUER`     |                                  | OAuth issuer whose access tokens are accepted; OAuth is off when unset  |
-| `IPINFO_MCP_RESOURCE_URL` |                                  | Public URL of this server, required with `IPINFO_OAUTH_ISSUER`          |
-| `IPINFO_OAUTH_JWKS_URI`   | `<issuer>/.well-known/jwks.json` | Where the issuer publishes its signing keys                             |
+| Variable                       | Default                          | Description                                                                           |
+| ------------------------------ | -------------------------------- | ------------------------------------------------------------------------------------- |
+| `IPINFO_TOKEN`                 |                                  | API token (stdio transport; over HTTP the token comes from the request)               |
+| `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`)                                                    |
+| `HOST`                         | `0.0.0.0`                        | HTTP host (only for `http` transport)                                                 |
+| `PORT`                         | `8000`                           | HTTP port (only for `http` transport)                                                 |
+| `IPINFO_OAUTH_ISSUER`          |                                  | OAuth issuer whose access tokens are accepted; OAuth is off when unset                |
+| `IPINFO_MCP_RESOURCE_URL`      |                                  | Public URL of this server, required with `IPINFO_OAUTH_ISSUER`                        |
+| `IPINFO_OAUTH_JWKS_URI`        | `<issuer>/.well-known/jwks.json` | Where the issuer publishes its signing keys                                           |
+| `IPINFO_OPENAI_APPS_CHALLENGE` |                                  | Token served at `/.well-known/openai-apps-challenge` for OpenAI's domain verification |
 
 With the `http` transport, each request authenticates with its own `Authorization: Bearer <token>` header.
 

{ipinfo_mcp_server-0.2.2 → ipinfo_mcp_server-0.2.3}/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": "0.4",
   "name": "ipinfo-mcp-server",
   "display_name": "IPinfo",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "IP address intelligence tools: geolocation, ASN, privacy detection, residential proxy checks, and more.",
   "author": {
     "name": "IPinfo",

ipinfo_mcp_server-0.2.3/plugins/ipinfo/.cursor-plugin/plugin.json

@@ -0,0 +1,20 @@
+{
+  "name": "ipinfo",
+  "displayName": "IPinfo",
+  "version": "1.0.0",
+  "description": "IP address intelligence from IPinfo: geolocation, network ownership, and VPN, proxy, Tor, and residential proxy detection.",
+  "author": {
+    "name": "IPinfo",
+    "email": "support@ipinfo.io"
+  },
+  "homepage": "https://ipinfo.io/developers/mcp-server",
+  "repository": "https://github.com/ipinfo/mcp",
+  "license": "Apache-2.0",
+  "keywords": ["ip", "geolocation", "asn", "vpn", "proxy", "tor", "residential-proxy", "security"],
+  "logo": "assets/logo.png",
+  "mcpServers": {
+    "ipinfo": {
+      "url": "https://mcp.ipinfo.io/"
+    }
+  }
+}

ipinfo_mcp_server-0.2.3/plugins/ipinfo/README.md

@@ -0,0 +1,47 @@
+# IPinfo plugin
+
+Connects your AI assistant to the hosted [IPinfo MCP Server](https://github.com/ipinfo/mcp), so it can answer questions about IP addresses with [IPinfo](https://ipinfo.io) data: where an IP is located, which company or network it belongs to, and whether it's a VPN, proxy, Tor exit node, or residential proxy.
+
+## Setup
+
+Install the plugin, then sign in with your IPinfo account when your client asks. There is nothing else to configure: the plugin connects to `https://mcp.ipinfo.io/` and authenticates through OAuth.
+
+You need an IPinfo account. Sign up for free at [ipinfo.io/signup](https://ipinfo.io/signup).
+
+## Tools
+
+| Tool                             | Description                                                       | Plan requirement                      |
+| -------------------------------- | ----------------------------------------------------------------- | ------------------------------------- |
+| `ipinfo_lookup`                  | Full IP data: geolocation, network, and metadata                  | Any; `detailed: true` needs Core/Plus |
+| `ipinfo_geolocate`               | Geographic location                                               | Any; `detailed: true` needs Core/Plus |
+| `ipinfo_asn`                     | Autonomous system (network ownership)                             | Any; `detailed: true` needs Core/Plus |
+| `ipinfo_check_privacy`           | VPN, proxy, relay, Tor, hosting, anycast, mobile, satellite flags | Paid plan                             |
+| `ipinfo_check_residential_proxy` | Residential proxy detection                                       | Residential Proxy access              |
+| `ipinfo_quota`                   | API usage and remaining quota                                     | Any                                   |
+
+All tools are read-only. Try asking:
+
+- "Where is the IP address 8.8.8.8 located?"
+- "Is 185.220.101.1 a VPN, proxy, or Tor exit node?"
+- "Which company operates the network for 1.1.1.1?"
+
+## Support
+
+- Documentation: [ipinfo.io/developers/mcp-server](https://ipinfo.io/developers/mcp-server)
+- Support: [support.ipinfo.io](https://support.ipinfo.io/hc/en-us) or support@ipinfo.io
+- Privacy policy: [ipinfo.io/privacy-policy](https://ipinfo.io/privacy-policy)
+
+## Packaging
+
+This folder is both an [Agent Plugins](https://agent-plugins.org) package and a Cursor plugin:
+
+- `plugin.json` and `mcp.json` are the portable package. OpenAI-specific listing and review details live under `extensions.com.openai` in `plugin.json`.
+- `.cursor-plugin/plugin.json` adds the Cursor listing details, such as the logo. The repository's `.cursor-plugin/marketplace.json` points Cursor at this folder.
+
+To build the ZIP for the OpenAI plugin portal, run this from the `plugins` directory. It leaves out the Cursor manifest:
+
+```bash
+zip -r -X ipinfo-plugin.zip ipinfo -x '*.DS_Store' 'ipinfo/.cursor-plugin/*'
+```
+
+Bump `version` in both manifests before every new upload.

ipinfo_mcp_server-0.2.3/plugins/ipinfo/mcp.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
+  "mcpServers": {
+    "ipinfo": {
+      "type": "streamable-http",
+      "url": "https://mcp.ipinfo.io/"
+    }
+  }
+}

ipinfo_mcp_server-0.2.3/plugins/ipinfo/plugin.json

@@ -0,0 +1,109 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "ipinfo",
+  "version": "1.0.0",
+  "description": "IP address intelligence from IPinfo: geolocation, network ownership, and VPN, proxy, Tor, and residential proxy detection.",
+  "author": {
+    "name": "IPinfo",
+    "email": "support@ipinfo.io",
+    "url": "https://ipinfo.io"
+  },
+  "homepage": "https://ipinfo.io/developers/mcp-server",
+  "repository": "https://github.com/ipinfo/mcp",
+  "license": "Apache-2.0",
+  "keywords": [
+    "ip",
+    "geolocation",
+    "asn",
+    "vpn",
+    "proxy",
+    "tor",
+    "residential-proxy",
+    "security"
+  ],
+  "extensions": {
+    "com.openai": {
+      "interface": {
+        "displayName": "IPinfo",
+        "shortDescription": "IP geolocation and privacy",
+        "longDescription": "Look up IP addresses with IPinfo data. Find where an IP is located, down to the city, region, coordinates, timezone, and postal code. See which company or network owns it, with its ASN, organization name, domain, and network type. Check whether it belongs to a VPN, proxy, relay, or Tor exit node, whether it is a known residential proxy, and whether it is a hosting, anycast, mobile, or satellite address. You can also check your IPinfo API usage and remaining quota.\n\nUseful for security and fraud investigations, log and traffic analysis, and any question about where traffic comes from. Lookups accept many IPs at once, IPv4 or IPv6.\n\nSign in with your IPinfo account to connect. Every account includes country, continent, and ASN data. City-level geolocation, privacy detection, and residential proxy detection are available when your IPinfo plan includes them. Private, reserved, and bogon addresses aren't looked up. All tools are read-only and never change your account.",
+        "developerName": "IPinfo",
+        "category": "Data & Analytics",
+        "capabilities": [
+          "Geolocate IP addresses",
+          "Identify network owners and ASNs",
+          "Detect VPNs, proxies, relays, and Tor",
+          "Detect residential proxies",
+          "Check API usage and quota"
+        ],
+        "websiteURL": "https://ipinfo.io",
+        "supportURL": "https://support.ipinfo.io/",
+        "privacyPolicyURL": "https://ipinfo.io/privacy-policy",
+        "termsOfServiceURL": "https://ipinfo.io/terms-of-service",
+        "defaultPrompt": [
+          "Where is the IP address 8.8.8.8 located?",
+          "Is 185.220.101.1 a VPN, proxy, or Tor exit node?",
+          "Which company operates the network for 1.1.1.1?"
+        ],
+        "logo": "./assets/logo.png",
+        "logoDark": "./assets/logo-dark.png",
+        "composerIcon": "./assets/logo.png",
+        "composerIconDark": "./assets/logo-dark.png"
+      },
+      "review": {
+        "test_cases": {
+          "positive": [
+            {
+              "description": "Geolocate an IP address",
+              "prompt": "Where is the IP address 8.8.8.8 located? Include the city and timezone.",
+              "tools_triggered": "ipinfo_geolocate",
+              "expected_behavior": "Reports that 8.8.8.8 is in Mountain View, California, United States, with the America/Los_Angeles timezone."
+            },
+            {
+              "description": "Identify who owns a network",
+              "prompt": "Which company operates the network for 1.1.1.1?",
+              "tools_triggered": "ipinfo_asn",
+              "expected_behavior": "Reports that 1.1.1.1 belongs to AS13335, Cloudflare, Inc. (cloudflare.com)."
+            },
+            {
+              "description": "Detect anonymity services",
+              "prompt": "Is 185.220.101.1 a VPN, proxy, or Tor exit node?",
+              "tools_triggered": "ipinfo_check_privacy",
+              "expected_behavior": "Reports that 185.220.101.1 is anonymous and flagged as a Tor exit node, listing which of the VPN, proxy, relay, and Tor flags are set."
+            },
+            {
+              "description": "Check for a residential proxy",
+              "prompt": "Is 8.8.8.8 a residential proxy?",
+              "tools_triggered": "ipinfo_check_residential_proxy",
+              "expected_behavior": "Reports that 8.8.8.8 is not a known residential proxy."
+            },
+            {
+              "description": "Check API usage",
+              "prompt": "How many IPinfo API requests have I used this month, and how many do I have left?",
+              "tools_triggered": "ipinfo_quota",
+              "expected_behavior": "Reports the requests used today and this month, the plan limit, and the remaining requests for the connected account."
+            }
+          ],
+          "negative": [
+            {
+              "description": "Changing firewall or network settings is out of scope; the plugin is read-only and should explain it can't block addresses.",
+              "prompt": "Block the IP address 203.0.113.5 on my firewall."
+            },
+            {
+              "description": "IP data doesn't identify people; the plugin should decline to find a person's identity or home address.",
+              "prompt": "Find the name and home address of the person using the IP 8.8.8.8."
+            },
+            {
+              "description": "The request has nothing to do with IP addresses, so no IPinfo tool should be called.",
+              "prompt": "Write a Python function that sorts a list of numbers."
+            }
+          ]
+        },
+        "commerce": false
+      },
+      "publication": {
+        "release_notes": "Initial release: IP geolocation, network ownership, privacy and residential proxy detection, and API quota checks."
+      }
+    }
+  }
+}

{ipinfo_mcp_server-0.2.2 → ipinfo_mcp_server-0.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ipinfo-mcp-server"
-version = "0.2.2"
+version = "0.2.3"
 description = "Official IPinfo MCP Server - IP intelligence tools for AI assistants"
 readme = "README.md"
 license = "Apache-2.0"

{ipinfo_mcp_server-0.2.2 → ipinfo_mcp_server-0.2.3}/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.ipinfo/mcp",
   "title": "IPinfo",
   "description": "Official IPinfo MCP Server - IP intelligence tools for AI assistants",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "websiteUrl": "https://ipinfo.io",
   "repository": {
     "url": "https://github.com/ipinfo/mcp",
@@ -26,7 +26,7 @@
       "registryType": "pypi",
       "registryBaseUrl": "https://pypi.org",
       "identifier": "ipinfo-mcp-server",
-      "version": "0.2.2",
+      "version": "0.2.3",
       "runtimeHint": "uvx",
       "transport": {
         "type": "stdio"

{ipinfo_mcp_server-0.2.2 → ipinfo_mcp_server-0.2.3}/src/ipinfo_mcp/server.py

@@ -10,7 +10,7 @@ from typing import TypedDict, cast
 import uvicorn
 from fastmcp import FastMCP
 from fastmcp.server.auth import MultiAuth
-from starlette.responses import HTMLResponse, JSONResponse
+from starlette.responses import HTMLResponse, JSONResponse, PlainTextResponse
 from starlette.types import ASGIApp, Receive, Scope, Send
 
 from ipinfo_mcp.auth import create_auth
@@ -132,10 +132,13 @@ class LandingPageMiddleware:
 
     MCP clients use POST or GET with Accept: text/event-stream,
     so a plain GET with Accept: text/html is always a browser.
+
+    Also serves the token OpenAI checks to verify we own the domain, when one is set.
     """
 
-    def __init__(self, app: ASGIApp) -> None:
+    def __init__(self, app: ASGIApp, *, openai_apps_challenge: str | None = None) -> None:
         self.app = app
+        self.openai_apps_challenge = openai_apps_challenge
 
     async def __call__(self, scope: Scope, receive: Receive, send: Send) -> None:
         if scope["type"] == "http" and scope["method"] == "GET":
@@ -144,6 +147,10 @@ class LandingPageMiddleware:
                 response = JSONResponse({"status": "ok", "version": SERVER_VERSION})
                 await response(scope, receive, send)
                 return
+            if path == "/.well-known/openai-apps-challenge" and self.openai_apps_challenge:
+                response = PlainTextResponse(self.openai_apps_challenge)
+                await response(scope, receive, send)
+                return
             if path == "/":
                 headers = dict(cast(list[tuple[bytes, bytes]], scope.get("headers", [])))
                 accept = headers.get(b"accept", b"").decode()
@@ -160,7 +167,7 @@ def create_app() -> ASGIApp:
         path="/",
         stateless_http=True,
     )
-    return LandingPageMiddleware(mcp_app)
+    return LandingPageMiddleware(mcp_app, openai_apps_challenge=os.environ.get("IPINFO_OPENAI_APPS_CHALLENGE"))
 
 
 app = create_app()

{ipinfo_mcp_server-0.2.2 → ipinfo_mcp_server-0.2.3}/uv.lock

@@ -460,7 +460,7 @@ wheels = [
 
 [[package]]
 name = "ipinfo-mcp-server"
-version = "0.2.2"
+version = "0.2.3"
 source = { editable = "." }
 dependencies = [
     { name = "fastmcp" },