MCP.so
Sign In
R

Rocky Geo Mcp

@racccoinorg

Repository

About Rocky Geo Mcp

MCP (Model Context Protocol) server that wraps the RockyGeo IP geolocation API hosted on RapidAPI. Lets MCP-compatible clients (Claude Desktop, Claude Code, etc.) perform IPv4/IPv6 geolocation lookups via tool calls

#ip#geo#api#mcp#rapidapi

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "rockygeo": {
      "command": "node",
      "args": [
        "/Users/cyborg97/rockygeomcp/dist/index.js"
      ],
      "env": {
        "RAPIDAPI_KEY": "<your-key>"
      }
    }
  }
}

Tools

3

`{ ip: string }` → geolocation for one IP. Private/reserved IPs return `{ found: false }`.

`{ ips: string[] }` (1–100) → `{ results: { [ip]: ... } }`.

`{}` → `{ status, dataVersion, lastSyncAt, uptime }`.

Overview

What is Rocky Geo Mcp?

A Model Context Protocol (MCP) server that wraps the RockyGeo IP geolocation API on RapidAPI. It lets MCP-compatible clients like Claude Desktop or Claude Code perform IPv4/IPv6 geolocation lookups via tool calls.

How to use Rocky Geo Mcp?

Install with npm install && npm run build, then configure the RAPIDAPI_KEY environment variable (or pass via --api-key). Add the server to your MCP client config (e.g., claude_desktop_config.json) using the node command pointing at the built dist/index.js file.

Key features of Rocky Geo Mcp

  • Single‑IP geolocation via lookup_ip tool
  • Batch geolocation (1–100 IPs) via lookup_ips_batch
  • Health check endpoint (health_check) returning status and data version
  • Supports both IPv4 and IPv6 addresses
  • Configurable base URL for self‑hosted RockyGeo instances
  • Private/reserved IPs return { found: false }

Use cases of Rocky Geo Mcp

  • Look up the geographical location of an IP address for security analysis
  • Enrich log data by batch‑geolocating multiple IPs at once
  • Verify connectivity and data freshness of the geolocation service

FAQ from Rocky Geo Mcp

How do I handle private or reserved IP addresses?

The server returns { found: false } for private or reserved IPs, indicating no geolocation data is available.

What is the batch size limit for IP lookups?

The lookup_ips_batch tool accepts between 1 and 100 IP addresses per call.

Is an API key required?

Yes, a RapidAPI key (RAPIDAPI_KEY) is required and must be set either as an environment variable or passed with --api-key. The free RapidAPI plan allows 1 request per second.

Can I use a self‑hosted RockyGeo backend?

Yes, set the ROCKYGEO_BASE_URL environment variable to point at your own instance. The default is https://rocky-geo.p.rapidapi.com/v1.

How are tests run?

End‑to‑end integration tests are in tests/integration.test.js and can be run with npm test. They hit the live RockyGeo API, so they consume RapidAPI quota and may be rate‑limited on the free plan.

Frequently asked questions

How do I handle private or reserved IP addresses?

The server returns `{ found: false }` for private or reserved IPs, indicating no geolocation data is available.

What is the batch size limit for IP lookups?

The `lookup_ips_batch` tool accepts between 1 and 100 IP addresses per call.

Is an API key required?

Yes, a RapidAPI key (`RAPIDAPI_KEY`) is required and must be set either as an environment variable or passed with `--api-key`. The free RapidAPI plan allows 1 request per second.

Can I use a self‑hosted RockyGeo backend?

Yes, set the `ROCKYGEO_BASE_URL` environment variable to point at your own instance. The default is `https://rocky-geo.p.rapidapi.com/v1`.

How are tests run?

End‑to‑end integration tests are in `tests/integration.test.js` and can be run with `npm test`. They hit the live RockyGeo API, so they consume RapidAPI quota and may be rate‑limited on the free plan.

Comments

Basic information

Category

Developer Tools

Transports

stdio

Author

racccoinorg

Submitted by

Ruslan

More Developer Tools MCP servers

CodeSentinel

icohangar-ops

Codebase health as MCP tools: dead code, circular dependencies, coupling, architectural drift.

Altronis

sypherin

MCP server + CLI for Altronis — Singapore AI consulting. Ask the Lyra consultant, generate a grant-matched AI transformation plan, pull curated SG AI events/news. Read-only, wraps altronis.sg.

CircleCI MCP Server

CircleCI

Manage CI/CD pipelines, debug failed builds, and optimize test suites directly from your AI agents - no terminal required. The CircleCI MCP Server is a remote server hosted by CircleCI that connects AI tools and agents

Perfex CRM

themesic

Turn Perfex CRM into an AI-ready workspace. This MCP server exposes your full REST API to Claude, ChatGPT and any AI agent, so leads, invoices and tasks are one prompt away.

1

Vibgrate MCP

Vibgrate

Query your team's drift, vulnerability, and migration data from any AI assistant. Vibgrate MCP connects Cursor, Claude, ChatGPT, Windsurf, or VS Code to Vibgrate Cloud: 51 tools for DriftScores, CVEs and EOL runtimes, up

3