Introduce refresh_gists tool

Author: lostintangent

CHANGELOG.md

@@ -1,3 +1,7 @@
+## 📆 v0.4.5 (06/16/2025)
+
+- Added the `refresh_gists` tool
+
 ## 📆 v0.4.4 (06/12/2025)
 
 - Updated README with instructions for setting up GistPad with VS Code 1.101.0

README.md

@@ -12,10 +12,12 @@ An MCP server for managing and sharing your personal knowledge, daily notes, and
 
 1. Using VS Code?
 
-   1. Simply install the [GistPad extension](https://aka.ms/gistpad) and sign-in with your GitHub account. After that, you can begin using GistPad from Copilot chat (in `Agent` mode) without doing any extra setup or token management 💪
+   1. Install the [GistPad extension](https://aka.ms/gistpad) and then reload VS Code
 
       > _Note: This requires VS Code 1.101.0+, so if you're on an older version, it's time to upgrade!_
 
+   1. Open the `GistPad` tab and sign-in with your GitHub account. After that, you can begin using GistPad from Copilot chat (in `Agent` mode) without doing any extra setup or token management 💪
+
 1. Other MCP clients...
 
    1. Generate a personal access token that includes _only_ the `gist` scope: https://github.com/settings/tokens/new
@@ -78,6 +80,7 @@ Once your client it setup, you can start having fun with gists + MCP! 🥳 For e
 - `delete_gist` - Delete a gist by ID.
 - `update_gist_description` - Update a gist's description by ID.
 - `duplicate_gist` - Create a copy of an existing gist with all its files.
+- `refresh_gists` - Reload your gist lists, ignoring any cached data.
 
 ### File management
 
@@ -144,3 +147,7 @@ The `gistpad-mcp` CLI accepts the following optional flags:
 - `--starred` - Include starred gists in the list of MCP resources _(Note: The `list_starred_gists` tool is always available)_
 - `--daily` - Include daily notes in the list of MCP resources _(Note: The `list_daily_notes` tool is always available)_
 - `--markdown` - Filter the list of gists that are returned, to only those that are composed of Markdown files.
+
+## 🧰 Troubleshooting
+
+- <u>Not seeing a gist in your list?</u> Rhe GistPad MCP server caches your gist list during the lifetime of its server process (for performance reasons), and so if you add/edit/delete a gist externally, you may need to tell GistPad MCP to refresh itself. You can do this by triggering the `refresh_gists` tool.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "gistpad-mcp",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "An MCP server for managing your personal knowledge, daily notes, and reusable prompts via GitHub Gists.",
   "type": "module",
   "bin": {

src/index.ts

@@ -47,7 +47,7 @@ class GistpadServer {
     this.server = new Server(
       {
         name: "gistpad",
-        version: "0.4.4",
+        version: "0.4.5",
       },
       {
         capabilities: {

src/tools/index.ts

@@ -5,6 +5,7 @@ import daily from "./daily.js";
 import fileTools from "./files.js";
 import gistTools from "./gist.js";
 import promptTools from "./prompts.js";
+import refreshTools from "./refresh.js";
 import starTools from "./star.js";
 
 const tools: ToolModule[] = [
@@ -14,6 +15,7 @@ const tools: ToolModule[] = [
     fileTools,
     gistTools,
     promptTools,
+    refreshTools,
     starTools,
 ];
 

src/tools/refresh.ts

@@ -0,0 +1,31 @@
+import { ToolModule } from "../types.js";
+
+export default {
+    definitions: [
+        {
+            name: "refresh_gists",
+            description:
+                "Reload the gist and starred gist stores, bypassing the cache",
+            inputSchema: {
+                type: "object",
+                properties: {},
+                required: [],
+            },
+        },
+    ],
+
+    handlers: {
+        refresh_gists: async (_, context) => {
+            context.gistStore.invalidate();
+            context.starredGistStore.invalidate();
+
+            await Promise.all([
+                context.gistStore.getAll(),
+                context.starredGistStore.getAll(),
+            ]);
+
+            await context.server.sendResourceListChanged();
+            return "Gists refreshed!";
+        },
+    },
+} as ToolModule;