NetLoc8 MCP Server

Note: This repository is a read-only mirror. Please do not submit issues or pull requests here; contributions and development are managed internally.

⚠️ Deprecated: This Go binary is replaced by the @netloc8/mcp npm package and the hosted server at mcp.netloc8.com. See Migration below.

# New install (no Go required):
npx --yes --prefer-online @netloc8/mcp@latest

An MCP server that gives AI assistants access to NetLoc8 — IP geolocation deployed to 300+ edge locations worldwide.

Works with or without an API key. Without a key, you get country-level geo data and local utility tools. With a free key, you unlock city-level detail, coordinates, timezone, and account management.

Why?

AI coding assistants run into IP geolocation constantly — parsing access logs, debugging proxy chains, geo-routing traffic, checking EU compliance, verifying CDN behavior. Without an MCP server, you have to copy-paste results from a browser tab. With this server, your AI assistant resolves IPs inline, in context, without breaking flow.

• Zero-config — go install and add three lines to your MCP config

• Works without a key — country-level lookups and local IP utilities with no sign-up

• 14 tools — geo lookup, timezone, IP validation, subnet math, account management

• 4 guided prompts — IP analysis, security audit, batch comparison, onboarding

• Freemium built in — unauthenticated users see upgrade hints for city-level data

Related MCP server: IP Geolocation MCP Server

Example

Ask your AI assistant:

Where is 8.8.8.8?

The assistant calls geolocate_ip and responds with something like:

8.8.8.8 is located in Mountain View, California, US.

  Country     United States (US) 🇺🇸
  Region      California (CA)
  City        Mountain View
  Coordinates 37.386, -122.084
  Timezone    America/Los_Angeles (UTC-07:00)
  ASN         AS15169
  Org         Google LLC
  EU member   No

Other things you can ask:

Install

Requires Go 1.26+.

go install github.com/netloc8/netloc8-mcp@latest

Configuration

Claude Code

One-liner:

claude mcp add --env NETLOC8_API_KEY=sk_live_YOUR_KEY netloc8 -- netloc8-mcp

Or add to .mcp.json in your project root (committable):

{
  "mcpServers": {
    "netloc8": {
      "command": "netloc8-mcp",
      "env": {
        "NETLOC8_API_KEY": "sk_live_YOUR_KEY"
      }
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "netloc8": {
      "command": "netloc8-mcp",
      "env": {
        "NETLOC8_API_KEY": "sk_live_YOUR_KEY"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root (or ~/.cursor/mcp.json for global):

{
  "mcpServers": {
    "netloc8": {
      "command": "netloc8-mcp",
      "env": {
        "NETLOC8_API_KEY": "sk_live_YOUR_KEY"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json in your project root:

{
  "servers": {
    "netloc8": {
      "command": "netloc8-mcp",
      "env": {
        "NETLOC8_API_KEY": "sk_live_YOUR_KEY"
      }
    }
  }
}

OpenAI Codex

One-liner:

codex mcp add --env NETLOC8_API_KEY=sk_live_YOUR_KEY netloc8 -- netloc8-mcp

Or add to ~/.codex/config.toml (global) or .codex/config.toml (project):

[mcp_servers.netloc8]
command = "netloc8-mcp"
env = { NETLOC8_API_KEY = "sk_live_YOUR_KEY" }

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "netloc8": {
      "command": "netloc8-mcp",
      "env": {
        "NETLOC8_API_KEY": "sk_live_YOUR_KEY"
      }
    }
  }
}

Antigravity

Add to ~/.gemini/config/mcp_config.json:

{
  "mcpServers": {
    "netloc8": {
      "command": "netloc8-mcp",
      "env": {
        "NETLOC8_API_KEY": "sk_live_YOUR_KEY"
      }
    }
  }
}

No API key? Remove the "env" block entirely. The server starts in unauthenticated mode with country-level geo lookups and local tools. Sign up for a free key at netloc8.com to unlock full features.

Environment Variables

Available Tools

Geo Lookup (work with or without API key)

Local Utilities (no API call, no quota)

Account Management (requires API key)

Prompts

Prompts are guided workflows that chain multiple tools together. Select them from your MCP client's prompt picker, or just describe what you want — most clients will match you to the right prompt automatically.

Resources

What You Get

Links

• NetLoc8 — Sign up (free, no credit card)

• Documentation

• Go SDK

• npm packages

• MCP Specification

Migration

This Go binary server is deprecated in favor of:

1. npm package — @netloc8/mcp — same tools, no Go required

2. Hosted server — mcp.netloc8.com — zero install, OAuth 2.1 auth

Migrate to npm package

Replace your MCP client config:

 {
   "mcpServers": {
     "netloc8": {
-      "command": "/path/to/netloc8-mcp",
+      "command": "npx",
+      "args": ["--yes", "--prefer-online", "@netloc8/mcp@latest"],
       "env": {
         "NETLOC8_API_KEY": "sk_live_YOUR_KEY"
       }
     }
   }
 }

All 14 tools, 4 prompts, and 2 resources are identical — no client-side changes needed.

License

Elastic License 2.0 (ELv2)