mentionwell-mcp-account 0.1.0

package/README.md

@@ -0,0 +1,38 @@
+# mentionwell-mcp-account
+
+MCP server for managing your Mentionwell account from any AI assistant — Claude, Cursor, ChatGPT, Codex.
+
+## Quick install
+
+```json
+{
+  "mcpServers": {
+    "mentionwell": {
+      "command": "npx",
+      "args": ["-y", "mentionwell-mcp-account"],
+      "env": { "MENTIONWELL_TOKEN": "mw_pat_..." }
+    }
+  }
+}
+```
+
+Get a token at [app.mentionwell.com/settings/tokens](https://app.mentionwell.com/settings/tokens).
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `list_sites` | All sites on the account |
+| `get_site_status` | Connection state, post count, last activity |
+| `get_brand_context` | Audience / voice / CTA profile |
+| `update_brand_context` | Patch fields on the brand profile |
+| `probe_site` | Read-only stack/blog/webhook detection for any URL |
+| `start_connect` | Begin a Connect flow (probe + first question) |
+| `advance_connect` | Answer a Connect question |
+| `get_connect` | Current state of a Connect session |
+| `verify_webhook` | Signed test ping to a destination URL |
+| `import_posts` | Pull existing posts from RSS / wp-json / Ghost as drafts |
+
+## Why this exists
+
+Connecting a SaaS to your site usually means: open dashboard, copy keys, paste into env, edit code, deploy, debug. With this MCP your AI assistant does all of that for you in chat — and with [`mentionwell-cli`](https://www.npmjs.com/package/mentionwell-cli) installed, it can also write the route handler in your repo.

package/dist/server.d.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * Mentionwell account MCP server.
+ *
+ * Lets an AI assistant read and act on the user's Mentionwell account:
+ *   - list_sites
+ *   - get_site_status(slug)
+ *   - get_brand_context(slug)
+ *   - update_brand_context(slug, fields)
+ *   - probe_site(url)               → preview Connect output without committing
+ *   - start_connect(slug, url)      → begin a Connect session
+ *   - advance_connect(sessionId, answer, text?)
+ *   - get_connect(sessionId)
+ *   - verify_webhook(slug, siteUrl)
+ *   - import_posts(slug, feedUrl)
+ *
+ * Auth: bearer token. Pass `MENTIONWELL_TOKEN` (a personal access token
+ * from app.mentionwell.com/settings/tokens) when launching the server.
+ * The token is sent as `Authorization: Bearer …` to the Mentionwell API.
+ */
+export {};

package/dist/server.js

@@ -0,0 +1,265 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Mentionwell account MCP server.
+ *
+ * Lets an AI assistant read and act on the user's Mentionwell account:
+ *   - list_sites
+ *   - get_site_status(slug)
+ *   - get_brand_context(slug)
+ *   - update_brand_context(slug, fields)
+ *   - probe_site(url)               → preview Connect output without committing
+ *   - start_connect(slug, url)      → begin a Connect session
+ *   - advance_connect(sessionId, answer, text?)
+ *   - get_connect(sessionId)
+ *   - verify_webhook(slug, siteUrl)
+ *   - import_posts(slug, feedUrl)
+ *
+ * Auth: bearer token. Pass `MENTIONWELL_TOKEN` (a personal access token
+ * from app.mentionwell.com/settings/tokens) when launching the server.
+ * The token is sent as `Authorization: Bearer …` to the Mentionwell API.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const API_BASE = (process.env.MENTIONWELL_API_URL ?? "https://app.mentionwell.com").replace(/\/+$/, "");
+const TOKEN = process.env.MENTIONWELL_TOKEN;
+if (!TOKEN) {
+    console.error("MENTIONWELL_TOKEN is not set. Get one at app.mentionwell.com/settings/tokens.");
+    process.exit(1);
+}
+async function call(path, init) {
+    const res = await fetch(`${API_BASE}${path}`, {
+        ...init,
+        headers: {
+            "content-type": "application/json",
+            authorization: `Bearer ${TOKEN}`,
+            accept: "application/json",
+            ...(init?.headers ?? {})
+        }
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`${res.status} ${path}: ${body.slice(0, 240)}`);
+    }
+    return (await res.json());
+}
+const server = new index_js_1.Server({ name: "mentionwell-account", version: "0.1.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "list_sites",
+            description: "List all Mentionwell sites in the authenticated account.",
+            inputSchema: { type: "object", properties: {}, additionalProperties: false }
+        },
+        {
+            name: "get_site_status",
+            description: "Connection state, post count, and last activity for a site.",
+            inputSchema: {
+                type: "object",
+                properties: { siteSlug: { type: "string" } },
+                required: ["siteSlug"],
+                additionalProperties: false
+            }
+        },
+        {
+            name: "get_brand_context",
+            description: "Read the brand profile (audience, voice, CTA pattern) for a site.",
+            inputSchema: {
+                type: "object",
+                properties: { siteSlug: { type: "string" } },
+                required: ["siteSlug"],
+                additionalProperties: false
+            }
+        },
+        {
+            name: "update_brand_context",
+            description: "Patch fields on a site's brand profile. Only sends fields that are provided.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    siteSlug: { type: "string" },
+                    audience: { type: "string" },
+                    voice: { type: "string" },
+                    ctaPattern: { type: "string" },
+                    summary: { type: "string" }
+                },
+                required: ["siteSlug"],
+                additionalProperties: false
+            }
+        },
+        {
+            name: "probe_site",
+            description: "Read-only probe: detect CMS, framework, host, existing blog, and viable webhook recipe for a URL.",
+            inputSchema: {
+                type: "object",
+                properties: { url: { type: "string" } },
+                required: ["url"],
+                additionalProperties: false
+            }
+        },
+        {
+            name: "start_connect",
+            description: "Begin a Connect session for a site. Runs the probe and returns the first question.",
+            inputSchema: {
+                type: "object",
+                properties: { siteSlug: { type: "string" }, url: { type: "string" } },
+                required: ["siteSlug", "url"],
+                additionalProperties: false
+            }
+        },
+        {
+            name: "advance_connect",
+            description: "Advance a Connect session by answering its current question.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    sessionId: { type: "string" },
+                    answer: { type: "string", description: "Option id from the question (e.g. 'confirm', 'all', 'skip')" },
+                    text: { type: "string", description: "Free-text input when the option requires it" }
+                },
+                required: ["sessionId", "answer"],
+                additionalProperties: false
+            }
+        },
+        {
+            name: "get_connect",
+            description: "Fetch the current state of a Connect session.",
+            inputSchema: {
+                type: "object",
+                properties: { sessionId: { type: "string" } },
+                required: ["sessionId"],
+                additionalProperties: false
+            }
+        },
+        {
+            name: "verify_webhook",
+            description: "Send a signed test ping to the user's site to confirm the webhook is wired correctly.",
+            inputSchema: {
+                type: "object",
+                properties: { siteSlug: { type: "string" }, siteUrl: { type: "string" } },
+                required: ["siteSlug", "siteUrl"],
+                additionalProperties: false
+            }
+        },
+        {
+            name: "import_posts",
+            description: "Pull existing posts from an RSS / wp-json / Ghost feed into Mentionwell as drafts.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    siteSlug: { type: "string" },
+                    feedUrl: { type: "string", description: "RSS feed, /wp-json/wp/v2/posts, or /ghost/api/content/posts/?key=public" }
+                },
+                required: ["siteSlug", "feedUrl"],
+                additionalProperties: false
+            }
+        }
+    ]
+}));
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    const { name, arguments: args = {} } = request.params;
+    const a = args;
+    try {
+        let result;
+        switch (name) {
+            case "list_sites":
+                result = await call("/api/dashboard");
+                break;
+            case "get_site_status":
+                if (!a.siteSlug)
+                    throw new Error("siteSlug is required");
+                result = await call(`/api/sites/${encodeURIComponent(a.siteSlug)}`);
+                break;
+            case "get_brand_context":
+                if (!a.siteSlug)
+                    throw new Error("siteSlug is required");
+                result = await call(`/api/sites/${encodeURIComponent(a.siteSlug)}/integration`);
+                break;
+            case "update_brand_context": {
+                if (!a.siteSlug)
+                    throw new Error("siteSlug is required");
+                const body = {};
+                if (a.audience)
+                    body.audience = a.audience;
+                if (a.voice)
+                    body.voice = a.voice;
+                if (a.ctaPattern)
+                    body.ctaPattern = a.ctaPattern;
+                if (a.summary)
+                    body.summary = a.summary;
+                result = await call(`/api/sites/${encodeURIComponent(a.siteSlug)}`, {
+                    method: "PATCH",
+                    body: JSON.stringify(body)
+                });
+                break;
+            }
+            case "probe_site": {
+                if (!a.url)
+                    throw new Error("url is required");
+                // Probe-only path — runs the same lib/integration/probe code via a
+                // helper endpoint. Falls back to start_connect for the same data.
+                result = await call(`/api/connect/probe`, {
+                    method: "POST",
+                    body: JSON.stringify({ url: a.url })
+                }).catch(async () => {
+                    // Older deployments may not have /api/connect/probe — fall back.
+                    throw new Error("This Mentionwell instance hasn't enabled probe_site yet. Use start_connect instead.");
+                });
+                break;
+            }
+            case "start_connect":
+                if (!a.siteSlug || !a.url)
+                    throw new Error("siteSlug and url are required");
+                result = await call("/api/connect/start", {
+                    method: "POST",
+                    body: JSON.stringify({ siteSlug: a.siteSlug, url: a.url })
+                });
+                break;
+            case "advance_connect":
+                if (!a.sessionId || !a.answer)
+                    throw new Error("sessionId and answer are required");
+                result = await call(`/api/connect/${encodeURIComponent(a.sessionId)}/advance`, {
+                    method: "POST",
+                    body: JSON.stringify({ answer: a.answer, text: a.text })
+                });
+                break;
+            case "get_connect":
+                if (!a.sessionId)
+                    throw new Error("sessionId is required");
+                result = await call(`/api/connect/${encodeURIComponent(a.sessionId)}`);
+                break;
+            case "verify_webhook":
+                if (!a.siteSlug || !a.siteUrl)
+                    throw new Error("siteSlug and siteUrl are required");
+                result = await call(`/api/sites/${encodeURIComponent(a.siteSlug)}/verify-webhook`, {
+                    method: "POST",
+                    body: JSON.stringify({ siteUrl: a.siteUrl })
+                });
+                break;
+            case "import_posts":
+                if (!a.siteSlug || !a.feedUrl)
+                    throw new Error("siteSlug and feedUrl are required");
+                result = await call(`/api/sites/${encodeURIComponent(a.siteSlug)}/import`, {
+                    method: "POST",
+                    body: JSON.stringify({ feedUrl: a.feedUrl })
+                });
+                break;
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (e) {
+        return {
+            content: [{ type: "text", text: e instanceof Error ? e.message : String(e) }],
+            isError: true
+        };
+    }
+});
+const transport = new stdio_js_1.StdioServerTransport();
+server.connect(transport).catch((e) => {
+    console.error("Mentionwell account MCP failed to start:", e);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "mentionwell-mcp-account",
+  "version": "0.1.0",
+  "description": "Mentionwell account MCP server — manage your sites, posts, and connect flow from your AI assistant.",
+  "bin": {
+    "mentionwell-mcp-account": "dist/server.js"
+  },
+  "main": "./dist/server.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}