@mentionova/mcp-server 1.2.0 → 1.3.0

package/index.js

@@ -473,6 +473,511 @@ server.tool(
   }
 );
 
+// --- Workflows ---
+
+server.tool(
+  "mentionova_list_workflows",
+  "List automation workflows in a workspace",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    status: z.enum(["draft", "active", "paused", "archived"]).optional().describe("Filter by status"),
+    limit: z.number().optional(),
+    offset: z.number().optional(),
+  },
+  async ({ workspace_id, status, limit, offset }) => {
+    const data = await api(`/workspaces/${workspace_id}/workflows`, { status, limit, offset });
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_create_workflow",
+  "Create a new automation workflow",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    name: z.string().describe("Workflow name"),
+    description: z.string().optional(),
+    status: z.enum(["draft", "active", "paused"]).optional(),
+    graph: z.object({ steps: z.array(z.any()), edges: z.array(z.any()) }).optional().describe("DAG definition"),
+    schedule_cron: z.string().optional().describe("Cron expression for scheduled runs"),
+  },
+  async ({ workspace_id, ...body }) => {
+    const data = await apiPost(`/workspaces/${workspace_id}/workflows`, body);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_get_workflow",
+  "Get a specific workflow by ID",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    workflow_id: z.string().describe("Workflow UUID"),
+  },
+  async ({ workspace_id, workflow_id }) => {
+    const data = await api(`/workspaces/${workspace_id}/workflows/${workflow_id}`);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_update_workflow",
+  "Update a workflow's name, status, graph, or schedule",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    workflow_id: z.string().describe("Workflow UUID"),
+    name: z.string().optional(),
+    description: z.string().optional(),
+    status: z.enum(["draft", "active", "paused", "archived"]).optional(),
+    graph: z.object({ steps: z.array(z.any()), edges: z.array(z.any()) }).optional(),
+    schedule_cron: z.string().optional(),
+  },
+  async ({ workspace_id, workflow_id, ...body }) => {
+    const data = await apiPatch(`/workspaces/${workspace_id}/workflows/${workflow_id}`, body);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_delete_workflow",
+  "Delete a workflow",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    workflow_id: z.string().describe("Workflow UUID"),
+  },
+  async ({ workspace_id, workflow_id }) => {
+    const data = await apiDelete(`/workspaces/${workspace_id}/workflows/${workflow_id}`);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_list_workflow_runs",
+  "List runs for a specific workflow",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    workflow_id: z.string().describe("Workflow UUID"),
+    status: z.enum(["pending", "running", "completed", "partial", "failed", "cancelled"]).optional(),
+    limit: z.number().optional(),
+    offset: z.number().optional(),
+  },
+  async ({ workspace_id, workflow_id, status, limit, offset }) => {
+    const data = await api(`/workspaces/${workspace_id}/workflows/${workflow_id}/runs`, { status, limit, offset });
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_trigger_workflow",
+  "Trigger a workflow run via the API",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    workflow_id: z.string().describe("Workflow UUID"),
+    input: z.record(z.any()).optional().describe("Input payload for the run"),
+  },
+  async ({ workspace_id, workflow_id, input }) => {
+    const data = await apiPost(`/workspaces/${workspace_id}/workflows/${workflow_id}/runs`, { input });
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+// --- Reddit Engagement ---
+
+server.tool(
+  "mentionova_list_reddit_comments",
+  "List Reddit comment drafts (engagement queue) for a workspace",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    status: z.enum(["draft", "approved", "posted", "skipped"]).optional(),
+    subreddit: z.string().optional().describe("Filter by subreddit"),
+    limit: z.number().optional(),
+    offset: z.number().optional(),
+  },
+  async ({ workspace_id, status, subreddit, limit, offset }) => {
+    const data = await api(`/workspaces/${workspace_id}/reddit`, { status, subreddit, limit, offset });
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_update_reddit_comment",
+  "Update a Reddit comment draft (edit text, change status, assign)",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    comment_id: z.string().describe("Comment UUID"),
+    status: z.enum(["draft", "approved", "posted", "skipped"]).optional(),
+    edited_comment: z.string().optional().describe("Edited comment text"),
+    assigned_to: z.string().optional().describe("User UUID to assign to"),
+  },
+  async ({ workspace_id, comment_id, ...body }) => {
+    const data = await apiPatch(`/workspaces/${workspace_id}/reddit`, { comment_id, ...body });
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_delete_reddit_comment",
+  "Delete a Reddit comment draft",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    comment_id: z.string().describe("Comment UUID"),
+  },
+  async ({ workspace_id, comment_id }) => {
+    const data = await apiDelete(`/workspaces/${workspace_id}/reddit?comment_id=${comment_id}`);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+// --- Reports ---
+
+server.tool(
+  "mentionova_list_shared_reports",
+  "List shared report links for a workspace",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    include_revoked: z.enum(["true", "false"]).optional(),
+    limit: z.number().optional(),
+    offset: z.number().optional(),
+  },
+  async ({ workspace_id, include_revoked, limit, offset }) => {
+    const data = await api(`/workspaces/${workspace_id}/reports`, { include_revoked, limit, offset });
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_create_shared_report",
+  "Create a shareable report link for a workspace",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    channel: z.string().optional().describe("Filter report to a specific AI engine channel"),
+    expires_at: z.string().optional().describe("Expiration date (ISO 8601)"),
+  },
+  async ({ workspace_id, channel, expires_at }) => {
+    const data = await apiPost(`/workspaces/${workspace_id}/reports`, { channel, expires_at });
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_revoke_shared_report",
+  "Revoke a shared report link",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    report_id: z.string().describe("Shared report UUID"),
+  },
+  async ({ workspace_id, report_id }) => {
+    const data = await apiDelete(`/workspaces/${workspace_id}/reports?report_id=${report_id}`);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_list_geo_reports",
+  "List GEO (weekly AI visibility) reports for a workspace",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    status: z.enum(["pending", "generating", "ready", "failed"]).optional(),
+    limit: z.number().optional(),
+    offset: z.number().optional(),
+  },
+  async ({ workspace_id, status, limit, offset }) => {
+    const data = await api(`/workspaces/${workspace_id}/reports/geo`, { status, limit, offset });
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_get_geo_report",
+  "Get a GEO report with its content plays",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    report_id: z.string().describe("GEO report UUID"),
+  },
+  async ({ workspace_id, report_id }) => {
+    const data = await api(`/workspaces/${workspace_id}/reports/geo/${report_id}`);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+// --- Grid Columns ---
+
+server.tool(
+  "mentionova_list_grid_columns",
+  "List columns in a content grid",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    grid_id: z.string().describe("Grid UUID"),
+  },
+  async ({ workspace_id, grid_id }) => {
+    const data = await api(`/workspaces/${workspace_id}/grids/${grid_id}/columns`);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_create_grid_column",
+  "Add a column to a content grid",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    grid_id: z.string().describe("Grid UUID"),
+    key: z.string().describe("Column key (unique within grid)"),
+    display_name: z.string().describe("Column display name"),
+    column_type: z.string().describe("Column type (e.g. text, url, ai_generate)"),
+    config: z.record(z.any()).optional().describe("Column configuration"),
+    position: z.number().optional().describe("Position (auto-assigned if omitted)"),
+    depends_on: z.array(z.string()).optional().describe("Keys of columns this depends on"),
+    is_output: z.boolean().optional(),
+  },
+  async ({ workspace_id, grid_id, ...body }) => {
+    const data = await apiPost(`/workspaces/${workspace_id}/grids/${grid_id}/columns`, body);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_update_grid_column",
+  "Update a grid column's name, type, config, or position",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    grid_id: z.string().describe("Grid UUID"),
+    column_id: z.string().describe("Column UUID"),
+    display_name: z.string().optional(),
+    column_type: z.string().optional(),
+    config: z.record(z.any()).optional(),
+    depends_on: z.array(z.string()).optional(),
+    is_output: z.boolean().optional(),
+    position: z.number().optional(),
+  },
+  async ({ workspace_id, grid_id, column_id, ...body }) => {
+    const data = await apiPatch(`/workspaces/${workspace_id}/grids/${grid_id}/columns/${column_id}`, body);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_delete_grid_column",
+  "Delete a grid column and its cells",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    grid_id: z.string().describe("Grid UUID"),
+    column_id: z.string().describe("Column UUID"),
+  },
+  async ({ workspace_id, grid_id, column_id }) => {
+    const data = await apiDelete(`/workspaces/${workspace_id}/grids/${grid_id}/columns/${column_id}`);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+// --- Grid Rows ---
+
+server.tool(
+  "mentionova_list_grid_rows",
+  "List rows in a content grid",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    grid_id: z.string().describe("Grid UUID"),
+    limit: z.number().optional(),
+    offset: z.number().optional(),
+  },
+  async ({ workspace_id, grid_id, limit, offset }) => {
+    const data = await api(`/workspaces/${workspace_id}/grids/${grid_id}/rows`, { limit, offset });
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_create_grid_row",
+  "Add a row to a content grid",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    grid_id: z.string().describe("Grid UUID"),
+    source: z.enum(["manual", "csv", "webhook"]).optional().describe("Row source (default: manual)"),
+    source_ref: z.record(z.any()).optional(),
+    position: z.number().optional(),
+  },
+  async ({ workspace_id, grid_id, ...body }) => {
+    const data = await apiPost(`/workspaces/${workspace_id}/grids/${grid_id}/rows`, body);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_get_grid_row",
+  "Get a grid row with all its cell values",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    grid_id: z.string().describe("Grid UUID"),
+    row_id: z.string().describe("Row UUID"),
+  },
+  async ({ workspace_id, grid_id, row_id }) => {
+    const data = await api(`/workspaces/${workspace_id}/grids/${grid_id}/rows/${row_id}`);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_update_grid_row",
+  "Update a grid row's position or source reference",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    grid_id: z.string().describe("Grid UUID"),
+    row_id: z.string().describe("Row UUID"),
+    position: z.number().optional(),
+    source_ref: z.record(z.any()).optional(),
+  },
+  async ({ workspace_id, grid_id, row_id, ...body }) => {
+    const data = await apiPatch(`/workspaces/${workspace_id}/grids/${grid_id}/rows/${row_id}`, body);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_delete_grid_row",
+  "Delete a grid row and its cells",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    grid_id: z.string().describe("Grid UUID"),
+    row_id: z.string().describe("Row UUID"),
+  },
+  async ({ workspace_id, grid_id, row_id }) => {
+    const data = await apiDelete(`/workspaces/${workspace_id}/grids/${grid_id}/rows/${row_id}`);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+// --- Grid Cells ---
+
+server.tool(
+  "mentionova_list_grid_cells",
+  "List all cells in a content grid",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    grid_id: z.string().describe("Grid UUID"),
+    limit: z.number().optional(),
+    offset: z.number().optional(),
+  },
+  async ({ workspace_id, grid_id, limit, offset }) => {
+    const data = await api(`/workspaces/${workspace_id}/grids/${grid_id}/cells`, { limit, offset });
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_update_grid_cell",
+  "Update (or create) a cell value in a grid",
+  {
+    workspace_id: z.string().describe("Workspace UUID"),
+    grid_id: z.string().describe("Grid UUID"),
+    row_id: z.string().describe("Row UUID"),
+    column_id: z.string().describe("Column UUID"),
+    value_text: z.string().optional(),
+    value_json: z.record(z.any()).optional(),
+    value_number: z.number().optional(),
+  },
+  async ({ workspace_id, grid_id, ...body }) => {
+    const data = await apiPatch(`/workspaces/${workspace_id}/grids/${grid_id}/cells`, body);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+// --- Marketplace ---
+
+server.tool(
+  "mentionova_list_marketplace_profiles",
+  "Browse marketplace profiles for collaboration opportunities",
+  {
+    status: z.enum(["live", "hidden"]).optional(),
+    industry: z.string().optional(),
+    limit: z.number().optional(),
+    offset: z.number().optional(),
+  },
+  async ({ status, industry, limit, offset }) => {
+    const data = await api("/marketplace/profiles", { status, industry, limit, offset });
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_get_marketplace_profile",
+  "Get a specific marketplace profile",
+  {
+    profile_id: z.string().describe("Profile UUID"),
+  },
+  async ({ profile_id }) => {
+    const data = await api(`/marketplace/profiles/${profile_id}`);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_create_marketplace_profile",
+  "Create a marketplace profile for one of your workspaces",
+  {
+    workspace_id: z.string().describe("Workspace UUID to create profile for"),
+    display_name: z.string().describe("Display name"),
+    tagline: z.string().optional(),
+    description: z.string().optional(),
+    industry: z.string().optional(),
+    website_url: z.string().optional(),
+    collab_types: z.array(z.enum(["newsletter_swap", "social_cross_post", "co_content", "bundle", "event"])).optional(),
+    looking_for: z.string().optional(),
+    show_stats: z.boolean().optional(),
+  },
+  async (body) => {
+    const data = await apiPost("/marketplace/profiles", body);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_update_marketplace_profile",
+  "Update your marketplace profile",
+  {
+    profile_id: z.string().describe("Profile UUID"),
+    display_name: z.string().optional(),
+    tagline: z.string().optional(),
+    description: z.string().optional(),
+    industry: z.string().optional(),
+    website_url: z.string().optional(),
+    collab_types: z.array(z.enum(["newsletter_swap", "social_cross_post", "co_content", "bundle", "event"])).optional(),
+    looking_for: z.string().optional(),
+    show_stats: z.boolean().optional(),
+    status: z.enum(["live", "hidden"]).optional(),
+  },
+  async ({ profile_id, ...body }) => {
+    const data = await apiPatch(`/marketplace/profiles/${profile_id}`, body);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_express_interest",
+  "Express interest in collaborating with a marketplace profile",
+  {
+    to_profile: z.string().describe("Target profile UUID"),
+    type: z.enum(["interest", "reachout", "pass"]).describe("Type of interest"),
+    message: z.string().optional().describe("Message to include"),
+  },
+  async (body) => {
+    const data = await apiPost("/marketplace/interests", body);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "mentionova_list_marketplace_matches",
+  "List your marketplace matches (mutual interests / accepted reachouts)",
+  {
+    limit: z.number().optional(),
+    offset: z.number().optional(),
+  },
+  async ({ limit, offset }) => {
+    const data = await api("/marketplace/matches", { limit, offset });
+    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.2.0",
+  "version": "1.3.0",
   "description": "MCP server for the Mentionova API - connect AI assistants to your AI search visibility data",
   "type": "module",
   "main": "index.js",