@mentionova/mcp-server 1.0.0 → 1.1.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,72 @@ server.tool(
   }
 );
 
+// --- 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) }] };
+  }
+);
+
 // 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.1.0",
   "description": "MCP server for the Mentionova API - connect AI assistants to your AI search visibility data",
   "type": "module",
   "main": "index.js",