countryflags-mcp 1.0.1 → 1.0.3

package/README.md

@@ -19,3 +19,5 @@ node dist/index.js
 ```
 
 Data comes from the public Flagcdn API.
+
+

package/dist/api.js

@@ -23,3 +23,50 @@ export async function flag(args) {
         return 'Provide a country code like us.';
     return `${code.toUpperCase()}: ${BASE}/${code}.png (w160: ${BASE}/w160/${code}.png, w320: ${BASE}/w320/${code}.png)`;
 }
+// ---- muxA tools:
+// The existing tools search the code list and print a bare flag url. The bare
+// form has no size and answers 404, so these return only the sized urls that
+// really exist and resolve a country or region name to its code.
+/** Sizes confirmed to answer 200 for a country code. Anything else 404s. */
+const SIZES = [
+    'w20', 'w40', 'w80', 'w160', 'w320', 'w640', 'w1280', 'w2560',
+    'h20', 'h24', 'h40', 'h60', 'h80', 'h120',
+    '24x18', '32x24', '48x36', '64x48', '96x72', '128x96', '256x192',
+];
+async function codes() {
+    const res = await fetch(`${BASE}/en/codes.json`, {
+        headers: { 'User-Agent': 'mrfentmen-countryflags-mcp/1.0', Accept: 'application/json' },
+        signal: AbortSignal.timeout(20000),
+    });
+    if (!res.ok)
+        throw new Error(`Flagcdn returned ${res.status}`);
+    const d = (await res.json());
+    return d && typeof d === 'object' ? d : {};
+}
+function sizeList(requested) {
+    if (!requested)
+        return SIZES;
+    const wanted = requested.split(/[,\s]+/).filter(Boolean).map((s) => s.toLowerCase());
+    const bad = wanted.filter((s) => !SIZES.includes(s));
+    if (bad.length)
+        throw new Error(`These sizes do not exist: ${bad.join(', ')}. Available: ${SIZES.join(', ')}.`);
+    return wanted;
+}
+export async function resolveName(args) {
+    const query = (args.name ?? '').trim().toLowerCase();
+    if (!query)
+        throw new Error('Provide a country or region name, or part of one.');
+    const names = await codes();
+    const hits = Object.entries(names).filter(([code, name]) => name.toLowerCase().includes(query) || code === query);
+    if (!hits.length)
+        return `No flag matches "${args.name}".`;
+    const wanted = sizeList(args.sizes);
+    const shown = hits.slice(0, 10);
+    const lines = [`Flags matching "${args.name}": ${hits.length}${hits.length > shown.length ? `, showing ${shown.length}` : ''}`];
+    for (const [code, name] of shown) {
+        lines.push(`  ${name} (${code})`);
+        for (const size of wanted.slice(0, 3))
+            lines.push(`     ${BASE}/${size}/${code}.png`);
+    }
+    return lines.join('\n');
+}

package/dist/server.js

@@ -1,7 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
-import { flag } from "./api.js";
-import { list } from "./api.js";
+import { flag, list, resolveName } 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 };
@@ -18,7 +17,7 @@ export function createServer() {
             return text(await list(args));
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
         }
     });
     server.registerTool("flag", {
@@ -31,7 +30,34 @@ export function createServer() {
             return text(await flag(args));
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
+        }
+    });
+    server.registerTool("flag_urls", {
+        title: "Flag urls",
+        description: "Every working size url for one flag code, checked against the live code list and restricted to the sizes that really exist. The unsized url the flag tool prints answers 404.",
+        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");
+        }
+        catch (e) {
+            return textError(String(e));
+        }
+    });
+    server.registerTool("resolve_name", {
+        title: "Resolve name",
+        description: "Find flag codes by country or region name and get real image urls for each, instead of guessing the two letter code.",
+        inputSchema: z.object({ name: z.string().describe("Country or region name or part of one, like united or korea."), sizes: z.string().describe("Comma separated sizes to show, like w320. Defaults to all 21 that exist.").optional() }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return text(await resolveName(args));
+        }
+        catch (e) {
+            return textError(String(e));
         }
     });
     return server;

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.1",
+  "version": "1.0.3",
   "type": "module",
   "repository": {
     "type": "git",
@@ -41,4 +41,4 @@
   "engines": {
     "node": ">=20"
   }
-}
+}