@frase/mcp-server 0.3.5 → 0.3.7

package/CHANGELOG.md

@@ -5,6 +5,34 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.7] - 2026-06-04
+
+### Fixed
+- `analyze_serp`: People Also Ask entries rendered as `[object Object]` and several fields showed `undefined`. PAA questions and result fields now render correctly.
+
+### Changed
+- Bumped `@frase/core` dependency to `0.1.5`, which adds the `ToolResult.hidden`/`reason` hide-mirror fields and `McpToolDefinition.inputSchema.additionalProperties` that the AI-visibility tools rely on. (The tools had used these since late May, but core was never republished — the build only typechecks at publish time, so it surfaced now.)
+- Updated runtime dependencies (`hono`, `@modelcontextprotocol/sdk`) and upgraded the test toolchain (`vitest` 2.x → 4.x) to clear a critical security advisory.
+- `server.json` `version` (and its nested npm package `version`) corrected from `0.3.5` to track the package version — it had drifted behind `package.json`/`manifest.json` since 0.3.6.
+
+## [0.3.6] - 2026-05-18
+
+### Added
+- `create_brief`, `update_brief`, `list_templates`, `create_template`: `content_type` now accepts the canonical 16-type taxonomy in addition to the legacy 5-bucket values. New types: `blog_post`, `page`, `faq`, `glossary`, `pillar`, `how_to`, `listicle`, `case_study`, `tutorial`, `news`, `product_update`, `data_report`, `event`, `resource` (alongside the existing `comparison` and `landing`). Prefer the specific types — they produce correctly-shaped outlines and type-appropriate word counts via the platform's spec system.
+
+### Changed
+- **`create_brief.target_word_count`** is now optional with no client-side default. When omitted, the server uses the content type's recommended length (e.g. ~1000 for `faq`, ~1500 for `glossary`, ~3500 for `pillar`) instead of a fixed 2000. If your integration assumed 2000, either pass an explicit value or be ready to receive different per-type defaults in the response.
+- **`create_brief.target_word_count`** lower bound widened from 500 to 80 to support short-form types (`resource`, `product_update`, `event`).
+- **`create_brief.content_type`** default changed from `"blog"` to `"blog_post"` (canonical 16-type equivalent).
+- **Response shape**: brief responses now echo the **normalized 16-type** `content_type`, not the input string. A client sending `content_type: "blog"` will receive `content_type: "blog_post"` in the response; `"guide"` → `"how_to"`, `"product"` → `"product_update"`. Update any client code that keys off the returned `content_type` field.
+- Validation error messages for `content_type` now list 16-type values.
+
+### Deprecated
+- Legacy 5-bucket `content_type` values (`blog`, `guide`, `landing`, `product`, `comparison`) are still accepted but normalized to 16-type equivalents at the API boundary. New integrations should use the 16-type values directly.
+
+### Fixed
+- `SERVER_VERSION` constant and `manifest.json` `version` now correctly report the package version (previously stuck at `0.2.2` despite `package.json` being at `0.3.5`). Clients reading the MCP `initialize` response will now see the actual server version.
+
 ## [0.2.0] - 2026-03-08
 
 ### Added

package/dist/content-types-config-mirror.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Cross-package mirror of the per-content-type JSON Schemas emitted by
+ * `src/lib/content/content-type-configs/*` in the main Next.js app.
+ *
+ * Cross-package import is blocked: the MCP server publishes as its own
+ * npm package and cannot reach into the main app's Next.js source. This
+ * constant MUST stay in sync with `src/lib/content/content-type-configs/tool-review.ts`.
+ *
+ * A parity contract test asserts deep-equality against the live
+ * `contentTypeConfigRegistry.tool_review.jsonSchema` produced by zod 4's
+ * `z.toJSONSchema()`:
+ *   src/lib/content/content-type-configs/__tests__/mcp-parity.test.ts
+ *
+ * If you change the Zod schema in the main app, regenerate this constant
+ * by running (from repo root):
+ *   npx tsx -e "import('./src/lib/content/content-type-configs/tool-review').then(m => console.log(JSON.stringify((m.default ?? m).toolReviewConfigModule.jsonSchema, null, 2)))"
+ * and paste the output below verbatim. The contract test will fail until
+ * the mirror is updated.
+ */
+export declare const TOOL_REVIEW_JSON_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly type: "object";
+    readonly properties: {
+        readonly rating: {
+            readonly type: "number";
+            readonly minimum: 0;
+            readonly maximum: 5;
+        };
+        readonly prosList: {
+            readonly default: readonly [];
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
+        };
+        readonly consList: {
+            readonly default: readonly [];
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
+        };
+        readonly pricingNote: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly verdictSummary: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly toolCategory: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly toolOS: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly aggregateRatingValue: {
+            readonly type: "number";
+            readonly minimum: 0;
+            readonly maximum: 5;
+        };
+        readonly aggregateRatingCount: {
+            readonly type: "integer";
+            readonly minimum: 0;
+            readonly maximum: 9007199254740991;
+        };
+    };
+    readonly required: readonly ["rating", "prosList", "consList"];
+    readonly additionalProperties: false;
+};
+//# sourceMappingURL=content-types-config-mirror.d.ts.map

package/dist/content-types-config-mirror.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-types-config-mirror.d.ts","sourceRoot":"","sources":["../src/content-types-config-mirror.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsD1B,CAAC"}

package/dist/content-types-config-mirror.js

@@ -0,0 +1,75 @@
+/**
+ * Cross-package mirror of the per-content-type JSON Schemas emitted by
+ * `src/lib/content/content-type-configs/*` in the main Next.js app.
+ *
+ * Cross-package import is blocked: the MCP server publishes as its own
+ * npm package and cannot reach into the main app's Next.js source. This
+ * constant MUST stay in sync with `src/lib/content/content-type-configs/tool-review.ts`.
+ *
+ * A parity contract test asserts deep-equality against the live
+ * `contentTypeConfigRegistry.tool_review.jsonSchema` produced by zod 4's
+ * `z.toJSONSchema()`:
+ *   src/lib/content/content-type-configs/__tests__/mcp-parity.test.ts
+ *
+ * If you change the Zod schema in the main app, regenerate this constant
+ * by running (from repo root):
+ *   npx tsx -e "import('./src/lib/content/content-type-configs/tool-review').then(m => console.log(JSON.stringify((m.default ?? m).toolReviewConfigModule.jsonSchema, null, 2)))"
+ * and paste the output below verbatim. The contract test will fail until
+ * the mirror is updated.
+ */
+export const TOOL_REVIEW_JSON_SCHEMA = {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    type: "object",
+    properties: {
+        rating: {
+            type: "number",
+            minimum: 0,
+            maximum: 5,
+        },
+        prosList: {
+            default: [],
+            type: "array",
+            items: {
+                type: "string",
+                minLength: 1,
+            },
+        },
+        consList: {
+            default: [],
+            type: "array",
+            items: {
+                type: "string",
+                minLength: 1,
+            },
+        },
+        pricingNote: {
+            type: "string",
+            minLength: 1,
+        },
+        verdictSummary: {
+            type: "string",
+            minLength: 1,
+        },
+        toolCategory: {
+            type: "string",
+            minLength: 1,
+        },
+        toolOS: {
+            type: "string",
+            minLength: 1,
+        },
+        aggregateRatingValue: {
+            type: "number",
+            minimum: 0,
+            maximum: 5,
+        },
+        aggregateRatingCount: {
+            type: "integer",
+            minimum: 0,
+            maximum: 9007199254740991,
+        },
+    },
+    required: ["rating", "prosList", "consList"],
+    additionalProperties: false,
+};
+//# sourceMappingURL=content-types-config-mirror.js.map

package/dist/content-types-config-mirror.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-types-config-mirror.js","sourceRoot":"","sources":["../src/content-types-config-mirror.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,OAAO,EAAE,8CAA8C;IACvD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;SACX;QACD,QAAQ,EAAE;YACR,OAAO,EAAE,EAAE;YACX,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,CAAC;aACb;SACF;QACD,QAAQ,EAAE;YACR,OAAO,EAAE,EAAE;YACX,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,CAAC;aACb;SACF;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,CAAC;SACb;QACD,cAAc,EAAE;YACd,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,CAAC;SACb;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,CAAC;SACb;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,CAAC;SACb;QACD,oBAAoB,EAAE;YACpB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;SACX;QACD,oBAAoB,EAAE;YACpB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,gBAAgB;SAC1B;KACF;IACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC;IAC5C,oBAAoB,EAAE,KAAK;CACnB,CAAC"}

package/dist/content-types.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The 18-type content taxonomy used by the Frase platform.
+ *
+ * This is the canonical list of values the `/api/v1/briefs` endpoint
+ * accepts in `content_type`. The API also accepts legacy 5-bucket
+ * values (`blog`, `guide`, `landing`, `product`, `comparison`) for
+ * back-compat and normalizes them at the boundary, but new MCP
+ * integrations should use these 18 values directly.
+ *
+ * Keep this list in lockstep with `src/lib/core/content-types.ts`
+ * in the main app. We can't import from there because the MCP server
+ * publishes as its own npm package and can't reach into Next.js source.
+ */
+export declare const CONTENT_TYPES: readonly ["blog_post", "page", "faq", "glossary", "comparison", "pillar", "how_to", "landing", "listicle", "case_study", "tutorial", "news", "product_update", "data_report", "event", "resource", "alternative", "tool_review"];
+export type ContentType = (typeof CONTENT_TYPES)[number];
+//# sourceMappingURL=content-types.d.ts.map

package/dist/content-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-types.d.ts","sourceRoot":"","sources":["../src/content-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,kOAmBhB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/content-types.js

@@ -0,0 +1,34 @@
+/**
+ * The 18-type content taxonomy used by the Frase platform.
+ *
+ * This is the canonical list of values the `/api/v1/briefs` endpoint
+ * accepts in `content_type`. The API also accepts legacy 5-bucket
+ * values (`blog`, `guide`, `landing`, `product`, `comparison`) for
+ * back-compat and normalizes them at the boundary, but new MCP
+ * integrations should use these 18 values directly.
+ *
+ * Keep this list in lockstep with `src/lib/core/content-types.ts`
+ * in the main app. We can't import from there because the MCP server
+ * publishes as its own npm package and can't reach into Next.js source.
+ */
+export const CONTENT_TYPES = [
+    "blog_post",
+    "page",
+    "faq",
+    "glossary",
+    "comparison",
+    "pillar",
+    "how_to",
+    "landing",
+    "listicle",
+    "case_study",
+    "tutorial",
+    "news",
+    "product_update",
+    "data_report",
+    "event",
+    "resource",
+    "alternative",
+    "tool_review",
+];
+//# sourceMappingURL=content-types.js.map

package/dist/content-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-types.js","sourceRoot":"","sources":["../src/content-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,WAAW;IACX,MAAM;IACN,KAAK;IACL,UAAU;IACV,YAAY;IACZ,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,UAAU;IACV,YAAY;IACZ,UAAU;IACV,MAAM;IACN,gBAAgB;IAChB,aAAa;IACb,OAAO;IACP,UAAU;IACV,aAAa;IACb,aAAa;CACL,CAAC"}

package/dist/index.js

@@ -65,7 +65,7 @@ import { ALL_RESOURCE_TEMPLATES, listAllResources, readResource, getRootResource
 import { ALL_PROMPTS, getPromptByName, getPromptMessages, } from "./prompts/index.js";
 // Server metadata
 const SERVER_NAME = "frase-mcp-server";
-const SERVER_VERSION = "0.2.2";
+const SERVER_VERSION = "0.3.7";
 /**
  * Main MCP server class
  */

package/dist/prompts/content-pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content-pipeline.d.ts","sourceRoot":"","sources":["../../src/prompts/content-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,qBAAqB,EAAE,mBAoCnC,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IAC9E,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC,CAAC,CAoDD"}
+{"version":3,"file":"content-pipeline.d.ts","sourceRoot":"","sources":["../../src/prompts/content-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,qBAAqB,EAAE,mBAwCnC,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IAC9E,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC,CAAC,CAoDD"}

package/dist/prompts/content-pipeline.js

@@ -34,7 +34,10 @@ export const contentPipelinePrompt = {
         },
         {
             name: "content_type",
-            description: "Type of content: blog, guide, comparison, landing, product (default: blog)",
+            description: "Canonical content type (one of 18) — e.g. blog_post, how_to, listicle, " +
+                "case_study, tutorial, comparison, alternative, tool_review, pillar, landing, " +
+                "faq, glossary, news, product_update, data_report, event, resource, page. " +
+                "Default: blog_post. See create_brief for the enum.",
             required: false,
         },
         {
@@ -53,7 +56,7 @@ export function getContentPipelineMessages(args) {
     const topic = args.topic || "the requested topic";
     const siteId = args.site_id || "";
     const targetScore = args.target_score || "70";
-    const contentType = args.content_type || "blog";
+    const contentType = args.content_type || "blog_post";
     const targetLanguage = args.target_language || "en";
     const targetCountry = args.target_country || "us";
     return [

package/dist/prompts/content-pipeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"content-pipeline.js","sourceRoot":"","sources":["../../src/prompts/content-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,CAAC,MAAM,qBAAqB,GAAwB;IACxD,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,mNAAmN;IACrN,SAAS,EAAE;QACT;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,yDAAyD;YACtE,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,6DAA6D;YAC1E,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,0EAA0E;YACvF,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,4EAA4E;YACzF,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,iBAAiB;YACvB,WAAW,EAAE,iFAAiF;YAC9F,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,6EAA6E;YAC1F,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,0BAA0B,CAAC,IAA4B;IAIrE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,qBAAqB,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IAClC,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC;IAChD,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC;IACpD,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC;IAElD,OAAO;QACL;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,sCAAsC,KAAK;;;aAG5C,MAAM;kBACD,WAAW;+BACE,WAAW;cAC5B,cAAc;aACf,aAAa;;;;wDAI8B,KAAK,kBAAkB,MAAM;;;;mBAIlE,WAAW;;;;;;0BAMJ,WAAW;;;;;+DAK0B,MAAM,iKAAiK,MAAM;;4FAEhJ,KAAK,wDAAwD,KAAK;;;;;;;gCAO9H;aACzB;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"content-pipeline.js","sourceRoot":"","sources":["../../src/prompts/content-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,CAAC,MAAM,qBAAqB,GAAwB;IACxD,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,mNAAmN;IACrN,SAAS,EAAE;QACT;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,yDAAyD;YACtE,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,6DAA6D;YAC1E,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,0EAA0E;YACvF,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EACT,yEAAyE;gBACzE,+EAA+E;gBAC/E,2EAA2E;gBAC3E,oDAAoD;YACtD,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,iBAAiB;YACvB,WAAW,EAAE,iFAAiF;YAC9F,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,6EAA6E;YAC1F,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,0BAA0B,CAAC,IAA4B;IAIrE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,qBAAqB,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IAClC,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,IAAI,WAAW,CAAC;IACrD,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC;IACpD,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC;IAElD,OAAO;QACL;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,sCAAsC,KAAK;;;aAG5C,MAAM;kBACD,WAAW;+BACE,WAAW;cAC5B,cAAc;aACf,aAAa;;;;wDAI8B,KAAK,kBAAkB,MAAM;;;;mBAIlE,WAAW;;;;;;0BAMJ,WAAW;;;;;+DAK0B,MAAM,iKAAiK,MAAM;;4FAEhJ,KAAK,wDAAwD,KAAK;;;;;;;gCAO9H;aACzB;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/prompts/create-seo-article.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-seo-article.d.ts","sourceRoot":"","sources":["../../src/prompts/create-seo-article.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,sBAAsB,EAAE,mBA2BpC,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IAC/E,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC,CAAC,CA4DD"}
+{"version":3,"file":"create-seo-article.d.ts","sourceRoot":"","sources":["../../src/prompts/create-seo-article.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,sBAAsB,EAAE,mBA8BpC,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IAC/E,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC,CAAC,CA4DD"}

package/dist/prompts/create-seo-article.js

@@ -26,7 +26,10 @@ export const createSeoArticlePrompt = {
         },
         {
             name: "content_type",
-            description: "Type of content: blog, guide, comparison, landing, product (default: blog)",
+            description: "Canonical content type (one of 18) — e.g. blog_post, how_to, listicle, " +
+                "case_study, tutorial, comparison, alternative, tool_review, pillar, landing, " +
+                "faq, glossary, news, product_update, data_report, event, resource, page. " +
+                "Default: blog_post. See create_brief for the enum.",
             required: false,
         },
         {
@@ -38,7 +41,7 @@ export const createSeoArticlePrompt = {
 };
 export function getCreateSeoArticleMessages(args) {
     const topic = args.topic || "the requested topic";
-    const contentType = args.content_type || "blog";
+    const contentType = args.content_type || "blog_post";
     const siteId = args.site_id || "";
     const targetScore = args.target_score || "70";
     return [

package/dist/prompts/create-seo-article.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-seo-article.js","sourceRoot":"","sources":["../../src/prompts/create-seo-article.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,CAAC,MAAM,sBAAsB,GAAwB;IACzD,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,yPAAyP;IAC3P,SAAS,EAAE;QACT;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,+CAA+C;YAC5D,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,iGAAiG;YAC9G,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EACT,4EAA4E;YAC9E,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,4DAA4D;YACzE,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,2BAA2B,CAAC,IAA4B;IAItE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,qBAAqB,CAAC;IAClD,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IAClC,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC;IAE9C,OAAO;QACL;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,uDAAuD,KAAK;;;kBAGxD,WAAW;aAChB,MAAM;+BACY,WAAW;;;;6DAImB,KAAK,kBAAkB,MAAM;;;;sBAIpE,WAAW;;;;;;;;;;;;;;;;;;;6BAmBJ,WAAW;;;;;8CAKM,MAAM;0GACsD,MAAM;;;;4EAIpC,KAAK;;;uEAGV;aAChE;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"create-seo-article.js","sourceRoot":"","sources":["../../src/prompts/create-seo-article.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,CAAC,MAAM,sBAAsB,GAAwB;IACzD,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,yPAAyP;IAC3P,SAAS,EAAE;QACT;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,+CAA+C;YAC5D,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,iGAAiG;YAC9G,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EACT,yEAAyE;gBACzE,+EAA+E;gBAC/E,2EAA2E;gBAC3E,oDAAoD;YACtD,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,4DAA4D;YACzE,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,2BAA2B,CAAC,IAA4B;IAItE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,qBAAqB,CAAC;IAClD,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,IAAI,WAAW,CAAC;IACrD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IAClC,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC;IAE9C,OAAO;QACL;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,uDAAuD,KAAK;;;kBAGxD,WAAW;aAChB,MAAM;+BACY,WAAW;;;;6DAImB,KAAK,kBAAkB,MAAM;;;;sBAIpE,WAAW;;;;;;;;;;;;;;;;;;;6BAmBJ,WAAW;;;;;8CAKM,MAAM;0GACsD,MAAM;;;;4EAIpC,KAAK;;;uEAGV;aAChE;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/ai-visibility.d.ts

@@ -3,9 +3,12 @@
  *
  * Track how your content appears in AI-powered search results
  */
+import { z } from "zod";
 import type { McpToolDefinition, ToolContext, ToolResult } from "../types.js";
 export declare const getAiVisibilityTool: McpToolDefinition;
 export declare function executeGetAiVisibility(input: unknown, context: ToolContext): Promise<ToolResult>;
+export declare const getIndustryBenchmarkTool: McpToolDefinition;
+export declare function executeGetIndustryBenchmark(input: unknown, context: ToolContext): Promise<ToolResult>;
 export declare const listPromptsTool: McpToolDefinition;
 export declare function executeListPrompts(input: unknown, context: ToolContext): Promise<ToolResult>;
 export declare const createPromptTool: McpToolDefinition;
@@ -22,6 +25,17 @@ export declare const getInsightsTool: McpToolDefinition;
 export declare function executeGetInsights(input: unknown, context: ToolContext): Promise<ToolResult>;
 export declare const getCrawlerLogsTool: McpToolDefinition;
 export declare function executeGetCrawlerLogs(input: unknown, context: ToolContext): Promise<ToolResult>;
+export declare const CITATION_FORMULA_FEATURE_LABELS: Record<string, string>;
+export declare function citationFormulaLabelFor(featureName: string): string;
+export declare const getCitationFormulaInputSchema: z.ZodObject<{
+    flavor: z.ZodDefault<z.ZodEnum<["active", "full"]>>;
+}, "strict", z.ZodTypeAny, {
+    flavor: "full" | "active";
+}, {
+    flavor?: "full" | "active" | undefined;
+}>;
+export declare const getCitationFormulaTool: McpToolDefinition;
+export declare function executeGetCitationFormula(input: unknown, context: ToolContext): Promise<ToolResult>;
 export declare const aiVisibilityTools: McpToolDefinition[];
 export declare const aiVisibilityExecutors: Record<string, (input: unknown, context: ToolContext) => Promise<ToolResult>>;
 //# sourceMappingURL=ai-visibility.d.ts.map

package/dist/tools/ai-visibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-visibility.d.ts","sourceRoot":"","sources":["../../src/tools/ai-visibility.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,UAAU,EAGX,MAAM,aAAa,CAAC;AAwIrB,eAAO,MAAM,mBAAmB,EAAE,iBAiBjC,CAAC;AAEF,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA8GrB;AAYD,eAAO,MAAM,eAAe,EAAE,iBAoB7B,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA8CrB;AAiBD,eAAO,MAAM,gBAAgB,EAAE,iBA8C9B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA8CrB;AAUD,eAAO,MAAM,aAAa,EAAE,iBAa3B,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAiErB;AAcD,eAAO,MAAM,gBAAgB,EAAE,iBAiC9B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAoCrB;AAaD,eAAO,MAAM,kBAAkB,EAAE,iBAwBhC,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAwDrB;AAWD,eAAO,MAAM,aAAa,EAAE,iBAgB3B,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAsDrB;AAYD,eAAO,MAAM,eAAe,EAAE,iBAoB7B,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAoErB;AAoBD,eAAO,MAAM,kBAAkB,EAAE,iBAqBhC,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAqDrB;AAMD,eAAO,MAAM,iBAAiB,EAAE,iBAAiB,EAUhD,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CACxC,MAAM,EACN,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAW9D,CAAC"}
+{"version":3,"file":"ai-visibility.d.ts","sourceRoot":"","sources":["../../src/tools/ai-visibility.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,UAAU,EAGX,MAAM,aAAa,CAAC;AAwIrB,eAAO,MAAM,mBAAmB,EAAE,iBAiBjC,CAAC;AAEF,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAmHrB;AA2HD,eAAO,MAAM,wBAAwB,EAAE,iBAmBtC,CAAC;AAEF,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAoHrB;AAYD,eAAO,MAAM,eAAe,EAAE,iBAoB7B,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA8CrB;AAiBD,eAAO,MAAM,gBAAgB,EAAE,iBA8C9B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA8CrB;AAUD,eAAO,MAAM,aAAa,EAAE,iBAa3B,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAiErB;AAcD,eAAO,MAAM,gBAAgB,EAAE,iBAiC9B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAoCrB;AAaD,eAAO,MAAM,kBAAkB,EAAE,iBAwBhC,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAwDrB;AAWD,eAAO,MAAM,aAAa,EAAE,iBAgB3B,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAsDrB;AAYD,eAAO,MAAM,eAAe,EAAE,iBAoB7B,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAoErB;AAoBD,eAAO,MAAM,kBAAkB,EAAE,iBAqBhC,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAqDrB;AA8BD,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAUlE,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAQnE;AAED,eAAO,MAAM,6BAA6B;;;;;;EAI/B,CAAC;AAEZ,eAAO,MAAM,sBAAsB,EAAE,iBAiBpC,CAAC;AAEF,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA2FrB;AAMD,eAAO,MAAM,iBAAiB,EAAE,iBAAiB,EAYhD,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CACxC,MAAM,EACN,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAa9D,CAAC"}