@thoughtfree/mcp-server 0.1.0 → 0.2.0

package/dist/client.d.ts

@@ -16,6 +16,7 @@ export declare class ThoughtFreeClient {
         type?: string;
         isStarred?: boolean;
         isArchived?: boolean;
+        deleted?: boolean;
     }): Promise<ListResponse<Thought>>;
     getThought(id: string): Promise<Thought>;
     createThought(data: {
@@ -39,6 +40,15 @@ export declare class ThoughtFreeClient {
         dueDate?: string;
         priority?: string;
     }): Promise<Thought>;
+    deleteThought(id: string): Promise<{
+        id: string;
+        deleted: boolean;
+        deletedAt: string;
+    }>;
+    restoreThought(id: string): Promise<{
+        id: string;
+        restored: boolean;
+    }>;
     searchThoughts(query: string, params?: {
         mode?: 'semantic' | 'fulltext' | 'hybrid';
         limit?: number;

package/dist/client.js

@@ -42,6 +42,8 @@ export class ThoughtFreeClient {
             searchParams.set('isStarred', 'true');
         if (params?.isArchived)
             searchParams.set('isArchived', 'true');
+        if (params?.deleted)
+            searchParams.set('deleted', 'true');
         const qs = searchParams.toString();
         return this.request(`/api/v1/thoughts${qs ? `?${qs}` : ''}`);
     }
@@ -60,6 +62,16 @@ export class ThoughtFreeClient {
             body: JSON.stringify(data)
         });
     }
+    async deleteThought(id) {
+        return this.request(`/api/v1/thoughts/${id}`, {
+            method: 'DELETE'
+        });
+    }
+    async restoreThought(id) {
+        return this.request(`/api/v1/thoughts/${id}?restore=true`, {
+            method: 'DELETE'
+        });
+    }
     // ─── Search ──────────────────────────────────────────────
     async searchThoughts(query, params) {
         const searchParams = new URLSearchParams({ q: query });

package/dist/index.js

@@ -7,19 +7,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { ThoughtFreeClient } from './client.js';
-// Tools
-import { registerSearchTool } from './tools/search.js';
-import { registerCreateTool } from './tools/create.js';
-import { registerListTool } from './tools/list.js';
-import { registerGetTool } from './tools/get.js';
-import { registerUpdateTool } from './tools/update.js';
-import { registerQueryBrainTool } from './tools/query-brain.js';
-import { registerCategoriesTool } from './tools/categories.js';
-import { registerStatsTool } from './tools/stats.js';
-// Resources
-import { registerRecentResource } from './resources/recent.js';
-import { registerStarredResource } from './resources/starred.js';
-import { registerByCategoryResource } from './resources/by-category.js';
+import { registerAllMcpCapabilities } from './register.js';
 export async function main() {
     const apiKey = process.env.THOUGHTFREE_API_KEY;
     const apiUrl = process.env.THOUGHTFREE_API_URL || 'https://thoughtfree.io';
@@ -33,25 +21,13 @@ export async function main() {
         name: 'thoughtfree',
         version: '0.1.0'
     });
-    // Register all tools
-    registerSearchTool(server, client);
-    registerCreateTool(server, client);
-    registerListTool(server, client);
-    registerGetTool(server, client);
-    registerUpdateTool(server, client);
-    registerQueryBrainTool(server, client);
-    registerCategoriesTool(server, client);
-    registerStatsTool(server, client);
-    // Register all resources
-    registerRecentResource(server, client);
-    registerStarredResource(server, client);
-    registerByCategoryResource(server, client);
+    registerAllMcpCapabilities(server, client);
     // Connect via stdio transport
     const transport = new StdioServerTransport();
     await server.connect(transport);
     console.error('ThoughtFree MCP Server running on stdio');
     console.error(`  API URL: ${apiUrl}`);
-    console.error(`  Tools: 8 | Resources: 3`);
+    console.error(`  Tools: 10 | Resources: 3`);
 }
 main().catch((err) => {
     console.error('Fatal error:', err);

package/dist/register.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared MCP tool/resource registration.
+ *
+ * Used by both the stdio server (index.ts) and the SvelteKit
+ * remote HTTP endpoint (src/routes/api/mcp/+server.ts).
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ThoughtFreeClient } from './client.js';
+export declare function registerAllMcpCapabilities(server: McpServer, client: ThoughtFreeClient): void;

package/dist/register.js

@@ -0,0 +1,36 @@
+/**
+ * Shared MCP tool/resource registration.
+ *
+ * Used by both the stdio server (index.ts) and the SvelteKit
+ * remote HTTP endpoint (src/routes/api/mcp/+server.ts).
+ */
+// Tools
+import { registerSearchTool } from './tools/search.js';
+import { registerCreateTool } from './tools/create.js';
+import { registerListTool } from './tools/list.js';
+import { registerGetTool } from './tools/get.js';
+import { registerUpdateTool } from './tools/update.js';
+import { registerDeleteTool } from './tools/delete.js';
+import { registerRestoreTool } from './tools/restore.js';
+import { registerQueryBrainTool } from './tools/query-brain.js';
+import { registerCategoriesTool } from './tools/categories.js';
+import { registerStatsTool } from './tools/stats.js';
+// Resources
+import { registerRecentResource } from './resources/recent.js';
+import { registerStarredResource } from './resources/starred.js';
+import { registerByCategoryResource } from './resources/by-category.js';
+export function registerAllMcpCapabilities(server, client) {
+    registerSearchTool(server, client);
+    registerCreateTool(server, client);
+    registerListTool(server, client);
+    registerGetTool(server, client);
+    registerUpdateTool(server, client);
+    registerDeleteTool(server, client);
+    registerRestoreTool(server, client);
+    registerQueryBrainTool(server, client);
+    registerCategoriesTool(server, client);
+    registerStatsTool(server, client);
+    registerRecentResource(server, client);
+    registerStarredResource(server, client);
+    registerByCategoryResource(server, client);
+}

package/dist/tools/delete.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ThoughtFreeClient } from '../client.js';
+export declare function registerDeleteTool(server: McpServer, client: ThoughtFreeClient): void;

package/dist/tools/delete.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+export function registerDeleteTool(server, client) {
+    server.registerTool('delete_thought', {
+        title: 'Delete Thought',
+        description: 'Soft-delete a thought by ID. The thought can be restored later with restore_thought.',
+        inputSchema: z.object({
+            id: z.string().describe('The thought\'s server UUID')
+        })
+    }, async ({ id }) => {
+        try {
+            const result = await client.deleteThought(id);
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Thought deleted successfully.\nID: ${result.id}\nDeleted at: ${result.deletedAt}\n\nUse restore_thought to undo this deletion.`
+                    }]
+            };
+        }
+        catch (err) {
+            return { content: [{ type: 'text', text: `Failed to delete thought: ${err instanceof Error ? err.message : String(err)}` }], isError: true };
+        }
+    });
+}

package/dist/tools/list.js

@@ -8,16 +8,17 @@ export function registerListTool(server, client) {
             type: z.string().optional().describe('Filter by type (text, voice, image, file, link)'),
             isStarred: z.boolean().optional().describe('Only show starred thoughts'),
             isArchived: z.boolean().optional().describe('Only show archived thoughts'),
+            deleted: z.boolean().optional().describe('Show deleted thoughts instead of active ones'),
             limit: z.number().min(1).max(100).default(20).describe('Number of thoughts to return'),
             cursor: z.string().optional().describe('Pagination cursor from previous response')
         })
-    }, async ({ category, type, isStarred, isArchived, limit, cursor }) => {
+    }, async ({ category, type, isStarred, isArchived, deleted, limit, cursor }) => {
         try {
-            const result = await client.listThoughts({ category, type, isStarred, isArchived, limit, cursor });
+            const result = await client.listThoughts({ category, type, isStarred, isArchived, deleted, limit, cursor });
             if (result.data.length === 0) {
                 return { content: [{ type: 'text', text: 'No thoughts found matching the filters.' }] };
             }
-            const formatted = result.data.map((t, i) => `${i + 1}. ${t.category ? `[${t.category}] ` : ''}${t.isStarred ? '★ ' : ''}${t.content.slice(0, 200)}${t.content.length > 200 ? '...' : ''}\n   ID: ${t.id} | Type: ${t.type} | Created: ${t.createdAt}${t.userTags.length ? ` | Tags: ${t.userTags.join(', ')}` : ''}`).join('\n\n');
+            const formatted = result.data.map((t, i) => `${i + 1}. ${t.category ? `[${t.category}] ` : ''}${t.isStarred ? '★ ' : ''}${t.content.slice(0, 200)}${t.content.length > 200 ? '...' : ''}\n   ID: ${t.id} | Type: ${t.type} | Created: ${t.createdAt}${t.deletedAt ? ` | Deleted: ${t.deletedAt}` : ''}${t.userTags.length ? ` | Tags: ${t.userTags.join(', ')}` : ''}`).join('\n\n');
             let text = `Showing ${result.data.length} thoughts:\n\n${formatted}`;
             if (result.hasMore && result.cursor) {
                 text += `\n\n--- More results available. Use cursor: "${result.cursor}" ---`;

package/dist/tools/restore.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ThoughtFreeClient } from '../client.js';
+export declare function registerRestoreTool(server: McpServer, client: ThoughtFreeClient): void;

package/dist/tools/restore.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+export function registerRestoreTool(server, client) {
+    server.registerTool('restore_thought', {
+        title: 'Restore Thought',
+        description: 'Restore a previously deleted thought. Use list_thoughts with deleted=true to find deleted thoughts first.',
+        inputSchema: z.object({
+            id: z.string().describe('The deleted thought\'s server UUID')
+        })
+    }, async ({ id }) => {
+        try {
+            const result = await client.restoreThought(id);
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Thought restored successfully.\nID: ${result.id}\n\nThe thought is now visible again in your thought list.`
+                    }]
+            };
+        }
+        catch (err) {
+            return { content: [{ type: 'text', text: `Failed to restore thought: ${err instanceof Error ? err.message : String(err)}` }], isError: true };
+        }
+    });
+}

package/dist/types.d.ts

@@ -15,6 +15,7 @@ export interface Thought {
     attachments: unknown[];
     createdAt: string;
     updatedAt: string;
+    deletedAt?: string | null;
 }
 export interface SearchResult {
     id: string;

package/package.json

@@ -1,12 +1,17 @@
 {
   "name": "@thoughtfree/mcp-server",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server for ThoughtFree — access your thought database from any AI agent",
   "type": "module",
   "bin": {
     "thoughtfree-mcp": "./bin/thoughtfree-mcp.mjs"
   },
   "main": "./dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./register": "./dist/register.js",
+    "./client": "./dist/client.js"
+  },
   "files": [
     "dist",
     "bin"