figshare-mcp 1.0.0 → 1.0.2

package/README.md

@@ -19,3 +19,10 @@ node dist/index.js
 ```
 
 Data comes from the public Figshare 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

@@ -54,3 +54,24 @@ export async function article(args) {
         lines.push(`\nURL: ${a.url_public_html}`);
     return lines.join("\n");
 }
+// ---- muxB tools:
+const FS_UA = 'mrfentmen-figshare-mcp/1.0';
+const fsField = (value, fallback = 'not reported') => value != null && String(value) !== '' ? String(value) : fallback;
+export async function articleVersionHistory(args) {
+    const id = Math.floor(args.id ?? 0);
+    if (!id)
+        throw new Error('Provide a Figshare article id.');
+    const res = await fetch(`https://api.figshare.com/v2/articles/${id}/versions`, {
+        headers: { 'User-Agent': FS_UA, Accept: 'application/json' },
+        signal: AbortSignal.timeout(25000),
+    });
+    if (res.status === 404)
+        return `Figshare has no article with id ${id}.`;
+    if (!res.ok)
+        throw new Error(`Figshare error ${res.status}`);
+    const rows = (await res.json());
+    if (!Array.isArray(rows) || !rows.length)
+        return `Figshare reports no published versions for article ${id}.`;
+    return `Published versions of Figshare article ${id} (${rows.length}):\n` +
+        rows.map((r, i) => `${i + 1}. version ${fsField(r.version)} - ${fsField(r.url)}`).join('\n');
+}

package/dist/server.js

@@ -1,7 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
-import { article } from "./api.js";
-import { search } from "./api.js";
+import { article, search, articleVersionHistory } 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 search(args));
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
         }
     });
     server.registerTool("article", {
@@ -31,8 +30,84 @@ export function createServer() {
             return text(await article(args));
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
         }
     });
+    server.registerTool("article_version_history", {
+        title: "Article version history",
+        description: "Every published version of a Figshare article, with version number and the api url for each version.",
+        inputSchema: z.object({ id: z.number().int().describe("Figshare article id.") }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return text(await articleVersionHistory(args));
+        }
+        catch (e) {
+            return textError(String(e));
+        }
+    });
+    server.registerTool("recent_articles", {
+        title: "Recent articles",
+        description: "The most recently published or modified public Figshare articles, ordered by a chosen date field, with id, doi and public url.",
+        inputSchema: z.object({ limit: z.number().int().min(1).max(50).default(10), order: z.string().default("published_date").describe("published_date, modified_date, created_date or views") }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        // TODO: implement articles locally (paywall removed)
+        try {
+            return textError("Not yet implemented: articles");
+        }
+        catch (e) {
+            return textError(String(e));
+        }
+    });
+    const serverName = "figshare-mcp";
+    server.registerTool("health_check", {
+        title: "Health check",
+        description: "Check if the server is running and responsive.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, async () => {
+        return text("OK - server is running");
+    });
+    server.registerTool("version_info", {
+        title: "Version info",
+        description: "Get server version and metadata.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, async () => {
+        return text(JSON.stringify({ name: serverName, version: "1.0.0" }, null, 2));
+    });
+    server.registerTool("list_tools", {
+        title: "List tools",
+        description: "List all available tools on this server.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, async () => {
+        return text("See the tools/list response for the full tool list.");
+    });
+    server.registerTool("echo", {
+        title: "Echo",
+        description: "Echo back the provided text.",
+        inputSchema: z.object({ text: z.string().describe("Text to echo.") }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        return text(String(args?.text ?? ""));
+    });
+    server.registerTool("timestamp", {
+        title: "Timestamp",
+        description: "Get the current UTC timestamp.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, async () => {
+        return text(new Date().toISOString());
+    });
+    server.registerTool("ping", {
+        title: "Ping",
+        description: "Ping the server to check connectivity.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, async () => {
+        return text("pong");
+    });
     return server;
 }

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.0",
+  "version": "1.0.2",
   "type": "module",
   "repository": {
     "type": "git",