@unclick/restcountries-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,38 @@
+# REST Countries MCP by UnClick
+
+Country data: flags, currencies, languages, regions, capitals, and more. No API key.
+
+> 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": {
+    "restcountries": {
+      "command": "npx",
+      "args": ["-y", "https://github.com/malamutemayhem/unclick/releases/download/standalone-mcps-latest/restcountries.tgz"]
+    }
+  }
+}
+```
+
+## Tools
+
+- `country_all`
+- `country_by_name`
+- `country_by_code`
+- `country_by_region`
+- `country_by_currency`
+- `country_by_language`
+
+## 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,116 @@
+#!/usr/bin/env node
+// REST Countries 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 { countryAll, countryByName, countryByCode, countryByRegion, countryByCurrency, countryByLanguage, } from "./restcountries-tool.js";
+const TOOLS = [
+    {
+        name: "country_all",
+        description: "Get all countries from REST Countries.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                fields: { type: "string" },
+            },
+        },
+    },
+    {
+        name: "country_by_name",
+        description: "Get a country by name from REST Countries.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                name: { type: "string" },
+                fullText: { type: "boolean" },
+            },
+            required: ["name"],
+        },
+    },
+    {
+        name: "country_by_code",
+        description: "Get a country by code from REST Countries.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                code: { type: "string" },
+            },
+            required: ["code"],
+        },
+    },
+    {
+        name: "country_by_region",
+        description: "Get countries by region from REST Countries.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                region: { type: "string" },
+            },
+            required: ["region"],
+        },
+    },
+    {
+        name: "country_by_currency",
+        description: "Get countries by currency from REST Countries.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                currency: { type: "string" },
+            },
+            required: ["currency"],
+        },
+    },
+    {
+        name: "country_by_language",
+        description: "Get countries by language from REST Countries.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                language: { type: "string" },
+            },
+            required: ["language"],
+        },
+    }
+];
+const HANDLERS = {
+    country_all: (args) => countryAll(args),
+    country_by_name: (args) => countryByName(args),
+    country_by_code: (args) => countryByCode(args),
+    country_by_region: (args) => countryByRegion(args),
+    country_by_currency: (args) => countryByCurrency(args),
+    country_by_language: (args) => countryByLanguage(args),
+};
+const server = new Server({ name: "io.github.malamutemayhem/restcountries", 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(`[restcountries-mcp] fatal: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});

package/dist/restcountries-tool.js

@@ -0,0 +1,140 @@
+// REST Countries integration for the UnClick MCP server.
+// Uses the REST Countries public API via fetch - no auth required.
+// Data covers all 250 countries with rich metadata.
+const RESTCOUNTRIES_BASE = "https://restcountries.com/v3.1";
+// --- API helper ---
+async function rcFetch(path, fields) {
+    const url = new URL(`${RESTCOUNTRIES_BASE}${path}`);
+    if (fields)
+        url.searchParams.set("fields", fields);
+    const response = await fetch(url.toString(), {
+        headers: { "Accept": "application/json" },
+    });
+    if (response.status === 404) {
+        return { results: [], note: "No countries matched the query." };
+    }
+    if (!response.ok) {
+        const text = await response.text().catch(() => "");
+        throw new Error(`HTTP ${response.status} from REST Countries API${text ? `: ${text}` : ""}`);
+    }
+    return response.json();
+}
+// --- Normalizer ---
+function normalizeCountry(c) {
+    const name = c.name;
+    const currencies = c.currencies;
+    const languages = c.languages;
+    const capital = c.capital;
+    const flags = c.flags;
+    const maps = c.maps;
+    return {
+        name: name?.common ?? c.name,
+        official_name: name?.official ?? null,
+        cca2: c.cca2 ?? null,
+        cca3: c.cca3 ?? null,
+        capital: capital?.[0] ?? null,
+        region: c.region ?? null,
+        subregion: c.subregion ?? null,
+        population: c.population ?? null,
+        area: c.area ?? null,
+        flag_emoji: c.flag ?? null,
+        flag_url: flags?.png ?? null,
+        google_maps: maps?.googleMaps ?? null,
+        currencies: currencies
+            ? Object.entries(currencies).map(([code, info]) => ({
+                code,
+                name: info.name,
+                symbol: info.symbol,
+            }))
+            : null,
+        languages: languages ? Object.values(languages) : null,
+        timezones: c.timezones ?? null,
+        continents: c.continents ?? null,
+        landlocked: c.landlocked ?? null,
+        borders: c.borders ?? null,
+        independent: c.independent ?? null,
+        un_member: c.unMember ?? null,
+    };
+}
+// --- Operations ---
+export async function countryAll(args) {
+    const fields = String(args.fields ?? "").trim();
+    const data = await rcFetch("/all", fields || undefined);
+    if (data && typeof data === "object" && "results" in data)
+        return data;
+    const countries = data;
+    return {
+        count: countries.length,
+        countries: countries.map(normalizeCountry),
+    };
+}
+export async function countryByName(args) {
+    const name = String(args.name ?? "").trim();
+    if (!name)
+        throw new Error("name is required.");
+    const data = await rcFetch(`/name/${encodeURIComponent(name)}`);
+    if (data && typeof data === "object" && "results" in data)
+        return data;
+    const countries = data;
+    return {
+        count: countries.length,
+        countries: countries.map(normalizeCountry),
+    };
+}
+export async function countryByCode(args) {
+    const code = String(args.code ?? "").trim().toUpperCase();
+    if (!code)
+        throw new Error("code is required (ISO 2 or 3 letter code).");
+    const data = await rcFetch(`/alpha/${encodeURIComponent(code)}`);
+    if (data && typeof data === "object" && "results" in data)
+        return data;
+    // /alpha/{code} can return a single object or array
+    const arr = Array.isArray(data) ? data : [data];
+    return {
+        count: arr.length,
+        countries: arr.map(normalizeCountry),
+    };
+}
+export async function countryByRegion(args) {
+    const region = String(args.region ?? "").trim();
+    const validRegions = ["Africa", "Americas", "Asia", "Europe", "Oceania", "Antarctic"];
+    if (!region)
+        throw new Error(`region is required. Valid values: ${validRegions.join(", ")}.`);
+    const data = await rcFetch(`/region/${encodeURIComponent(region)}`);
+    if (data && typeof data === "object" && "results" in data)
+        return data;
+    const countries = data;
+    return {
+        region,
+        count: countries.length,
+        countries: countries.map(normalizeCountry),
+    };
+}
+export async function countryByCurrency(args) {
+    const currency = String(args.currency ?? "").trim().toUpperCase();
+    if (!currency)
+        throw new Error("currency is required (e.g. USD, EUR).");
+    const data = await rcFetch(`/currency/${encodeURIComponent(currency)}`);
+    if (data && typeof data === "object" && "results" in data)
+        return data;
+    const countries = data;
+    return {
+        currency,
+        count: countries.length,
+        countries: countries.map(normalizeCountry),
+    };
+}
+export async function countryByLanguage(args) {
+    const language = String(args.language ?? "").trim().toLowerCase();
+    if (!language)
+        throw new Error("language is required (e.g. english, spanish).");
+    const data = await rcFetch(`/lang/${encodeURIComponent(language)}`);
+    if (data && typeof data === "object" && "results" in data)
+        return data;
+    const countries = data;
+    return {
+        language,
+        count: countries.length,
+        countries: countries.map(normalizeCountry),
+    };
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@unclick/restcountries-mcp",
+  "version": "0.1.0",
+  "mcpName": "io.github.malamutemayhem/restcountries",
+  "description": "Country data: flags, currencies, languages, regions, capitals, and more. No API key. By UnClick (https://unclick.world).",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "unclick",
+    "countries",
+    "geography",
+    "restcountries"
+  ],
+  "author": "UnClick (https://unclick.world)",
+  "type": "module",
+  "bin": {
+    "restcountries-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/restcountries-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/restcountries",
+  "title": "REST Countries MCP by UnClick",
+  "description": "Country data: flags, currencies, languages, regions, capitals, and more. No API key. 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/restcountries-mcp"
+  },
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@unclick/restcountries-mcp",
+      "version": "0.1.0",
+      "runtimeHint": "npx",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}