@promptingbox/mcp 0.1.3 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # @promptingbox/mcp
 
-MCP (Model Context Protocol) server for [PromptingBox](https://www.promptingbox.com) — save prompts directly from Claude, Cursor, ChatGPT, and other MCP-compatible AI tools.
+MCP (Model Context Protocol) server for [PromptingBox](https://www.promptingbox.com) — save, manage, and organize prompts directly from Claude, Cursor, ChatGPT, and other MCP-compatible AI tools.
 
 ## Setup
 
@@ -77,22 +77,89 @@ Restart Claude Desktop or Cursor for the MCP server to be detected.
 
 Once configured, you can say things like:
 
+**Saving & retrieving prompts:**
 - "Save this prompt to pbox"
 - "Save this as 'Code Review Checklist' in my Work folder on pbox"
+- "Get my prompt called 'Code Review'"
+- "Search my pbox prompts for API"
 - "List my pbox prompts"
+
+**Editing & managing prompts:**
+- "Update the content of 'Code Review'"
+- "Delete the prompt called 'Old Draft'"
+- "Duplicate 'Code Review'"
+- "Star my 'Code Review' prompt"
+
+**Folders & tags:**
+- "Create a folder called 'Work'"
+- "Move 'Code Review' to my Work folder"
+- "Delete my 'Old' folder"
+- "Tag 'Code Review' with testing and automation"
 - "List my pbox folders"
 - "List my pbox tags"
-- "Move prompt [id] to my Work folder on pbox"
+
+**Version history:**
+- "Show version history for 'Code Review'"
+- "Restore version 2 of 'Code Review'"
+
+**Templates:**
+- "Search pbox templates for email"
+- "Save that template to my collection"
+
+**Account:**
+- "Which pbox account am I using?"
 
 ## Available Tools
 
+### Prompt Management
+
 | Tool | Description |
 |------|-------------|
 | `save_prompt` | Save a prompt with title, content, optional folder and tags |
-| `list_prompts` | List all your prompts with their current folder assignment |
-| `list_folders` | List your PromptingBox folders |
-| `list_tags` | List your PromptingBox tags |
-| `move_prompt_to_folder` | Move an existing prompt to a different folder by prompt ID |
+| `get_prompt` | Get the full content and metadata of a prompt |
+| `search_prompts` | Search prompts by title, content, tag, folder, or favorites |
+| `update_prompt` | Update a prompt's title and/or content (auto-versions) |
+| `delete_prompt` | Permanently delete a prompt and all its versions |
+| `duplicate_prompt` | Create a copy of an existing prompt |
+| `toggle_favorite` | Star or unstar a prompt |
+| `list_prompts` | List all prompts grouped by folder |
+
+### Folder Management
+
+| Tool | Description |
+|------|-------------|
+| `list_folders` | List all folders in your account |
+| `create_folder` | Create a new folder (or return existing one) |
+| `delete_folder` | Delete a folder (prompts move to root, not deleted) |
+| `move_prompt_to_folder` | Move a prompt to a different folder |
+
+### Tag Management
+
+| Tool | Description |
+|------|-------------|
+| `list_tags` | List all tags in your account |
+| `add_tags` | Set tags on a prompt (replaces existing, auto-creates new tags) |
+| `delete_tag` | Delete a tag from your account and all prompts |
+
+### Version History
+
+| Tool | Description |
+|------|-------------|
+| `list_versions` | View all saved versions of a prompt |
+| `restore_version` | Restore a prompt to a previous version |
+
+### Templates
+
+| Tool | Description |
+|------|-------------|
+| `search_templates` | Browse and search the public template library |
+| `use_template` | Save a public template to your collection |
+
+### Account
+
+| Tool | Description |
+|------|-------------|
+| `whoami` | Show which PromptingBox account is connected |
 
 ## Environment Variables
 

package/dist/api-client.d.ts

@@ -15,6 +15,11 @@ export interface SavePromptResult {
     createdAt: string;
     url: string;
 }
+export interface AccountInfo {
+    id: string;
+    email: string;
+    name: string;
+}
 export interface Folder {
     id: string;
     name: string;
@@ -29,6 +34,58 @@ export interface PromptListItem {
     title: string;
     folderId: string | null;
     folderName: string | null;
+    isFavorite?: boolean;
+}
+export interface PromptDetail {
+    id: string;
+    title: string;
+    content: string;
+    folderId: string | null;
+    folderName: string | null;
+    isFavorite: boolean;
+    tags: Tag[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PromptVersion {
+    id: string;
+    versionNumber: number;
+    title: string;
+    content: string;
+    versionNote: string | null;
+    createdAt: string;
+}
+export interface TemplateListItem {
+    id: string;
+    title: string;
+    description: string | null;
+    category: string;
+    icon: string | null;
+    usageCount: number;
+}
+export interface TemplateDetail {
+    id: string;
+    title: string;
+    content: string;
+    description: string | null;
+    category: string;
+    icon: string | null;
+    usageCount: number;
+}
+export interface TemplateSearchResult {
+    templates: TemplateListItem[];
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        hasMore: boolean;
+    };
+}
+export interface SearchPromptsParams {
+    search?: string;
+    tag?: string;
+    folder?: string;
+    favorites?: boolean;
 }
 export declare class PromptingBoxClient {
     private apiKey;
@@ -42,4 +99,63 @@ export declare class PromptingBoxClient {
     movePromptToFolder(promptId: string, folder: string): Promise<{
         success: boolean;
     }>;
+    getAccountInfo(): Promise<AccountInfo>;
+    getPrompt(id: string): Promise<PromptDetail>;
+    searchPrompts(params: SearchPromptsParams): Promise<PromptListItem[]>;
+    updatePrompt(id: string, updates: {
+        title?: string;
+        content?: string;
+    }): Promise<{
+        success: boolean;
+        id: string;
+        versionCreated: boolean;
+        newVersionNumber: number | null;
+    }>;
+    deletePrompt(id: string): Promise<{
+        success: boolean;
+    }>;
+    duplicatePrompt(id: string): Promise<{
+        id: string;
+        title: string;
+        url: string;
+    }>;
+    toggleFavorite(id: string, isFavorite: boolean): Promise<{
+        success: boolean;
+        isFavorite: boolean;
+    }>;
+    updatePromptTags(promptId: string, tagNames: string[]): Promise<{
+        success: boolean;
+        tags: Tag[];
+    }>;
+    deleteTag(id: string): Promise<{
+        success: boolean;
+        tagName: string;
+    }>;
+    createFolder(name: string): Promise<{
+        id: string;
+        name: string;
+        alreadyExisted: boolean;
+    }>;
+    deleteFolder(id: string): Promise<{
+        success: boolean;
+        folderName: string;
+    }>;
+    listVersions(promptId: string): Promise<PromptVersion[]>;
+    restoreVersion(promptId: string, versionNumber: number): Promise<{
+        success: boolean;
+        restoredVersion: number;
+        newVersionNumber: number;
+    }>;
+    searchTemplates(params?: {
+        search?: string;
+        category?: string;
+        limit?: number;
+        page?: number;
+    }): Promise<TemplateSearchResult>;
+    getTemplate(id: string): Promise<TemplateDetail>;
+    useTemplate(templateId: string): Promise<{
+        promptId: string;
+        title: string;
+        url: string;
+    }>;
 }

package/dist/api-client.js

@@ -22,25 +22,124 @@ export class PromptingBoxClient {
         }
         return res.json();
     }
+    // ── Existing methods ─────────────────────────────────────────────────────
     async savePrompt(params) {
-        return this.request('/api/mcp/prompts', {
+        return this.request('/api/mcp/prompt', {
             method: 'POST',
             body: JSON.stringify(params),
         });
     }
     async listFolders() {
-        return this.request('/api/mcp/folders');
+        return this.request('/api/mcp/folder');
     }
     async listTags() {
-        return this.request('/api/mcp/tags');
+        return this.request('/api/mcp/tag');
     }
     async listPrompts() {
-        return this.request('/api/mcp/prompts');
+        return this.request('/api/mcp/prompt');
     }
     async movePromptToFolder(promptId, folder) {
-        return this.request(`/api/mcp/prompts/${promptId}/folder`, {
+        return this.request(`/api/mcp/prompt/${promptId}/folder`, {
             method: 'PATCH',
             body: JSON.stringify({ folder }),
         });
     }
+    async getAccountInfo() {
+        return this.request('/api/mcp/me');
+    }
+    // ── New: Prompt operations ───────────────────────────────────────────────
+    async getPrompt(id) {
+        return this.request(`/api/mcp/prompt/${id}`);
+    }
+    async searchPrompts(params) {
+        const qs = new URLSearchParams();
+        if (params.search)
+            qs.set('search', params.search);
+        if (params.tag)
+            qs.set('tag', params.tag);
+        if (params.folder)
+            qs.set('folder', params.folder);
+        if (params.favorites)
+            qs.set('favorites', 'true');
+        const query = qs.toString();
+        return this.request(`/api/mcp/prompt${query ? `?${query}` : ''}`);
+    }
+    async updatePrompt(id, updates) {
+        return this.request(`/api/mcp/prompt/${id}`, {
+            method: 'PATCH',
+            body: JSON.stringify(updates),
+        });
+    }
+    async deletePrompt(id) {
+        return this.request(`/api/mcp/prompt/${id}`, {
+            method: 'DELETE',
+        });
+    }
+    async duplicatePrompt(id) {
+        return this.request(`/api/mcp/prompt/${id}/duplicate`, {
+            method: 'POST',
+        });
+    }
+    async toggleFavorite(id, isFavorite) {
+        return this.request(`/api/mcp/prompt/${id}/favorite`, {
+            method: 'PUT',
+            body: JSON.stringify({ isFavorite }),
+        });
+    }
+    // ── New: Tag operations ──────────────────────────────────────────────────
+    async updatePromptTags(promptId, tagNames) {
+        return this.request(`/api/mcp/prompt/${promptId}/tag`, {
+            method: 'PUT',
+            body: JSON.stringify({ tagNames }),
+        });
+    }
+    async deleteTag(id) {
+        return this.request(`/api/mcp/tag/${id}`, {
+            method: 'DELETE',
+        });
+    }
+    // ── New: Folder operations ───────────────────────────────────────────────
+    async createFolder(name) {
+        return this.request('/api/mcp/folder', {
+            method: 'POST',
+            body: JSON.stringify({ name }),
+        });
+    }
+    async deleteFolder(id) {
+        return this.request(`/api/mcp/folder/${id}`, {
+            method: 'DELETE',
+        });
+    }
+    // ── New: Version operations ──────────────────────────────────────────────
+    async listVersions(promptId) {
+        return this.request(`/api/mcp/prompt/${promptId}/version`);
+    }
+    async restoreVersion(promptId, versionNumber) {
+        return this.request(`/api/mcp/prompt/${promptId}/restore`, {
+            method: 'POST',
+            body: JSON.stringify({ versionNumber }),
+        });
+    }
+    // ── New: Template operations ─────────────────────────────────────────────
+    async searchTemplates(params) {
+        const qs = new URLSearchParams();
+        if (params?.search)
+            qs.set('search', params.search);
+        if (params?.category)
+            qs.set('category', params.category);
+        if (params?.limit)
+            qs.set('limit', String(params.limit));
+        if (params?.page)
+            qs.set('page', String(params.page));
+        const query = qs.toString();
+        return this.request(`/api/mcp/template${query ? `?${query}` : ''}`);
+    }
+    async getTemplate(id) {
+        return this.request(`/api/mcp/template/${id}`);
+    }
+    async useTemplate(templateId) {
+        return this.request(`/api/mcp/template/${templateId}/use`, {
+            method: 'POST',
+        });
+    }
 }

package/dist/index.js

@@ -11,10 +11,100 @@ if (!API_KEY) {
     process.exit(1);
 }
 const client = new PromptingBoxClient({ apiKey: API_KEY, baseUrl: BASE_URL });
+const CURRENT_VERSION = '0.3.0';
+// Cache account info so we can surface it in every response
+let accountEmail = null;
+async function getAccountLabel() {
+    if (accountEmail)
+        return accountEmail;
+    try {
+        const info = await client.getAccountInfo();
+        accountEmail = info.email;
+        return accountEmail;
+    }
+    catch {
+        return 'unknown (could not verify)';
+    }
+}
+// ── Version update check (once per process lifetime) ─────────────────────────
+let updateNotice = null;
+let updateChecked = false;
+function isNewer(latest, current) {
+    const l = latest.split('.').map(Number);
+    const c = current.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        if ((l[i] ?? 0) > (c[i] ?? 0))
+            return true;
+        if ((l[i] ?? 0) < (c[i] ?? 0))
+            return false;
+    }
+    return false;
+}
+async function checkForUpdate() {
+    if (updateChecked)
+        return updateNotice;
+    updateChecked = true;
+    try {
+        const versionUrl = `${BASE_URL || 'https://www.promptingbox.com'}/api/mcp/version`;
+        const res = await fetch(versionUrl);
+        if (!res.ok)
+            return null;
+        const data = await res.json();
+        const latest = data.mcp;
+        if (!latest)
+            return null;
+        if (isNewer(latest, CURRENT_VERSION)) {
+            updateNotice = [
+                ``,
+                `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
+                `  New version available: v${CURRENT_VERSION} → v${latest}`,
+                `  Run: npm install -g @promptingbox/mcp`,
+                `  Changelog: https://www.promptingbox.com/docs/mcp`,
+                `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
+            ].join('\n');
+        }
+        return updateNotice;
+    }
+    catch {
+        return null;
+    }
+}
+/** Combined response suffix: account label + update notice (if available) */
+async function getResponseSuffix() {
+    const [email, update] = await Promise.all([
+        getAccountLabel(),
+        checkForUpdate(),
+    ]);
+    let suffix = `🔑 Account: ${email}`;
+    if (update)
+        suffix += `\n${update}`;
+    return suffix;
+}
+/** Resolve promptId from either explicit ID or title search */
+async function resolvePromptId(promptId, promptTitle) {
+    if (promptId)
+        return { id: promptId };
+    if (!promptTitle)
+        return { error: 'Provide either promptId or promptTitle.' };
+    const all = await client.listPrompts();
+    const lower = promptTitle.toLowerCase();
+    const matches = all.filter((p) => p.title.toLowerCase().includes(lower));
+    if (matches.length === 0)
+        return { error: `No prompt found matching "${promptTitle}".` };
+    if (matches.length > 1) {
+        const list = matches.map((p) => `- ${p.title} (id: ${p.id})`).join('\n');
+        return { error: `Multiple prompts match "${promptTitle}". Use promptId to be specific:\n${list}` };
+    }
+    return { id: matches[0].id };
+}
+function errorResult(message) {
+    return { content: [{ type: 'text', text: message }], isError: true };
+}
 const server = new McpServer({
     name: 'promptingbox',
-    version: '0.1.0',
+    version: CURRENT_VERSION,
 });
+const baseUrl = BASE_URL ?? 'https://www.promptingbox.com';
 // ── save_prompt ──────────────────────────────────────────────────────────────
 server.tool('save_prompt', 'Save a prompt to the user\'s PromptingBox account. Use this when the user wants to save, store, or bookmark a prompt.', {
     title: z.string().describe('A short, descriptive title for the prompt'),
@@ -23,54 +113,451 @@ server.tool('save_prompt', 'Save a prompt to the user\'s PromptingBox account. U
     tagNames: z.array(z.string()).optional().describe('Tag names to apply (created if they don\'t exist)'),
 }, async ({ title, content, folder, tagNames }) => {
     try {
-        const result = await client.savePrompt({ title, content, folder, tagNames });
+        const [result, suffix] = await Promise.all([
+            client.savePrompt({ title, content, folder, tagNames }),
+            getResponseSuffix(),
+        ]);
         return {
             content: [
                 {
                     type: 'text',
                     text: `Prompt saved to PromptingBox!\n\nTitle: ${result.title}\nID: ${result.id}\nURL: ${result.url}` +
-                        (result.folderId ? `\nFolder: ${folder}` : ''),
+                        (result.folderId ? `\nFolder: ${folder}` : '') +
+                        `\n\n${suffix}`,
                 },
             ],
         };
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);
+        return errorResult(`Failed to save prompt: ${message}`);
+    }
+});
+// ── get_prompt ───────────────────────────────────────────────────────────────
+server.tool('get_prompt', 'Get the full content of a single prompt from PromptingBox. Returns title, content, tags, folder, and metadata.', {
+    promptId: z.string().optional().describe('The prompt ID. Provide this or promptTitle.'),
+    promptTitle: z.string().optional().describe('The prompt title to search for. Provide this or promptId.'),
+}, async ({ promptId, promptTitle }) => {
+    try {
+        const resolved = await resolvePromptId(promptId, promptTitle);
+        if ('error' in resolved)
+            return errorResult(resolved.error);
+        const [prompt, suffix] = await Promise.all([
+            client.getPrompt(resolved.id),
+            getResponseSuffix(),
+        ]);
+        const tagList = prompt.tags.length > 0
+            ? `Tags: ${prompt.tags.map((t) => t.name).join(', ')}`
+            : 'Tags: (none)';
+        return {
+            content: [{
+                    type: 'text',
+                    text: `# ${prompt.title}\n\nID: ${prompt.id}\n` +
+                        `Folder: ${prompt.folderName ?? '(none)'}\n` +
+                        `${tagList}\n` +
+                        `Favorite: ${prompt.isFavorite ? 'Yes' : 'No'}\n` +
+                        `URL: ${baseUrl}/workspace/prompt/${prompt.id}\n\n` +
+                        `---\n\n${prompt.content}\n\n${suffix}`,
+                }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(`Failed to get prompt: ${message}`);
+    }
+});
+// ── search_prompts ──────────────────────────────────────────────────────────
+server.tool('search_prompts', 'Search prompts in PromptingBox by title, content, tag, folder, or favorites. Returns matching prompts.', {
+    query: z.string().optional().describe('Search text to match against title and content'),
+    tag: z.string().optional().describe('Filter by tag name'),
+    folder: z.string().optional().describe('Filter by folder name'),
+    favorites: z.boolean().optional().describe('Set to true to only show favorited prompts'),
+}, async ({ query, tag, folder, favorites }) => {
+    try {
+        const [results, suffix] = await Promise.all([
+            client.searchPrompts({ search: query, tag, folder, favorites }),
+            getResponseSuffix(),
+        ]);
+        if (results.length === 0) {
+            return {
+                content: [{ type: 'text', text: `No prompts found matching your search.\n\n${suffix}` }],
+            };
+        }
+        const lines = results.map((p) => `- ${p.isFavorite ? '⭐ ' : ''}${p.title} (id: \`${p.id}\`)${p.folderName ? ` — 📁 ${p.folderName}` : ''}`);
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Found ${results.length} prompt${results.length === 1 ? '' : 's'}:\n\n${lines.join('\n')}\n\n${suffix}`,
+                }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(`Failed to search prompts: ${message}`);
+    }
+});
+// ── update_prompt ───────────────────────────────────────────────────────────
+server.tool('update_prompt', 'Update the title and/or content of an existing prompt. If content changes, a new version is automatically created.', {
+    promptId: z.string().optional().describe('The prompt ID. Provide this or promptTitle.'),
+    promptTitle: z.string().optional().describe('The prompt title to search for. Provide this or promptId.'),
+    title: z.string().optional().describe('New title for the prompt'),
+    content: z.string().optional().describe('New content for the prompt'),
+}, async ({ promptId, promptTitle, title, content }) => {
+    try {
+        if (!title && !content)
+            return errorResult('Provide at least a new title or content to update.');
+        const resolved = await resolvePromptId(promptId, promptTitle);
+        if ('error' in resolved)
+            return errorResult(resolved.error);
+        const [result, suffix] = await Promise.all([
+            client.updatePrompt(resolved.id, { title, content }),
+            getResponseSuffix(),
+        ]);
+        let text = `Prompt updated successfully!\nID: ${result.id}`;
+        if (result.versionCreated) {
+            text += `\nNew version created: v${result.newVersionNumber}`;
+        }
+        text += `\nURL: ${baseUrl}/workspace/prompt/${result.id}`;
+        text += `\n\n${suffix}`;
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(`Failed to update prompt: ${message}`);
+    }
+});
+// ── delete_prompt ───────────────────────────────────────────────────────────
+server.tool('delete_prompt', 'Permanently delete a prompt from PromptingBox. This also deletes all versions and tag associations.', {
+    promptId: z.string().optional().describe('The prompt ID. Provide this or promptTitle.'),
+    promptTitle: z.string().optional().describe('The prompt title to search for. Provide this or promptId.'),
+}, async ({ promptId, promptTitle }) => {
+    try {
+        const resolved = await resolvePromptId(promptId, promptTitle);
+        if ('error' in resolved)
+            return errorResult(resolved.error);
+        await client.deletePrompt(resolved.id);
+        const suffix = await getResponseSuffix();
+        return {
+            content: [{ type: 'text', text: `Prompt deleted successfully.\n\n${suffix}` }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(`Failed to delete prompt: ${message}`);
+    }
+});
+// ── duplicate_prompt ────────────────────────────────────────────────────────
+server.tool('duplicate_prompt', 'Create a copy of an existing prompt. The copy gets "(Copy)" appended to the title and inherits the same folder and tags.', {
+    promptId: z.string().optional().describe('The prompt ID. Provide this or promptTitle.'),
+    promptTitle: z.string().optional().describe('The prompt title to search for. Provide this or promptId.'),
+}, async ({ promptId, promptTitle }) => {
+    try {
+        const resolved = await resolvePromptId(promptId, promptTitle);
+        if ('error' in resolved)
+            return errorResult(resolved.error);
+        const [result, suffix] = await Promise.all([
+            client.duplicatePrompt(resolved.id),
+            getResponseSuffix(),
+        ]);
         return {
-            content: [{ type: 'text', text: `Failed to save prompt: ${message}` }],
-            isError: true,
+            content: [{
+                    type: 'text',
+                    text: `Prompt duplicated!\n\nTitle: ${result.title}\nID: ${result.id}\nURL: ${result.url}\n\n${suffix}`,
+                }],
         };
     }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(`Failed to duplicate prompt: ${message}`);
+    }
+});
+// ── toggle_favorite ─────────────────────────────────────────────────────────
+server.tool('toggle_favorite', 'Star or unstar a prompt in PromptingBox.', {
+    promptId: z.string().optional().describe('The prompt ID. Provide this or promptTitle.'),
+    promptTitle: z.string().optional().describe('The prompt title to search for. Provide this or promptId.'),
+    isFavorite: z.boolean().describe('true to favorite, false to unfavorite'),
+}, async ({ promptId, promptTitle, isFavorite }) => {
+    try {
+        const resolved = await resolvePromptId(promptId, promptTitle);
+        if ('error' in resolved)
+            return errorResult(resolved.error);
+        await client.toggleFavorite(resolved.id, isFavorite);
+        const suffix = await getResponseSuffix();
+        const action = isFavorite ? 'favorited ⭐' : 'unfavorited';
+        return {
+            content: [{ type: 'text', text: `Prompt ${action}.\n\n${suffix}` }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(`Failed to toggle favorite: ${message}`);
+    }
+});
+// ── add_tags ────────────────────────────────────────────────────────────────
+server.tool('add_tags', 'Set tags on a prompt (by tag name). This replaces all existing tags on the prompt. Tags are auto-created if they don\'t exist.', {
+    promptId: z.string().optional().describe('The prompt ID. Provide this or promptTitle.'),
+    promptTitle: z.string().optional().describe('The prompt title to search for. Provide this or promptId.'),
+    tagNames: z.array(z.string()).describe('Tag names to set on the prompt (replaces existing tags)'),
+}, async ({ promptId, promptTitle, tagNames }) => {
+    try {
+        const resolved = await resolvePromptId(promptId, promptTitle);
+        if ('error' in resolved)
+            return errorResult(resolved.error);
+        const [result, suffix] = await Promise.all([
+            client.updatePromptTags(resolved.id, tagNames),
+            getResponseSuffix(),
+        ]);
+        const tagList = result.tags.map((t) => t.name).join(', ');
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Tags updated: ${tagList || '(no tags)'}.\n\n${suffix}`,
+                }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(`Failed to update tags: ${message}`);
+    }
+});
+// ── delete_tag ──────────────────────────────────────────────────────────────
+server.tool('delete_tag', 'Delete a tag entirely from PromptingBox. Removes it from all prompts that use it.', {
+    tagId: z.string().optional().describe('The tag ID. Provide this or tagName.'),
+    tagName: z.string().optional().describe('The tag name. Provide this or tagId.'),
+}, async ({ tagId, tagName }) => {
+    try {
+        let resolvedId = tagId;
+        if (!resolvedId) {
+            if (!tagName)
+                return errorResult('Provide either tagId or tagName.');
+            const allTags = await client.listTags();
+            const lower = tagName.toLowerCase();
+            const matches = allTags.filter((t) => t.name.toLowerCase() === lower);
+            if (matches.length === 0)
+                return errorResult(`No tag found matching "${tagName}".`);
+            resolvedId = matches[0].id;
+        }
+        const [result, suffix] = await Promise.all([
+            client.deleteTag(resolvedId),
+            getResponseSuffix(),
+        ]);
+        return {
+            content: [{ type: 'text', text: `Tag "${result.tagName}" deleted.\n\n${suffix}` }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(`Failed to delete tag: ${message}`);
+    }
+});
+// ── create_folder ───────────────────────────────────────────────────────────
+server.tool('create_folder', 'Create a new folder in PromptingBox. If a folder with the same name exists, returns the existing one.', {
+    name: z.string().describe('The folder name to create'),
+}, async ({ name }) => {
+    try {
+        const [result, suffix] = await Promise.all([
+            client.createFolder(name),
+            getResponseSuffix(),
+        ]);
+        const status = result.alreadyExisted ? 'already exists' : 'created';
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Folder "${result.name}" ${status}.\nID: ${result.id}\n\n${suffix}`,
+                }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(`Failed to create folder: ${message}`);
+    }
+});
+// ── delete_folder ───────────────────────────────────────────────────────────
+server.tool('delete_folder', 'Delete a folder from PromptingBox. Prompts in the folder are moved to the root (not deleted).', {
+    folderId: z.string().optional().describe('The folder ID. Provide this or folderName.'),
+    folderName: z.string().optional().describe('The folder name. Provide this or folderId.'),
+}, async ({ folderId, folderName }) => {
+    try {
+        let resolvedId = folderId;
+        if (!resolvedId) {
+            if (!folderName)
+                return errorResult('Provide either folderId or folderName.');
+            const allFolders = await client.listFolders();
+            const lower = folderName.toLowerCase();
+            const matches = allFolders.filter((f) => f.name.toLowerCase() === lower);
+            if (matches.length === 0)
+                return errorResult(`No folder found matching "${folderName}".`);
+            resolvedId = matches[0].id;
+        }
+        const [result, suffix] = await Promise.all([
+            client.deleteFolder(resolvedId),
+            getResponseSuffix(),
+        ]);
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Folder "${result.folderName}" deleted. Prompts moved to root.\n\n${suffix}`,
+                }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(`Failed to delete folder: ${message}`);
+    }
+});
+// ── list_versions ───────────────────────────────────────────────────────────
+server.tool('list_versions', 'Get the version history for a prompt. Shows all saved versions with their version numbers, notes, and timestamps.', {
+    promptId: z.string().optional().describe('The prompt ID. Provide this or promptTitle.'),
+    promptTitle: z.string().optional().describe('The prompt title to search for. Provide this or promptId.'),
+}, async ({ promptId, promptTitle }) => {
+    try {
+        const resolved = await resolvePromptId(promptId, promptTitle);
+        if ('error' in resolved)
+            return errorResult(resolved.error);
+        const [versions, suffix] = await Promise.all([
+            client.listVersions(resolved.id),
+            getResponseSuffix(),
+        ]);
+        if (versions.length === 0) {
+            return {
+                content: [{ type: 'text', text: `No versions found.\n\n${suffix}` }],
+            };
+        }
+        const lines = versions.map((v) => `- **v${v.versionNumber}** — ${v.versionNote ?? 'No note'} (${new Date(v.createdAt).toLocaleDateString()})`);
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Version history (${versions.length} version${versions.length === 1 ? '' : 's'}):\n\n${lines.join('\n')}\n\n${suffix}`,
+                }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(`Failed to list versions: ${message}`);
+    }
+});
+// ── restore_version ─────────────────────────────────────────────────────────
+server.tool('restore_version', 'Restore a prompt to a previous version. Creates a new version with the restored content.', {
+    promptId: z.string().optional().describe('The prompt ID. Provide this or promptTitle.'),
+    promptTitle: z.string().optional().describe('The prompt title to search for. Provide this or promptId.'),
+    versionNumber: z.number().int().positive().describe('The version number to restore to'),
+}, async ({ promptId, promptTitle, versionNumber }) => {
+    try {
+        const resolved = await resolvePromptId(promptId, promptTitle);
+        if ('error' in resolved)
+            return errorResult(resolved.error);
+        const [result, suffix] = await Promise.all([
+            client.restoreVersion(resolved.id, versionNumber),
+            getResponseSuffix(),
+        ]);
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Restored to version ${result.restoredVersion}. New version created: v${result.newVersionNumber}.\n\n${suffix}`,
+                }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(`Failed to restore version: ${message}`);
+    }
+});
+// ── search_templates ────────────────────────────────────────────────────────
+server.tool('search_templates', 'Browse and search the PromptingBox public template library. Find pre-built prompts you can save to your collection.', {
+    query: z.string().optional().describe('Search text to match against template titles and descriptions'),
+    category: z.string().optional().describe('Filter by category (e.g. "Business", "Writing", "Development")'),
+    limit: z.number().int().min(1).max(50).optional().default(10).describe('Number of results to return (default 10)'),
+}, async ({ query, category, limit }) => {
+    try {
+        const result = await client.searchTemplates({ search: query, category, limit });
+        const suffix = await getResponseSuffix();
+        if (result.templates.length === 0) {
+            return {
+                content: [{ type: 'text', text: `No templates found matching your search.\n\n${suffix}` }],
+            };
+        }
+        const lines = result.templates.map((t) => `- **${t.title}** (${t.category})${t.description ? ` — ${t.description}` : ''}\n  ID: \`${t.id}\` | Used ${t.usageCount} times`);
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Found ${result.pagination.total} template${result.pagination.total === 1 ? '' : 's'}` +
+                        `${result.pagination.hasMore ? ` (showing first ${result.templates.length})` : ''}:\n\n${lines.join('\n\n')}` +
+                        `\n\nUse \`use_template\` with the template ID to save one to your collection.\n\n${suffix}`,
+                }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(`Failed to search templates: ${message}`);
+    }
+});
+// ── use_template ────────────────────────────────────────────────────────────
+server.tool('use_template', 'Save a public template to your PromptingBox collection. Creates a copy you can edit and customize.', {
+    templateId: z.string().describe('The template ID (from search_templates)'),
+}, async ({ templateId }) => {
+    try {
+        const [result, suffix] = await Promise.all([
+            client.useTemplate(templateId),
+            getResponseSuffix(),
+        ]);
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Template saved to your collection!\n\nTitle: ${result.title}\nID: ${result.promptId}\nURL: ${result.url}\n\n${suffix}`,
+                }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(`Failed to use template: ${message}`);
+    }
+});
+// ── whoami ──────────────────────────────────────────────────────────────────
+server.tool('whoami', 'Show which PromptingBox account is connected to this MCP server.', {}, async () => {
+    try {
+        const [info, update] = await Promise.all([
+            client.getAccountInfo(),
+            checkForUpdate(),
+        ]);
+        accountEmail = info.email; // refresh cache
+        let text = `Connected to PromptingBox as:\n\nEmail: ${info.email}\nName: ${info.name || '(not set)'}\nID: ${info.id}`;
+        if (update)
+            text += `\n\n${update}`;
+        return {
+            content: [{ type: 'text', text }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(`Failed to get account info: ${message}`);
+    }
 });
 // ── list_folders ─────────────────────────────────────────────────────────────
 server.tool('list_folders', 'List all folders in the user\'s PromptingBox account. Useful to know where to save a prompt.', {}, async () => {
     try {
-        const folders = await client.listFolders();
+        const [folders, suffix] = await Promise.all([client.listFolders(), getResponseSuffix()]);
         if (folders.length === 0) {
             return {
-                content: [{ type: 'text', text: 'No folders found. You can specify a folder name when saving and it will be created automatically.' }],
+                content: [{ type: 'text', text: `No folders found. You can specify a folder name when saving and it will be created automatically.\n\n${suffix}` }],
             };
         }
-        const list = folders.map((f) => `- ${f.name}`).join('\n');
+        const list = folders.map((f) => `- ${f.name} (id: \`${f.id}\`)`).join('\n');
         return {
-            content: [{ type: 'text', text: `Folders in PromptingBox:\n${list}` }],
+            content: [{ type: 'text', text: `Folders in PromptingBox:\n${list}\n\n${suffix}` }],
         };
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);
-        return {
-            content: [{ type: 'text', text: `Failed to list folders: ${message}` }],
-            isError: true,
-        };
+        return errorResult(`Failed to list folders: ${message}`);
     }
 });
 // ── list_prompts ─────────────────────────────────────────────────────────────
 server.tool('list_prompts', 'List all prompts in the user\'s PromptingBox account grouped by folder. Use this to see what prompts exist and where they are organized.', {}, async () => {
     try {
-        const prompts = await client.listPrompts();
+        const [prompts, suffix] = await Promise.all([client.listPrompts(), getResponseSuffix()]);
         if (prompts.length === 0) {
             return {
-                content: [{ type: 'text', text: 'No prompts found.' }],
+                content: [{ type: 'text', text: `No prompts found.\n\n${suffix}` }],
             };
         }
         // Group by folder
@@ -89,25 +576,23 @@ server.tool('list_prompts', 'List all prompts in the user\'s PromptingBox accoun
                 return -1;
             return a.localeCompare(b);
         });
-        const baseUrl = BASE_URL ?? 'https://www.promptingbox.com';
         const lines = [`Your PromptingBox prompts (${prompts.length} total):\n`];
         for (const key of sortedKeys) {
             lines.push(`📁 ${key}`);
             for (const p of grouped.get(key)) {
-                lines.push(`   • [${p.title}](${baseUrl}/workspace/prompts/${p.id})  \`${p.id}\``);
+                const fav = p.isFavorite ? '⭐ ' : '';
+                lines.push(`   • ${fav}[${p.title}](${baseUrl}/workspace/prompt/${p.id})  \`${p.id}\``);
             }
             lines.push('');
         }
+        lines.push(suffix);
         return {
             content: [{ type: 'text', text: lines.join('\n').trimEnd() }],
         };
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);
-        return {
-            content: [{ type: 'text', text: `Failed to list prompts: ${message}` }],
-            isError: true,
-        };
+        return errorResult(`Failed to list prompts: ${message}`);
     }
 });
 // ── move_prompt_to_folder ─────────────────────────────────────────────────
@@ -117,65 +602,37 @@ server.tool('move_prompt_to_folder', 'Move a prompt to a different folder. Provi
     folder: z.string().describe('The folder name to move the prompt into'),
 }, async ({ promptId, promptTitle, folder }) => {
     try {
-        let resolvedId = promptId;
-        if (!resolvedId) {
-            if (!promptTitle) {
-                return {
-                    content: [{ type: 'text', text: 'Provide either promptId or promptTitle.' }],
-                    isError: true,
-                };
-            }
-            const all = await client.listPrompts();
-            const lower = promptTitle.toLowerCase();
-            const matches = all.filter((p) => p.title.toLowerCase().includes(lower));
-            if (matches.length === 0) {
-                return {
-                    content: [{ type: 'text', text: `No prompt found matching "${promptTitle}".` }],
-                    isError: true,
-                };
-            }
-            if (matches.length > 1) {
-                const list = matches.map((p) => `- ${p.title} (id: ${p.id})`).join('\n');
-                return {
-                    content: [{ type: 'text', text: `Multiple prompts match "${promptTitle}". Use promptId to be specific:\n${list}` }],
-                    isError: true,
-                };
-            }
-            resolvedId = matches[0].id;
-        }
-        await client.movePromptToFolder(resolvedId, folder);
+        const resolved = await resolvePromptId(promptId, promptTitle);
+        if ('error' in resolved)
+            return errorResult(resolved.error);
+        await client.movePromptToFolder(resolved.id, folder);
+        const suffix = await getResponseSuffix();
         return {
-            content: [{ type: 'text', text: `Moved prompt to folder "${folder}".` }],
+            content: [{ type: 'text', text: `Moved prompt to folder "${folder}".\n\n${suffix}` }],
         };
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);
-        return {
-            content: [{ type: 'text', text: `Failed to move prompt: ${message}` }],
-            isError: true,
-        };
+        return errorResult(`Failed to move prompt: ${message}`);
     }
 });
 // ── list_tags ────────────────────────────────────────────────────────────────
 server.tool('list_tags', 'List all tags in the user\'s PromptingBox account. Useful to know what tags are available when saving a prompt.', {}, async () => {
     try {
-        const tags = await client.listTags();
+        const [tags, suffix] = await Promise.all([client.listTags(), getResponseSuffix()]);
         if (tags.length === 0) {
             return {
-                content: [{ type: 'text', text: 'No tags found. You can specify tag names when saving and they will be created automatically.' }],
+                content: [{ type: 'text', text: `No tags found. You can specify tag names when saving and they will be created automatically.\n\n${suffix}` }],
             };
         }
-        const list = tags.map((t) => `- ${t.name}`).join('\n');
+        const list = tags.map((t) => `- ${t.name} (id: \`${t.id}\`)`).join('\n');
         return {
-            content: [{ type: 'text', text: `Tags in PromptingBox:\n${list}` }],
+            content: [{ type: 'text', text: `Tags in PromptingBox:\n${list}\n\n${suffix}` }],
         };
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);
-        return {
-            content: [{ type: 'text', text: `Failed to list tags: ${message}` }],
-            isError: true,
-        };
+        return errorResult(`Failed to list tags: ${message}`);
     }
 });
 // ── start server ─────────────────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@promptingbox/mcp",
-  "version": "0.1.3",
+  "version": "0.3.0",
   "description": "MCP server for PromptingBox — save prompts from Claude, Cursor, and ChatGPT",
   "license": "MIT",
   "type": "module",