@mentionova/mcp-server 1.1.0 → 1.2.0

package/index.js

@@ -249,6 +249,60 @@ server.tool(
   }
 );
 
+// --- Write: Workspaces ---
+
+server.tool(
+  "mentionova_create_workspace",
+  "Create a new workspace to track a brand's AI search visibility",
+  {
+    name: z.string().describe("Workspace name (e.g. brand or client name)"),
+    description: z.string().optional().describe("Description"),
+    website_url: z.string().optional().describe("Brand website URL"),
+    industry: z.string().optional().describe("Industry"),
+    competitor_domains: z.array(z.string()).optional().describe("Competitor website domains"),
+    competitor_names: z.array(z.string()).optional().describe("Competitor brand names"),
+    seed_keywords: z.array(z.string()).optional().describe("Initial keywords to track"),
+    brand_aliases: z.array(z.string()).optional().describe("Alternative brand names"),
+  },
+  async (params) => {
+    const data = await apiPost("/workspaces", params);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_update_workspace",
+  "Update a workspace's name, competitors, keywords, or other settings",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    name: z.string().optional().describe("New name"),
+    description: z.string().optional().describe("New description"),
+    website_url: z.string().optional().describe("New website URL"),
+    industry: z.string().optional().describe("New industry"),
+    competitor_domains: z.array(z.string()).optional().describe("New competitor domains"),
+    competitor_names: z.array(z.string()).optional().describe("New competitor names"),
+    seed_keywords: z.array(z.string()).optional().describe("New keywords"),
+    brand_aliases: z.array(z.string()).optional().describe("New brand aliases"),
+    client_context: z.string().optional().describe("Client context/brief"),
+  },
+  async ({ workspace_id, ...body }) => {
+    const data = await apiPatch(`/workspaces/${workspace_id}`, body);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_delete_workspace",
+  "Delete a workspace and all its prompts, runs, citations, and data",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+  },
+  async ({ workspace_id }) => {
+    const data = await apiDelete(`/workspaces/${workspace_id}`);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
 // --- Write: Prompts ---
 
 server.tool(
@@ -315,6 +369,110 @@ server.tool(
   }
 );
 
+// --- Write: Runs ---
+
+server.tool(
+  "mentionova_delete_run",
+  "Delete a specific run and its associated data",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    run_id: z.string().describe("Run UUID to delete"),
+  },
+  async ({ workspace_id, run_id }) => {
+    const data = await apiDelete(`/workspaces/${workspace_id}/runs?run_id=${run_id}`);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+// --- Write: Citations ---
+
+server.tool(
+  "mentionova_delete_citation",
+  "Delete a specific citation",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    citation_id: z.string().describe("Citation UUID to delete"),
+  },
+  async ({ workspace_id, citation_id }) => {
+    const data = await apiDelete(`/workspaces/${workspace_id}/citations?citation_id=${citation_id}`);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+// --- Write: Grids ---
+
+server.tool(
+  "mentionova_create_grid",
+  "Create a new content grid in a workspace",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    name: z.string().describe("Grid name"),
+    description: z.string().optional().describe("Grid description"),
+    template_id: z.string().optional().describe("Template UUID to base grid on"),
+  },
+  async ({ workspace_id, ...body }) => {
+    const data = await apiPost(`/workspaces/${workspace_id}/grids`, body);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_update_grid",
+  "Update a grid's name, description, or status",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    grid_id: z.string().describe("Grid UUID"),
+    name: z.string().optional().describe("New name"),
+    description: z.string().optional().describe("New description"),
+    status: z.enum(["active", "archived"]).optional().describe("New status"),
+  },
+  async ({ workspace_id, ...body }) => {
+    const data = await apiPatch(`/workspaces/${workspace_id}/grids`, body);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_delete_grid",
+  "Delete a grid",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    grid_id: z.string().describe("Grid UUID to delete"),
+  },
+  async ({ workspace_id, grid_id }) => {
+    const data = await apiDelete(`/workspaces/${workspace_id}/grids?grid_id=${grid_id}`);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+// --- Write: Alerts ---
+
+server.tool(
+  "mentionova_mark_alert_read",
+  "Mark an alert/notification as read",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    alert_id: z.string().describe("Alert UUID"),
+  },
+  async ({ workspace_id, alert_id }) => {
+    const data = await apiPatch(`/workspaces/${workspace_id}/alerts`, { alert_id });
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_delete_alert",
+  "Delete an alert/notification",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    alert_id: z.string().describe("Alert UUID to delete"),
+  },
+  async ({ workspace_id, alert_id }) => {
+    const data = await apiDelete(`/workspaces/${workspace_id}/alerts?alert_id=${alert_id}`);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
 // Start the server
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentionova/mcp-server",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "MCP server for the Mentionova API - connect AI assistants to your AI search visibility data",
   "type": "module",
   "main": "index.js",