dragonball-mcp 1.0.1 → 1.0.3

package/README.md

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

package/dist/api.js

@@ -40,3 +40,27 @@ export async function character(args) {
         s('description') ? `\n${s('description')}` : '',
     ].filter(Boolean).join('\n');
 }
+export async function planets(args = {}) {
+    const page = Math.max(1, Math.min(Math.trunc(Number(args.page ?? 1)) || 1, 100));
+    const limit = Math.max(1, Math.min(Math.trunc(Number(args.limit ?? 10)) || 10, 50));
+    const res = await fetch(`${BASE}/planets?page=${page}&limit=${limit}`, {
+        headers: { 'User-Agent': 'mrfentmen-dragonball-mcp/1.0', Accept: 'application/json' },
+        signal: AbortSignal.timeout(20000),
+    });
+    if (!res.ok)
+        throw new Error(`Dragon Ball API returned ${res.status}`);
+    const d = (await res.json());
+    const rows = d.items ?? [];
+    if (!rows.length)
+        return `No planets on page ${page}.`;
+    const meta = d.meta ?? {};
+    const lines = [
+        `Dragon Ball planets — page ${meta.currentPage ?? page} of ${meta.totalPages ?? '?'}, ${meta.totalItems ?? '?'} in total, ${rows.length} shown`,
+    ];
+    for (const [i, r] of rows.entries()) {
+        lines.push(`${i + 1}. ${r.name ?? 'unnamed'}${r.isDestroyed ? ' (destroyed)' : ' (intact)'}`);
+        if (r.description)
+            lines.push(`   ${String(r.description).slice(0, 160)}`);
+    }
+    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 { character } from "./api.js";
-import { characters } from "./api.js";
+import { character, characters, planets } 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 characters(args));
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
         }
     });
     server.registerTool("character", {
@@ -31,7 +30,34 @@ export function createServer() {
             return text(await character(args));
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
+        }
+    });
+    server.registerTool("character_detail", {
+        title: "Character detail",
+        description: "One Dragon Ball character by id, with the transformations list and home planet the name lookup does not return.",
+        inputSchema: z.object({ id: z.number().describe("Character id, like 1 for Goku. The characters list prints ids.") }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        // TODO: implement detail locally (paywall removed)
+        try {
+            return textError("Not yet implemented: detail");
+        }
+        catch (e) {
+            return textError(String(e));
+        }
+    });
+    server.registerTool("planets", {
+        title: "Planets",
+        description: "Page the Dragon Ball planet catalogue with its real totals and each planet's destroyed state.",
+        inputSchema: z.object({ page: z.number().describe("Page number, starting at 1. Defaults to 1.").optional(), limit: z.number().describe("Planets per page, 1-50. Defaults to 10.").optional() }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return text(await planets(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"
   }
-}
+}