@mentionova/mcp-server 1.0.0 → 1.2.0

package/index.js

@@ -27,6 +27,53 @@ async function api(path, params = {}) {
   return json;
 }
 
+async function apiPost(path, body = {}) {
+  const url = new URL(`/api/v1${path}`, BASE_URL);
+
+  const res = await fetch(url.toString(), {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${API_KEY}`,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify(body),
+  });
+
+  const json = await res.json();
+  if (!res.ok) throw new Error(json.error || `API error ${res.status}`);
+  return json;
+}
+
+async function apiPatch(path, body = {}) {
+  const url = new URL(`/api/v1${path}`, BASE_URL);
+
+  const res = await fetch(url.toString(), {
+    method: "PATCH",
+    headers: {
+      Authorization: `Bearer ${API_KEY}`,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify(body),
+  });
+
+  const json = await res.json();
+  if (!res.ok) throw new Error(json.error || `API error ${res.status}`);
+  return json;
+}
+
+async function apiDelete(path) {
+  const url = new URL(`/api/v1${path}`, BASE_URL);
+
+  const res = await fetch(url.toString(), {
+    method: "DELETE",
+    headers: { Authorization: `Bearer ${API_KEY}` },
+  });
+
+  const json = await res.json();
+  if (!res.ok) throw new Error(json.error || `API error ${res.status}`);
+  return json;
+}
+
 const server = new McpServer({
   name: "mentionova",
   version: "1.0.0",
@@ -202,6 +249,230 @@ 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(
+  "mentionova_create_prompt",
+  "Create one or more prompts (search queries) to track in a workspace. These will be monitored across AI engines on a schedule.",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    prompt_text: z.string().optional().describe("Single prompt text"),
+    prompt_texts: z.array(z.string()).optional().describe("Multiple prompt texts"),
+    status: z.enum(["active", "paused"]).optional().describe("Initial status (default: active)"),
+    schedule_frequency: z.enum(["daily", "weekly", "biweekly", "monthly"]).optional().describe("Run frequency (default: weekly)"),
+  },
+  async ({ workspace_id, prompt_text, prompt_texts, status, schedule_frequency }) => {
+    const body = { prompt_text, prompt_texts, status, schedule_frequency };
+    const data = await apiPost(`/workspaces/${workspace_id}/prompts`, body);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_update_prompt",
+  "Update a prompt's text, status, schedule, or channels",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    prompt_id: z.string().describe("Prompt UUID"),
+    prompt_text: z.string().optional().describe("New prompt text"),
+    status: z.enum(["active", "paused", "archived"]).optional().describe("New status"),
+    schedule_frequency: z.enum(["daily", "weekly", "biweekly", "monthly"]).optional().describe("New schedule"),
+    channels: z.array(z.string()).optional().describe("AI engine channels to run on"),
+  },
+  async ({ workspace_id, prompt_id, prompt_text, status, schedule_frequency, channels }) => {
+    const body = { prompt_text, status, schedule_frequency, channels };
+    const data = await apiPatch(`/workspaces/${workspace_id}/prompts/${prompt_id}`, body);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_delete_prompt",
+  "Delete a prompt and all its associated runs and citations",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    prompt_id: z.string().describe("Prompt UUID"),
+  },
+  async ({ workspace_id, prompt_id }) => {
+    const data = await apiDelete(`/workspaces/${workspace_id}/prompts/${prompt_id}`);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+// --- Write: Runs ---
+
+server.tool(
+  "mentionova_trigger_run",
+  "Trigger a new run for a prompt. Executes the prompt across AI engines and captures citations and mentions. Returns 202 (accepted) immediately; the run processes in the background.",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    prompt_id: z.string().describe("Prompt UUID to run"),
+    channels: z.array(z.enum(["perplexity", "claude", "chatgpt", "gemini", "google", "reddit"])).optional().describe("Specific channels to run (default: all)"),
+  },
+  async ({ workspace_id, prompt_id, channels }) => {
+    const data = await apiPost(`/workspaces/${workspace_id}/prompts/${prompt_id}/run`, { channels });
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+// --- 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.0.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",