@unclick/ipapi-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,15 @@
+Apache License 2.0
+
+Copyright (c) 2026 UnClick / malamutemayhem
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,34 @@
+# IP Geolocation MCP by UnClick
+
+IP address geolocation and batch lookup with country, city, region, ISP, and timezone.
+
+> By UnClick. 180+ tools plus persistent agent memory in one install: https://unclick.world
+
+## Install
+
+Installs straight from GitHub, no npm account needed.
+
+```json
+{
+  "mcpServers": {
+    "ipapi": {
+      "command": "npx",
+      "args": ["-y", "https://github.com/malamutemayhem/unclick/releases/download/standalone-mcps-latest/ipapi.tgz"]
+    }
+  }
+}
+```
+
+## Tools
+
+- `ip_lookup`
+- `ip_batch`
+
+## Want the rest?
+
+This is one connector. [UnClick](https://unclick.world) bundles 180+ tools plus
+persistent cross-session agent memory in a single install.
+
+## License
+
+Apache-2.0

package/dist/index.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+// IP Geolocation MCP. Standalone MCP server by UnClick.
+// By UnClick. 180+ tools plus persistent agent memory in one install: https://unclick.world
+//
+// Generated from the UnClick connector by scripts/generate-standalone-mcp.mjs.
+// Edit the connector in the UnClick monorepo, not here.
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { ipLookup, ipBatch, } from "./ipapi-tool.js";
+const TOOLS = [
+    {
+        name: "ip_lookup",
+        description: "Look up geolocation for an IP address.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                ip: { type: "string" },
+                api_key: { type: "string" },
+            },
+            required: ["ip"],
+        },
+    },
+    {
+        name: "ip_batch",
+        description: "Batch IP address geolocation lookup.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                ips: { type: "array", items: {}, description: "Array of IP address strings" },
+                api_key: { type: "string" },
+            },
+            required: ["ips"],
+        },
+    }
+];
+const HANDLERS = {
+    ip_lookup: (args) => ipLookup(args),
+    ip_batch: (args) => ipBatch(args),
+};
+const server = new Server({ name: "io.github.malamutemayhem/ipapi", version: "0.1.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const handler = HANDLERS[req.params.name];
+    if (!handler) {
+        return { content: [{ type: "text", text: `Unknown tool: ${req.params.name}` }], isError: true };
+    }
+    try {
+        const result = await handler((req.params.arguments ?? {}));
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: message }], isError: true };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    process.stderr.write(`[ipapi-mcp] fatal: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});

package/dist/ipapi-tool.js

@@ -0,0 +1,77 @@
+// IP geolocation integration for the UnClick MCP server.
+// Uses the ip-api.com free tier via fetch - no auth required (100 req/min).
+// Returns country, region, city, lat/lon, ISP, timezone, and more.
+const IPAPI_BASE = "http://ip-api.com";
+// --- API helper ---
+async function ipapiGet(ip) {
+    const path = ip ? `/${encodeURIComponent(ip)}` : "/";
+    const url = `${IPAPI_BASE}/json${path}?fields=66846719`;
+    const response = await fetch(url, { headers: { "Accept": "application/json" } });
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status} from ip-api.com`);
+    }
+    const data = await response.json();
+    if (data.status === "fail") {
+        throw new Error(`ip-api error: ${data.message ?? "Query failed"}`);
+    }
+    return data;
+}
+function normalizeIpData(data) {
+    return {
+        ip: data.query,
+        status: data.status,
+        country: data.country,
+        country_code: data.countryCode,
+        region: data.regionName,
+        region_code: data.region,
+        city: data.city,
+        zip: data.zip,
+        lat: data.lat,
+        lon: data.lon,
+        timezone: data.timezone,
+        isp: data.isp,
+        org: data.org,
+        as: data.as,
+        mobile: data.mobile,
+        proxy: data.proxy,
+        hosting: data.hosting,
+    };
+}
+// --- Operations ---
+export async function ipLookup(args) {
+    const ip = String(args.ip ?? "").trim();
+    // Empty ip will look up the caller's IP
+    const data = await ipapiGet(ip);
+    return normalizeIpData(data);
+}
+export async function ipBatch(args) {
+    const addresses = args.addresses;
+    if (!Array.isArray(addresses) || addresses.length === 0) {
+        throw new Error("addresses is required and must be a non-empty array of IP strings.");
+    }
+    if (addresses.length > 100) {
+        throw new Error("addresses array must contain 100 or fewer IPs per request.");
+    }
+    const body = addresses.map((a) => ({
+        query: String(a).trim(),
+        fields: "66846719",
+    }));
+    const response = await fetch(`${IPAPI_BASE}/batch`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json", "Accept": "application/json" },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status} from ip-api.com batch endpoint`);
+    }
+    const results = await response.json();
+    return {
+        count: results.length,
+        results: results.map((r) => {
+            if (r.status === "fail") {
+                return { ip: r.query, error: r.message ?? "Query failed" };
+            }
+            return normalizeIpData(r);
+        }),
+    };
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@unclick/ipapi-mcp",
+  "version": "0.1.0",
+  "mcpName": "io.github.malamutemayhem/ipapi",
+  "description": "IP address geolocation and batch lookup with country, city, region, ISP, and timezone. By UnClick (https://unclick.world).",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "unclick",
+    "ip",
+    "geolocation",
+    "network"
+  ],
+  "author": "UnClick (https://unclick.world)",
+  "type": "module",
+  "bin": {
+    "ipapi-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "server.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.15.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "@types/node": "^22.0.0"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/malamutemayhem/unclick.git",
+    "directory": "packages/standalone/ipapi-mcp"
+  },
+  "homepage": "https://unclick.world"
+}

package/server.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.malamutemayhem/ipapi",
+  "title": "IP Geolocation MCP by UnClick",
+  "description": "IP address geolocation and batch lookup with country, city, region, ISP, and timezone. By UnClick.",
+  "version": "0.1.0",
+  "websiteUrl": "https://unclick.world",
+  "icons": [
+    {
+      "src": "https://unclick.world/favicon.png",
+      "mimeType": "image/png",
+      "sizes": [
+        "512x512"
+      ]
+    }
+  ],
+  "repository": {
+    "url": "https://github.com/malamutemayhem/unclick.git",
+    "source": "github",
+    "subfolder": "packages/standalone/ipapi-mcp"
+  },
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@unclick/ipapi-mcp",
+      "version": "0.1.0",
+      "runtimeHint": "npx",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}