Add list_gist_prompts tool

Author: lostintangent

.vscode/mcp.json

@@ -4,11 +4,11 @@
       "type": "promptString",
       "password": true,
       "id": "github_token",
-      "description": "Github token"
+      "description": "Github PAT w/gist scope"
     }
   ],
   "servers": {
-    "gistpad": {
+    "GistPad (Dev)": {
       "type": "stdio",
       "command": "node",
       "args": ["build/index.js"],

.vscode/settings.json

@@ -2,5 +2,6 @@
   "editor.formatOnSave": true,
   "editor.codeActionsOnSave": {
     "source.organizeImports": "explicit"
-  }
+  },
+  "gistpad.mcp.enabled": false
 }

CHANGELOG.md

@@ -1,3 +1,7 @@
+## 📆 v0.4.8 (07/07/2025)
+
+- Added a `list_gist_prompts` tool
+
 ## 📆 v0.4.7 (06/18/2025)
 
 - Renamed the prompt tools to include `gist` in the name: `add_prompt` -> `add_gist_prompt`, `delete_prompt` -> `delete_gist_prompt`.

README.md

@@ -118,6 +118,7 @@ Once your client it setup, you can start having fun with gists + MCP! 🥳 For e
 
 ### Prompts
 
+- `list_gist_prompts` - List the prompts in your prompts collection.
 - `add_gist_prompt` - Add a new prompt to your prompts collection.
 - `delete_gist_prompt` - Delete a prompt from your collection.
 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "gistpad-mcp",
-  "version": "0.4.7",
+  "version": "0.4.8",
   "description": "An MCP server for managing your personal knowledge, daily notes, and reusable prompts via GitHub Gists.",
   "type": "module",
   "bin": {
@@ -25,7 +25,7 @@
     "inspector": "npx @modelcontextprotocol/inspector build/index.js"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.3",
+    "@modelcontextprotocol/sdk": "^1.15.0",
     "axios": "^1.10.0",
     "gray-matter": "^4.0.3"
   },

package.json

@@ -47,7 +47,7 @@ class GistpadServer {
     this.server = new Server(
       {
         name: "gistpad",
-        version: "0.4.7",
+        version: "0.4.8",
       },
       {
         capabilities: {
@@ -71,7 +71,7 @@ class GistpadServer {
             listChanged: true,
           },
         },
-        instructions: `GistPad allows you to manage your personal knowledge/daily notes/todos, and create re-usable AI prompts, using GitHub Gists.
+        instructions: `GistPad allows you to manage your personal knowledge/daily notes/todos, and create re-usable prompts, using GitHub Gists.
 To read gists, notes, and gist comments, prefer using the available resources vs. tools. And then use the available tools to create, update, delete, archive, star, etc. your gists.`,
       }
     );

src/index.ts

@@ -6,7 +6,7 @@ import {
     mcpGist,
 } from "../utils.js";
 
-const RESOURCE_PREFIX = "gist://";
+const RESOURCE_PREFIX = "gist:///";
 
 export const resourceHandlers: ResourceHandlers = {
     listResourceTemplates: () => ({
@@ -48,15 +48,17 @@ export const resourceHandlers: ResourceHandlers = {
                     let name = gist.description?.trim();
                     if (!name) {
                         const firstFile = Object.keys(gist.files)[0];
-                        if (firstFile !== "README.md") {
-                            // Strip the extension of markdown files, since
-                            // we'll treat those as pseudo descriptions.
-                            name = firstFile.replace(/\.md$/i, "");
-                        } else {
+                        if (!firstFile) {
+                            name = "Empty";
+                        } else if (firstFile === "README.md") {
                             // Explicity mark this as "Untitled", since the file
                             // name isn't unique enough to be used as a name, and 
                             // we want to draw attention to it.
                             name = "Untitled";
+                        } else {
+                            // Strip the extension off markdown files, since
+                            // we'll treat those as pseudo descriptions.
+                            name = firstFile.replace(/\.md$/i, "");
                         }
                     }
 
@@ -70,11 +72,9 @@ export const resourceHandlers: ResourceHandlers = {
     },
 
     readResource: async (uri, context) => {
-        const url = new URL(uri);
-        const path = url.host + (url.pathname ? "/" + url.pathname : "");
-
-        if (path.endsWith("/comments")) {
-            const response = await context.axiosInstance.get(`/${url.host}/comments`);
+        const { pathname } = new URL(uri);
+        if (pathname.endsWith("/comments")) {
+            const response = await context.axiosInstance.get(pathname);
             return {
                 contents: [
                     {
@@ -86,7 +86,7 @@ export const resourceHandlers: ResourceHandlers = {
             };
         }
 
-        const { data: gist } = await context.axiosInstance.get(`/${path}`);
+        const { data: gist } = await context.axiosInstance.get(pathname);
         context.gistStore.update(gist);
 
         const resource = {
@@ -96,7 +96,7 @@ export const resourceHandlers: ResourceHandlers = {
         };
 
         // Note: Nothing uses this at the moment, but it could be useful in the future.
-        if (path.endsWith("/raw")) {
+        if (pathname.endsWith("/raw")) {
             const mainFile: GistFile =
                 gist.files["README.md"] || Object.keys(gist.files)[0]!;
 

src/resources/gists.ts

@@ -80,10 +80,17 @@ export abstract class GistStore {
                 const oldGist = this.cache[index];
                 this.cache[index] = gist;
 
+                // If the gist didn't actually change, we don't need to notify.
+                if (oldGist.updated_at === gist.updated_at) {
+                    return;
+                }
+
                 if (isPromptGist(gist)) {
                     this.notifyPromptListChanged();
                 } else {
-                    // If the description changed, the list of resources has changed
+                    // The resource list only includes the gist ID and
+                    // description, so we only need to notify clients to
+                    // update the list when a gist's description changes.
                     if (oldGist.description !== gist.description) {
                         this.notifyResourceListChanged();
                     }

src/store.ts

@@ -16,6 +16,15 @@ interface AddPromptArgs {
 
 export default {
     definitions: [
+        {
+            name: "list_gist_prompts",
+            description: "List the prompts in your gist-based prompts collection",
+            inputSchema: {
+                type: "object",
+                properties: {},
+                required: [],
+            },
+        },
         {
             name: "delete_gist_prompt",
             description: "Delete a prompt from your gist-based prompts collection",
@@ -75,6 +84,22 @@ export default {
     ],
 
     handlers: {
+        list_gist_prompts: async (_, context) => {
+            const promptsGist = await context.gistStore.getPrompts();
+            if (!promptsGist) {
+                return {
+                    prompts: [],
+                }
+            }
+
+            const prompts = Object.keys(promptsGist.files)
+                .map(filename => filename.replace(/\.md$/, ""));
+
+            return {
+                prompts,
+            };
+        },
+
         delete_gist_prompt: async (args: unknown, context) => {
             const { name } = args as { name: string };
 
@@ -188,8 +213,6 @@ export default {
                 context.gistStore.update(updatedGist);
             }
 
-            await context.server.sendPromptListChanged();
-
             return `Successfully added prompt "${name}" to prompts collection`;
         },
     },