Advertise
MCP.so
Sign In
R

Rocky Geo MCP Server

@racccoinorg

Repository

Basic information

Category

Developer Tools

Transports

stdio

Author

racccoinorg

Submitted by

Ruslan

About Rocky Geo MCP Server

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

Rocky Geo MCP Server 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>"
      }
    }
  }
}

Rocky Geo MCP Server 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

Frequently asked questions

1

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.

2

What is the batch size limit for IP lookups?

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

3

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.

4

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`.

5

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

More Developer Tools MCP servers

Raccha AI

Shree Mandadi

MCP-first toolbox for agents: namespaced key-value storage, a FIFO queue, auth, and a handful of stateless utility tools (JWT decode, hashing, cert inspection, CIDR math). Free while in early access. This repository is a

Pugi

Pugi Inc.

Pugi is an AI product team in your chat. Describe a business in a few sentences and Pugi plans, designs, builds and checks a real website, shows a live preview, and puts it live on its own address. Ask for changes in pla

Crawl Readiness

Grubbomatic

AI SEO tools for MCP clients — audit whether AI crawlers can read a website, validate JSON-LD and robots.txt, and generate llms.txt, AI-crawler-aware robots.txt, and JSON-LD schema without leaving the conversation.

GripForge

gripforgeai

The tools your AI needs to make your games. Turn prompts into production-ready game assets — animated characters with their weapons attached, seamless textures, terrain, VFX, HUDs — and playable game kits Unity, Godot, U

1

Mcp-Warden

ermoluk

Local-first credential broker for MCP. AI coding agents (Claude Code, Cursor, Codex…) call APIs, SSH and databases through scoped presets; secrets stay in your OS keychain and never enter the agent's context.

4
Advertise