
IP Geolocation MCP By UnClick
- 4 repo stars
- malamutemayhem/unclick
IP Geolocation MCP is a MCP server that provides IP-to-location and batch lookup tools with country, city, region, ISP, and timezone for your agent.
About
IP Geolocation MCP by UnClick gives your coding agent callable tools to resolve IP addresses into geographic and network hints, including batch lookup, with country, city, region, ISP, and timezone fields as described in the catalog. SaaS developers reach for it during backend work when they need fraud heuristics, locale defaults, support triage, or analytics enrichment without leaving the agent chat to test curl commands. The package follows the UnClick pattern: npm stdio server, npx runtime hint, version 0.1.0, hosted in the unclick monorepo under ipapi-mcp. Treat results as best-effort geo intelligence you validate against your privacy policy and accuracy requirements before relying on them for compliance decisions. It is an integration helper, not a full IP threat intelligence platform or VPN detection suite.
- Single and batch IP geolocation lookups
- Returns country, city, region, ISP, and timezone fields
- stdio MCP via @unclick/ipapi-mcp v0.1.0
- UnClick IP Geolocation MCP with npx stdio transport
- Speeds up geo feature prototyping without bespoke HTTP snippets each session
IP Geolocation MCP By UnClick by the numbers
- Data as of Jul 7, 2026 (Skillselion catalog sync)
claude mcp add ipapi -- npx -y @unclick/ipapi-mcpAdd your badge
Show developers this MCP server is listed on Skillselion. Paste this into your README.
| repo stars | ★ 4 |
|---|---|
| Package | @unclick/ipapi-mcp |
| Transport | STDIO |
| Auth | None |
| Repository | malamutemayhem/unclick ↗ |
What it does
Resolve IP addresses to country, city, region, ISP, and timezone—including batch lookups—while implementing geo-aware backend logic with your agent.
Who is it for?
Best when you're wiring localization, signup analytics, abuse heuristics, or support context that needs quick IP enrichment during build.
Skip if: Security teams needing guaranteed bot or VPN classification, legal-grade geofencing audits, or offline MaxMind-only pipelines without external calls.
What you get
Your agent can run single or batch IP lookups and embed structured geo fields directly into code, tests, and logging designs.
- Structured IP lookup results with country, city, region, ISP, and timezone
- Batch lookup output for test fixtures or admin tooling
- MCP stdio config snippet for repeatable geo queries in development
By the numbers
- Server version 0.1.0
- npm package @unclick/ipapi-mcp
- Supports batch IP lookup per catalog description
README.md
UnClick MCP server
The app store for AI agents. unclick.world
450+ callable endpoints across 178+ tools, available to any MCP-compatible AI client. New tools ship to the API continuously. Your agent picks them up automatically; no package update is needed.
Install
Using the latest GitHub release (no npm account required):
{
"mcpServers": {
"unclick": {
"command": "npx",
"args": ["-y", "https://github.com/malamutemayhem/unclick/releases/latest/download/unclick.tgz"]
}
}
}
Add this to your claude_desktop_config.json (or equivalent for Cursor, Windsurf, etc).
Or install globally from GitHub:
npm install -g https://github.com/malamutemayhem/unclick/releases/latest/download/unclick.tgz
Operational Notes
This repo follows the AGENTS.md fence rules for agent work.
Run
For local web development:
npm run dev
For the API workspace:
npm run dev:api
Test
Run the main test suite:
npm test
Run the production build check:
npm run build
License
UnClick uses a split license. The platform (website, API, and hosted backend
and memory services) is AGPL-3.0 (see LICENSE). The npm client
package @unclick/mcp-server stays MIT, and the standalone connector
packages stay Apache-2.0. Full breakdown and reasoning in
LICENSING.md.
What it does
Gives your agent access to a growing catalog of tools across developer utilities, social media, e-commerce, finance, messaging, media, security, and more. You don't need to install separate packages for each integration. One server provides access to everything in the catalog.
Tool Surface
UnClick exposes a small direct surface for daily agent workflows, plus hidden internal discovery tools for the full catalog.
| Tool group | Tools |
|---|---|
| Memory session protocol | load_memory, save_fact, search_memory, save_identity, save_session |
| Signals and Boardroom coordination | check_signals, read_messages, post_message, create_todo, list_todos, update_todo, complete_todo, create_idea, list_ideas, vote_on_idea, promote_idea_to_todo |
| Hidden internal catalog tools | unclick_search, unclick_browse, unclick_tool_info, unclick_call |
The agent starts with memory, uses direct Boardroom tools for coordination, and can still call the hidden catalog tools by name when it needs dynamic endpoint discovery.
Compatibility and advanced memory operations
- Legacy memory names still work as aliases:
get_startup_context->load_memory,write_session_summary->save_session,add_fact->save_fact,set_business_context->save_identity. - The remaining memory operations are intentionally not listed in
ListToolsand are called throughunclick_callwithendpoint_id: "memory.<op>"(for examplememory.manage_decay,memory.store_code,memory.log_conversation,memory.supersede_fact,memory.upsert_library_doc).
Requirements
- Node.js 18+
- An API key from unclick.world
Set your key as an environment variable:
UNCLICK_API_KEY=your_key_here
Or pass it via the MCP config:
{
"mcpServers": {
"unclick": {
"command": "npx",
"args": ["-y", "https://github.com/malamutemayhem/unclick/releases/latest/download/unclick.tgz"],
"env": {
"UNCLICK_API_KEY": "your_key_here"
}
}
}
}
More
Full catalog, docs, and API keys at unclick.world.
Recommended MCP Servers
How it compares
IP lookup MCP integration, not a WAF skill or hosting provider dashboard.
FAQ
Who is IP Geolocation MCP for?
Developers implementing backend geo or network context features who want IP lookup tools inside Claude Code, Cursor, or Codex.
When should I use IP Geolocation MCP?
Use it in the Build backend phase when you are coding or testing IP-based locale, ISP, or timezone enrichment in your app or API.
How do I add IP Geolocation MCP to my agent?
Register stdio MCP with identifier @unclick/ipapi-mcp, runtimeHint npx v0.1.0, in your agent MCP config and ensure network access to the geolocation provider the server uses.