countryflags-mcp 1.0.4 → 1.0.6

package/README.md

@@ -20,4 +20,9 @@ node dist/index.js
 
 Data comes from the public Flagcdn API.
 
+## Licence — no paywall
 
+Every tool in this package is free: no licence key, no premium tier, no hosted
+licence gateway. The paywall machinery this repo once carried (per-tool licence
+checks and paid hosted endpoints) was removed repo-wide on 2026-10-17. Nothing
+that this package installs or calls asks you to pay.

package/dist/api.js

@@ -70,3 +70,47 @@ export async function resolveName(args) {
     }
     return lines.join('\n');
 }
+
+const FLAG_SIZES = ['w20', 'w40', 'w80', 'w160', 'w320', 'w640', 'w1280', 'w2560',
+    '20x15', '24x18', '32x24', '40x30', '48x36', '64x48', '80x60', '96x72', '128x96', '160x120', '240x180', '256x192'];
+export async function flagUrls(args = {}) {
+    const code = String(args?.code ?? '').trim().toLowerCase();
+    if (!/^[a-z]{2}(-[a-z]{2,3})?$/.test(code))
+        throw new Error(`"${args?.code}" is not a flag code like us or gb-eng.`);
+    const codesRes = await fetch('https://flagcdn.com/en/codes.json', {
+        headers: { 'User-Agent': 'mrfentmen-countryflags-mcp/1.0', Accept: 'application/json' },
+        signal: AbortSignal.timeout(20000),
+    });
+    if (!codesRes.ok)
+        throw new Error(`flagcdn codes list returned ${codesRes.status}`);
+    const codes = (await codesRes.json());
+    const name = codes[code];
+    if (!name)
+        throw new Error(`flagcdn has no flag for "${code}".`);
+    const wanted = args?.sizes
+        ? String(args.sizes).split(',').map((s) => s.trim().toLowerCase()).filter(Boolean)
+        : FLAG_SIZES;
+    const unknown = wanted.filter((s) => !FLAG_SIZES.includes(s));
+    if (unknown.length)
+        throw new Error(`Unknown sizes: ${unknown.join(', ')}. Known: ${FLAG_SIZES.join(', ')}.`);
+    const checked = await Promise.all(wanted.map(async (size) => {
+        try {
+            const r = await fetch(`https://flagcdn.com/${size}/${code}.png`, {
+                method: 'HEAD',
+                headers: { 'User-Agent': 'mrfentmen-countryflags-mcp/1.0' },
+                signal: AbortSignal.timeout(15000),
+            });
+            return r.ok ? size : null;
+        }
+        catch {
+            return null;
+        }
+    }));
+    const live = checked.filter(Boolean);
+    if (!live.length)
+        throw new Error(`flagcdn has no image for ${code} at the requested sizes.`);
+    return [
+        `${name} (${code}) — ${live.length} working size(s):`,
+        ...live.map((s) => `- ${s}: https://flagcdn.com/${s}/${code}.png`),
+    ].join('\n');
+}

package/dist/server.js

@@ -1,6 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
-import { flag, list, resolveName } from "./api.js";
+import { flag, list, resolveName, flagUrls } from "./api.js";
 const text = (value) => ({ content: [{ type: "text", text: value }] });
 const textError = (t) => ({ content: [{ type: "text", text: t }], isError: true });
 const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
@@ -39,9 +39,8 @@ export function createServer() {
         inputSchema: z.object({ code: z.string().describe("Country code like us, or a subdivision code like gb-eng."), sizes: z.string().describe("Comma separated sizes to show, like w320,256x192. Defaults to all 21 that exist.").optional() }),
         annotations: READ_ONLY,
     }, async (args) => {
-        // TODO: implement urls locally (paywall removed)
         try {
-            return textError("Not yet implemented: urls");
+            return text(await flagUrls(args));
         }
         catch (e) {
             return textError(String(e));

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.4",
+  "version": "1.0.6",
   "type": "module",
   "repository": {
     "type": "git",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/mrfentmen/countryflags-mcp",
     "source": "github"
   },
-  "version": "1.0.1",
+  "version": "1.0.6",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "countryflags-mcp",
-      "version": "1.0.1",
+      "version": "1.0.6",
       "transport": {
         "type": "stdio"
       }