dragonball-mcp 1.0.4 → 1.0.6

package/README.md

@@ -20,4 +20,9 @@ node dist/index.js
 
 Data comes from the public Dragon Ball 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

@@ -64,3 +64,34 @@ export async function planets(args = {}) {
     }
     return lines.join('\n');
 }
+
+const DRAGONBALL = 'https://dragonball-api.com/api/characters';
+export async function characterDetail(args = {}) {
+    const id = Number(args?.id);
+    if (!Number.isInteger(id) || id < 1)
+        throw new Error('Provide a character id, like 1 for Goku.');
+    const res = await fetch(`${DRAGONBALL}/${id}`, {
+        headers: { 'User-Agent': 'mrfentmen-dragonball-mcp/1.0', Accept: 'application/json' },
+        signal: AbortSignal.timeout(20000),
+    });
+    if (res.status === 404)
+        throw new Error(`No Dragon Ball character has id ${id}`);
+    if (!res.ok)
+        throw new Error(`Dragon Ball API returned ${res.status}`);
+    const c = (await res.json());
+    if (!c?.name)
+        throw new Error('Dragon Ball API returned no character');
+    const planet = c.originPlanet;
+    const transforms = Array.isArray(c.transformations) ? c.transformations : [];
+    return [
+        `${c.name} (id ${c.id})`,
+        `Ki: ${c.ki ?? '?'}${c.maxKi ? ` · max ${c.maxKi}` : ''}`,
+        `Race: ${c.race ?? '?'} · gender ${c.gender ?? '?'} · ${c.affiliation ?? 'no affiliation'}`,
+        planet ? `Origin: ${planet.name ?? '?'}${planet.isDestroyed ? ' (destroyed)' : ''}` : 'Origin: unknown',
+        transforms.length
+            ? `Transformations (${transforms.length}): ${transforms.map((t) => `${t.name}${t.ki ? ` [${t.ki}]` : ''}`).join(', ')}`
+            : 'Transformations: none on record',
+        (c.description ?? '').trim().slice(0, 600),
+        'https://dragonball-api.com/api/characters/' + c.id,
+    ].filter(Boolean).join('\n');
+}

package/dist/server.js

@@ -1,6 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
-import { character, characters, planets } from "./api.js";
+import { character, characters, planets, characterDetail } 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({ 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");
+            return text(await characterDetail(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/dragonball-mcp",
     "source": "github"
   },
-  "version": "1.0.1",
+  "version": "1.0.6",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "dragonball-mcp",
-      "version": "1.0.1",
+      "version": "1.0.6",
       "transport": {
         "type": "stdio"
       }