@antoinefamibelle/ghost-mcp 1.0.0

package/README.md

@@ -0,0 +1,286 @@
+# Ghost MCP
+
+A [Model Context Protocol](https://modelcontextprotocol.io) server that gives Claude, Gemini, and any other MCP-compatible AI full access to your [Ghost CMS](https://ghost.org) via the Ghost Admin API.
+
+**Documentation languages:** [English](docs/en/) · [Français](docs/fr/) · [Español](docs/es/)
+
+---
+
+## Features
+
+- **47 tools** across 10 resource types — posts, members, users, tags, tiers, offers, newsletters, invites, roles, and webhooks
+- **7 MCP resources** — fetch any Ghost entity by URI (e.g. `post://abc123`)
+- **2 built-in prompts** — `summarize-post` and `content-audit`
+- **Typed error handling** — Ghost API errors are caught and surfaced as clean messages, not raw stack traces
+- **Full tool descriptions** — every tool includes a plain-English description and per-parameter hints so the LLM understands exactly what to pass
+- **Zero `any` types** — proper TypeScript interfaces throughout
+
+---
+
+## Quick start
+
+### 1. Prerequisites
+
+- Node.js >= 18
+- A Ghost site with Admin API access (Ghost Pro or self-hosted)
+
+### 2. Get your Ghost credentials
+
+1. In your Ghost Admin dashboard, go to **Settings → Integrations**
+2. Click **Add custom integration**, give it a name (e.g. "MCP")
+3. Copy the **Admin API Key** — it looks like `id:secret`
+
+### 3. Pick your AI client
+
+No cloning or building required. Every integration below uses `npx ghost-mcp` to run the server on demand.
+
+---
+
+## Client integrations
+
+### Claude Desktop
+
+The recommended integration. MCP is a native feature of Claude Desktop.
+
+**Config file location:**
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "ghost": {
+      "command": "npx",
+      "args": ["-y", "ghost-mcp"],
+      "env": {
+        "GHOST_API_URL": "https://yourblog.com",
+        "GHOST_ADMIN_API_KEY": "your_id:your_secret",
+        "GHOST_API_VERSION": "v5.0"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. A hammer icon will appear in the chat input indicating all 47 tools are available.
+
+---
+
+### Claude Code (CLI)
+
+Run this once in your terminal — Claude Code will persist the server across sessions:
+
+```bash
+claude mcp add ghost \
+  --command npx \
+  --args "-y,ghost-mcp" \
+  -e GHOST_API_URL=https://yourblog.com \
+  -e GHOST_ADMIN_API_KEY=your_id:your_secret
+```
+
+Or add it manually to `.claude/mcp.json` in your project using the same JSON shape as Claude Desktop above.
+
+---
+
+### Gemini CLI
+
+Google's [Gemini CLI](https://github.com/google-gemini/gemini-cli) supports MCP servers natively.
+
+**Config file:** `~/.gemini/settings.json`
+
+```json
+{
+  "mcpServers": {
+    "ghost": {
+      "command": "npx",
+      "args": ["-y", "ghost-mcp"],
+      "env": {
+        "GHOST_API_URL": "https://yourblog.com",
+        "GHOST_ADMIN_API_KEY": "your_id:your_secret",
+        "GHOST_API_VERSION": "v5.0"
+      }
+    }
+  }
+}
+```
+
+Start a session with `gemini` and the Ghost tools will be available automatically.
+
+---
+
+### ChatGPT
+
+ChatGPT does not support MCP. OpenAI uses a separate plugin/GPT Actions system based on OpenAPI specs. There is no direct integration path — you would need to wrap this server in an HTTP REST layer to use it with ChatGPT.
+
+---
+
+### Other MCP-compatible clients
+
+Any client that speaks the MCP stdio transport can run this server. The command is always:
+
+```bash
+npx -y ghost-mcp
+```
+
+with `GHOST_API_URL` and `GHOST_ADMIN_API_KEY` set in the environment.
+
+---
+
+## Tools reference
+
+### Posts (5 tools)
+
+| Tool | Description |
+|---|---|
+| `posts_browse` | List posts with filters, pagination, and sorting |
+| `posts_read` | Fetch a single post by ID or slug |
+| `posts_add` | Create a new post (draft or published) |
+| `posts_edit` | Update an existing post |
+| `posts_delete` | Permanently delete a post |
+
+### Members (5 tools)
+
+| Tool | Description |
+|---|---|
+| `members_browse` | List members with filters |
+| `members_read` | Fetch a single member by ID or email |
+| `members_add` | Add a new member |
+| `members_edit` | Update a member's details or subscriptions |
+| `members_delete` | Remove a member |
+
+### Users (4 tools)
+
+| Tool | Description |
+|---|---|
+| `users_browse` | List staff users |
+| `users_read` | Fetch a single user by ID, email, or slug |
+| `users_edit` | Update a user's profile |
+| `users_delete` | Delete a staff user |
+
+### Tags (5 tools)
+
+| Tool | Description |
+|---|---|
+| `tags_browse` | List all tags |
+| `tags_read` | Fetch a single tag by ID or slug |
+| `tags_add` | Create a new tag |
+| `tags_edit` | Update a tag |
+| `tags_delete` | Delete a tag |
+
+### Tiers (5 tools)
+
+| Tool | Description |
+|---|---|
+| `tiers_browse` | List membership tiers |
+| `tiers_read` | Fetch a single tier |
+| `tiers_add` | Create a paid tier |
+| `tiers_edit` | Update a tier |
+| `tiers_delete` | Delete a tier |
+
+### Offers (5 tools)
+
+| Tool | Description |
+|---|---|
+| `offers_browse` | List promotional offers |
+| `offers_read` | Fetch an offer by ID or code |
+| `offers_add` | Create a discount or trial offer |
+| `offers_edit` | Update an offer's display text |
+| `offers_delete` | Delete an offer |
+
+### Newsletters (5 tools)
+
+| Tool | Description |
+|---|---|
+| `newsletters_browse` | List newsletters |
+| `newsletters_read` | Fetch a single newsletter |
+| `newsletters_add` | Create a new newsletter |
+| `newsletters_edit` | Update newsletter settings |
+| `newsletters_delete` | Delete a newsletter |
+
+### Invites (3 tools)
+
+| Tool | Description |
+|---|---|
+| `invites_browse` | List pending staff invitations |
+| `invites_add` | Send a staff invitation |
+| `invites_delete` | Cancel an invitation |
+
+### Roles (2 tools)
+
+| Tool | Description |
+|---|---|
+| `roles_browse` | List available roles |
+| `roles_read` | Fetch a single role by ID or name |
+
+### Webhooks (5 tools)
+
+| Tool | Description |
+|---|---|
+| `webhooks_browse` | List configured webhooks |
+| `webhooks_read` | Fetch a single webhook |
+| `webhooks_add` | Create a new webhook |
+| `webhooks_edit` | Update a webhook |
+| `webhooks_delete` | Delete a webhook |
+
+---
+
+## MCP Resources
+
+Access Ghost entities directly by URI:
+
+| URI pattern | Returns |
+|---|---|
+| `post://{post_id}` | Full post object including tags and authors |
+| `user://{user_id}` | Staff user with roles |
+| `member://{member_id}` | Member with labels and subscriptions |
+| `tier://{tier_id}` | Tier with pricing details |
+| `offer://{offer_id}` | Promotional offer details |
+| `newsletter://{newsletter_id}` | Newsletter configuration |
+| `blog://info` | Site settings and metadata |
+
+---
+
+## Built-in prompts
+
+### `summarize-post`
+
+Fetches a Ghost post and asks the LLM to write a concise 2-3 sentence summary.
+
+**Parameter:** `postId` — the Ghost post ID
+
+### `content-audit`
+
+Fetches recent posts and asks the LLM to audit them for title quality, tagging consistency, publishing cadence, author diversity, and content strategy.
+
+**Parameters:**
+- `limit` — number of posts to include (default: 10)
+- `status` — post status to filter by: `published` | `draft` | `scheduled` (default: `published`)
+
+---
+
+## Environment variables
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `GHOST_API_URL` | Yes | — | Your Ghost site URL, e.g. `https://yourblog.com` |
+| `GHOST_ADMIN_API_KEY` | Yes | — | Admin API key in `id:secret` format |
+| `GHOST_API_VERSION` | No | `v5.0` | Ghost API version |
+
+See [docs/en/configuration.md](docs/en/configuration.md) for full details.
+
+---
+
+## Documentation
+
+| Document | Contents |
+|---|---|
+| [docs/en/configuration.md](docs/en/configuration.md) | Environment variables, Claude Desktop setup, troubleshooting |
+| [docs/en/tools.md](docs/en/tools.md) | Complete tool reference with all parameters |
+| [docs/en/resources.md](docs/en/resources.md) | MCP resource URI reference |
+| [docs/en/development.md](docs/en/development.md) | Build, test, and extend the server |
+
+---
+
+## License
+
+MIT

package/build/client.d.ts

@@ -0,0 +1,8 @@
+import GhostAdminAPI from "@tryghost/admin-api";
+export declare const ghost: GhostAdminAPI;
+/**
+ * Wraps a Ghost Admin API call, converting any error into a GhostMcpError.
+ * Usage: const result = await callGhost(() => ghost.posts.browse());
+ */
+export declare function callGhost<T>(fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=client.d.ts.map

package/build/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,qBAAqB,CAAC;AAIhD,eAAO,MAAM,KAAK,eAIhB,CAAC;AAEH;;;GAGG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAMnE"}

package/build/client.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ghost = void 0;
+exports.callGhost = callGhost;
+const admin_api_1 = __importDefault(require("@tryghost/admin-api"));
+const config_js_1 = require("./config.js");
+const errors_js_1 = require("./errors.js");
+exports.ghost = new admin_api_1.default({
+    url: config_js_1.config.apiUrl,
+    key: config_js_1.config.adminApiKey,
+    version: config_js_1.config.apiVersion,
+});
+/**
+ * Wraps a Ghost Admin API call, converting any error into a GhostMcpError.
+ * Usage: const result = await callGhost(() => ghost.posts.browse());
+ */
+async function callGhost(fn) {
+    try {
+        return await fn();
+    }
+    catch (err) {
+        (0, errors_js_1.toMcpError)(err);
+    }
+}
+//# sourceMappingURL=client.js.map

package/build/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;;;;AAcA,8BAMC;AApBD,oEAAgD;AAChD,2CAAqC;AACrC,2CAAyC;AAE5B,QAAA,KAAK,GAAG,IAAI,mBAAa,CAAC;IACrC,GAAG,EAAE,kBAAM,CAAC,MAAM;IAClB,GAAG,EAAE,kBAAM,CAAC,WAAW;IACvB,OAAO,EAAE,kBAAM,CAAC,UAAU;CAC3B,CAAC,CAAC;AAEH;;;GAGG;AACI,KAAK,UAAU,SAAS,CAAI,EAAoB;IACrD,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAA,sBAAU,EAAC,GAAG,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/build/config.d.ts

@@ -0,0 +1,6 @@
+export declare const config: {
+    readonly apiUrl: string;
+    readonly adminApiKey: string;
+    readonly apiVersion: string;
+};
+//# sourceMappingURL=config.d.ts.map

package/build/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,MAAM;;;;CAIT,CAAC"}

package/build/config.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.config = void 0;
+function requireEnv(name) {
+    const value = process.env[name];
+    if (!value) {
+        throw new Error(`Missing required environment variable: ${name}\n` +
+            `Set it before starting the server. See docs/configuration.md for details.`);
+    }
+    return value;
+}
+exports.config = {
+    apiUrl: requireEnv("GHOST_API_URL"),
+    adminApiKey: requireEnv("GHOST_ADMIN_API_KEY"),
+    apiVersion: process.env["GHOST_API_VERSION"] ?? "v5.0",
+};
+//# sourceMappingURL=config.js.map

package/build/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;AAAA,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,0CAA0C,IAAI,IAAI;YAClD,2EAA2E,CAC5E,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAEY,QAAA,MAAM,GAAG;IACpB,MAAM,EAAE,UAAU,CAAC,eAAe,CAAC;IACnC,WAAW,EAAE,UAAU,CAAC,qBAAqB,CAAC;IAC9C,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,MAAM;CAC9C,CAAC"}

package/build/errors.d.ts

@@ -0,0 +1,14 @@
+export declare class GhostMcpError extends Error {
+    readonly code: string;
+    readonly cause?: unknown | undefined;
+    constructor(code: string, message: string, cause?: unknown | undefined);
+}
+/** Converts any caught value into a thrown GhostMcpError. Never returns. */
+export declare function toMcpError(err: unknown): never;
+export declare function formatErrorContent(err: unknown): {
+    content: [{
+        type: "text";
+        text: string;
+    }];
+};
+//# sourceMappingURL=errors.d.ts.map

package/build/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;aAEpB,IAAI,EAAE,MAAM;aAEZ,KAAK,CAAC,EAAE,OAAO;gBAFf,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAY9C;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAG9F"}

package/build/errors.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GhostMcpError = void 0;
+exports.toMcpError = toMcpError;
+exports.formatErrorContent = formatErrorContent;
+class GhostMcpError extends Error {
+    code;
+    cause;
+    constructor(code, message, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = "GhostMcpError";
+    }
+}
+exports.GhostMcpError = GhostMcpError;
+/** Converts any caught value into a thrown GhostMcpError. Never returns. */
+function toMcpError(err) {
+    if (err instanceof GhostMcpError)
+        throw err;
+    if (err instanceof Error) {
+        // Ghost Admin API surfaces errors with a `context` field
+        const ghostErr = err;
+        const detail = ghostErr.context ?? ghostErr.message;
+        const code = ghostErr.statusCode != null ? `GHOST_${ghostErr.statusCode}` : "GHOST_ERROR";
+        throw new GhostMcpError(code, detail, err);
+    }
+    throw new GhostMcpError("UNKNOWN_ERROR", String(err), err);
+}
+function formatErrorContent(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return { content: [{ type: "text", text: `Error: ${message}` }] };
+}
+//# sourceMappingURL=errors.js.map

package/build/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAYA,gCAYC;AAED,gDAGC;AA7BD,MAAa,aAAc,SAAQ,KAAK;IAEpB;IAEA;IAHlB,YACkB,IAAY,EAC5B,OAAe,EACC,KAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAQ;QAEZ,UAAK,GAAL,KAAK,CAAU;QAG/B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AATD,sCASC;AAED,4EAA4E;AAC5E,SAAgB,UAAU,CAAC,GAAY;IACrC,IAAI,GAAG,YAAY,aAAa;QAAE,MAAM,GAAG,CAAC;IAE5C,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,yDAAyD;QACzD,MAAM,QAAQ,GAAG,GAAwD,CAAC;QAC1E,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC;QACpD,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;QAC1F,MAAM,IAAI,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,IAAI,aAAa,CAAC,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;AAC7D,CAAC;AAED,SAAgB,kBAAkB,CAAC,GAAY;IAC7C,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC;AAC7E,CAAC"}

package/build/prompts/content-audit.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerContentAuditPrompt(server: McpServer): void;
+//# sourceMappingURL=content-audit.d.ts.map

package/build/prompts/content-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-audit.d.ts","sourceRoot":"","sources":["../../src/prompts/content-audit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+ElE"}

package/build/prompts/content-audit.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerContentAuditPrompt = registerContentAuditPrompt;
+const zod_1 = require("zod");
+const client_js_1 = require("../client.js");
+function registerContentAuditPrompt(server) {
+    server.prompt("content-audit", "Fetch recent Ghost posts and ask the LLM to audit them for quality, consistency, and publishing cadence.", {
+        limit: zod_1.z
+            .string()
+            .optional()
+            .describe("Number of recent posts to audit (default: 10)"),
+        status: zod_1.z
+            .string()
+            .optional()
+            .describe("Filter by post status: published | draft | scheduled (default: published)"),
+    }, async ({ limit, status }) => {
+        const resolvedLimit = limit ? parseInt(limit, 10) : 10;
+        const resolvedStatus = status ?? "published";
+        const posts = await (0, client_js_1.callGhost)(() => client_js_1.ghost.posts.browse({
+            limit: resolvedLimit,
+            filter: `status:${resolvedStatus}`,
+            order: "published_at desc",
+            include: "tags,authors",
+            formats: "plaintext",
+        }));
+        const postList = posts.map((p, i) => {
+            const title = p["title"] ?? "Untitled";
+            const slug = p["slug"] ?? "";
+            const publishedAt = p["published_at"] ?? "unpublished";
+            const excerpt = p["excerpt"] ?? "";
+            const tags = (p["tags"] ?? [])
+                .map((t) => t.name)
+                .filter(Boolean)
+                .join(", ");
+            const authors = (p["authors"] ?? [])
+                .map((a) => a.name)
+                .filter(Boolean)
+                .join(", ");
+            return [
+                `## ${i + 1}. ${title}`,
+                `   Slug: /${slug}`,
+                `   Published: ${publishedAt}`,
+                authors ? `   Author(s): ${authors}` : null,
+                tags ? `   Tags: ${tags}` : null,
+                excerpt ? `   Excerpt: ${excerpt.slice(0, 150)}${excerpt.length > 150 ? "…" : ""}` : null,
+            ]
+                .filter(Boolean)
+                .join("\n");
+        });
+        const postSummary = postList.join("\n\n");
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `You are a content strategist reviewing a Ghost blog. Please audit the following ${resolvedLimit} most recent ${resolvedStatus} posts and provide:
+
+1. **Title quality** — Are titles clear, compelling, and SEO-friendly?
+2. **Tagging consistency** — Are tags being used consistently? Any missing or redundant tags?
+3. **Publishing cadence** — How frequently are posts published? Any noticeable gaps?
+4. **Author diversity** — Are posts distributed across authors, or dominated by one?
+5. **Recommendations** — 3–5 actionable improvements for the content strategy.
+
+Here are the posts:
+
+${postSummary}`,
+                    },
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=content-audit.js.map

package/build/prompts/content-audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-audit.js","sourceRoot":"","sources":["../../src/prompts/content-audit.ts"],"names":[],"mappings":"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"}

package/build/prompts/index.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerPrompts(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/build/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAGvD"}

package/build/prompts/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPrompts = registerPrompts;
+const summarize_post_js_1 = require("./summarize-post.js");
+const content_audit_js_1 = require("./content-audit.js");
+function registerPrompts(server) {
+    (0, summarize_post_js_1.registerSummarizePostPrompt)(server);
+    (0, content_audit_js_1.registerContentAuditPrompt)(server);
+}
+//# sourceMappingURL=index.js.map

package/build/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":";;AAIA,0CAGC;AAND,2DAAkE;AAClE,yDAAgE;AAEhE,SAAgB,eAAe,CAAC,MAAiB;IAC/C,IAAA,+CAA2B,EAAC,MAAM,CAAC,CAAC;IACpC,IAAA,6CAA0B,EAAC,MAAM,CAAC,CAAC;AACrC,CAAC"}

package/build/prompts/summarize-post.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSummarizePostPrompt(server: McpServer): void;
+//# sourceMappingURL=summarize-post.d.ts.map

package/build/prompts/summarize-post.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize-post.d.ts","sourceRoot":"","sources":["../../src/prompts/summarize-post.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoCnE"}

package/build/prompts/summarize-post.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSummarizePostPrompt = registerSummarizePostPrompt;
+const zod_1 = require("zod");
+const client_js_1 = require("../client.js");
+function registerSummarizePostPrompt(server) {
+    server.prompt("summarize-post", "Fetch a Ghost post and ask the LLM to write a concise summary of it.", { postId: zod_1.z.string().describe("Ghost post ID to summarize") }, async ({ postId }) => {
+        const post = await (0, client_js_1.callGhost)(() => client_js_1.ghost.posts.read({ id: postId }));
+        const title = post["title"] ?? "";
+        const excerpt = post["excerpt"] ?? "";
+        const html = post["html"] ?? "";
+        const preview = html.replace(/<[^>]+>/g, "").slice(0, 500);
+        const context = [
+            `Title: ${title}`,
+            excerpt ? `Excerpt: ${excerpt}` : null,
+            `Content preview:\n${preview}${html.length > 500 ? "…" : ""}`,
+        ]
+            .filter(Boolean)
+            .join("\n\n");
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Please write a concise 2–3 sentence summary of this Ghost blog post:\n\n${context}`,
+                    },
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=summarize-post.js.map

package/build/prompts/summarize-post.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize-post.js","sourceRoot":"","sources":["../../src/prompts/summarize-post.ts"],"names":[],"mappings":";;AAIA,kEAoCC;AAxCD,6BAAwB;AAExB,4CAAgD;AAEhD,SAAgB,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,MAAM,CACX,gBAAgB,EAChB,sEAAsE,EACtE,EAAE,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC,EAAE,EAC7D,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,MAAM,IAAI,GAAG,MAAM,IAAA,qBAAS,EAAC,GAAG,EAAE,CAChC,iBAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAA4C,CAAC,CAC3E,CAAC;QAEF,MAAM,KAAK,GAAI,IAAgC,CAAC,OAAO,CAAW,IAAI,EAAE,CAAC;QACzE,MAAM,OAAO,GAAI,IAAgC,CAAC,SAAS,CAAW,IAAI,EAAE,CAAC;QAC7E,MAAM,IAAI,GAAI,IAAgC,CAAC,MAAM,CAAW,IAAI,EAAE,CAAC;QAEvE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG;YACd,UAAU,KAAK,EAAE;YACjB,OAAO,CAAC,CAAC,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI;YACtC,qBAAqB,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;SAC9D;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhB,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,2EAA2E,OAAO,EAAE;qBAC3F;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/resources/blog.d.ts

@@ -0,0 +1,3 @@
+import type { ReadResourceCallback } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const handleBlogInfoResource: ReadResourceCallback;
+//# sourceMappingURL=blog.d.ts.map

package/build/resources/blog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog.d.ts","sourceRoot":"","sources":["../../src/resources/blog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAGpF,eAAO,MAAM,sBAAsB,EAAE,oBAYpC,CAAC"}

package/build/resources/blog.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleBlogInfoResource = void 0;
+const client_js_1 = require("../client.js");
+const handleBlogInfoResource = async (uri) => {
+    const site = await (0, client_js_1.callGhost)(() => client_js_1.ghost.site.read());
+    return {
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: "application/json",
+                text: JSON.stringify(site, null, 2),
+            },
+        ],
+    };
+};
+exports.handleBlogInfoResource = handleBlogInfoResource;
+//# sourceMappingURL=blog.js.map

package/build/resources/blog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog.js","sourceRoot":"","sources":["../../src/resources/blog.ts"],"names":[],"mappings":";;;AACA,4CAAgD;AAEzC,MAAM,sBAAsB,GAAyB,KAAK,EAAE,GAAG,EAAE,EAAE;IACxE,MAAM,IAAI,GAAG,MAAM,IAAA,qBAAS,EAAC,GAAG,EAAE,CAAC,iBAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAEtD,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;aACpC;SACF;KACF,CAAC;AACJ,CAAC,CAAC;AAZW,QAAA,sBAAsB,0BAYjC"}

package/build/resources/index.d.ts

@@ -0,0 +1,8 @@
+export { handlePostResource } from "./posts.js";
+export { handleUserResource } from "./users.js";
+export { handleMemberResource } from "./members.js";
+export { handleTierResource } from "./tiers.js";
+export { handleOfferResource } from "./offers.js";
+export { handleNewsletterResource } from "./newsletters.js";
+export { handleBlogInfoResource } from "./blog.js";
+//# sourceMappingURL=index.d.ts.map

package/build/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC"}

package/build/resources/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleBlogInfoResource = exports.handleNewsletterResource = exports.handleOfferResource = exports.handleTierResource = exports.handleMemberResource = exports.handleUserResource = exports.handlePostResource = void 0;
+var posts_js_1 = require("./posts.js");
+Object.defineProperty(exports, "handlePostResource", { enumerable: true, get: function () { return posts_js_1.handlePostResource; } });
+var users_js_1 = require("./users.js");
+Object.defineProperty(exports, "handleUserResource", { enumerable: true, get: function () { return users_js_1.handleUserResource; } });
+var members_js_1 = require("./members.js");
+Object.defineProperty(exports, "handleMemberResource", { enumerable: true, get: function () { return members_js_1.handleMemberResource; } });
+var tiers_js_1 = require("./tiers.js");
+Object.defineProperty(exports, "handleTierResource", { enumerable: true, get: function () { return tiers_js_1.handleTierResource; } });
+var offers_js_1 = require("./offers.js");
+Object.defineProperty(exports, "handleOfferResource", { enumerable: true, get: function () { return offers_js_1.handleOfferResource; } });
+var newsletters_js_1 = require("./newsletters.js");
+Object.defineProperty(exports, "handleNewsletterResource", { enumerable: true, get: function () { return newsletters_js_1.handleNewsletterResource; } });
+var blog_js_1 = require("./blog.js");
+Object.defineProperty(exports, "handleBlogInfoResource", { enumerable: true, get: function () { return blog_js_1.handleBlogInfoResource; } });
+//# sourceMappingURL=index.js.map

package/build/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":";;;AAAA,uCAAgD;AAAvC,8GAAA,kBAAkB,OAAA;AAC3B,uCAAgD;AAAvC,8GAAA,kBAAkB,OAAA;AAC3B,2CAAoD;AAA3C,kHAAA,oBAAoB,OAAA;AAC7B,uCAAgD;AAAvC,8GAAA,kBAAkB,OAAA;AAC3B,yCAAkD;AAAzC,gHAAA,mBAAmB,OAAA;AAC5B,mDAA4D;AAAnD,0HAAA,wBAAwB,OAAA;AACjC,qCAAmD;AAA1C,iHAAA,sBAAsB,OAAA"}