@neopress/mcp 1.5.0 → 1.6.0

package/README.md

@@ -22,8 +22,13 @@ Stdio MCP can use `neopress_asset_upload_file` because it runs on the same
 machine as the agent and can read local file paths.
 
 The tool surface includes site/layout/page/collection/entry/form/asset/publish
-operations plus read-only analytics tools for traffic, forms, AI crawler reach,
-and Search Console.
+operations plus analytics queries and saved event/funnel configuration. Use
+`neopress_analytics_event_update` with `eventId` and `name` to rename an existing
+event without changing its historical tracking behavior; display changes use a
+separate call. Create a new event when tracking conditions need to change. Use
+`neopress_analytics_targets_list` before creating an event to discover valid
+page and form targets. Event and funnel creation accepts the same camelCase
+definition inputs as the dashboard; reads preserve stored snake_case fields.
 
 ## Remote HTTP
 
@@ -178,3 +183,11 @@ pnpm dlx @anthropic-ai/mcpb pack packages/mcp/dist/mcpb/neopress
 
 Do not submit the remote connector drafts until the production MCP origin,
 support URL, review workspace, and real client OAuth scans are verified.
+
+## Localization
+
+Page tools expose draft/production public languages; `draftPublicLocales: null` means only the site's default language and `[]` means no public languages. Publish the site to apply the draft list. Translation dictionaries and global page visibility are separate state.
+
+`neopress_entry_create_translation` takes `entryId` and `locale`, returning an existing linked locale row or a source-content copy as a draft. It does not perform machine translation or publish content. Update and publish the returned entry separately. Collections share schemas with localized option labels; forms share schemas with flat `draftI18n.translations[textKey][locale]` dictionaries.
+
+Partial update tools preserve omitted fields, including page/form i18n and metadata. Use explicit null only to clear nullable fields.

package/dist/bin.cjs

@@ -19671,6 +19671,10 @@ var EntriesEndpoint = class {
 			collectionId
 		})).data;
 	}
+	/** Copy source content into a linked locale draft, or return its existing translation. */
+	async createTranslation(entryId, locale) {
+		return (await this.client.post(`${this.basePath}/${entryId}/translations`, { locale })).data;
+	}
 	async update(entryId, data) {
 		const payload = {};
 		for (const key of UPDATE_PASSTHROUGH_FIELDS) if (key in data) payload[key] = data[key];
@@ -19948,8 +19952,12 @@ function appendCommonAnalyticsParams(qs, params) {
 }
 var AnalyticsEndpoint = class {
 	client;
+	events;
+	funnels;
 	constructor(client) {
 		this.client = client;
+		this.events = new AnalyticsEventsEndpoint(client);
+		this.funnels = new AnalyticsFunnelsEndpoint(client);
 	}
 	get basePath() {
 		return `${this.client.siteBasePath}/analytics`;
@@ -20006,6 +20014,58 @@ var AnalyticsEndpoint = class {
 		if (params.rowLimit) qs.set("row_limit", String(params.rowLimit));
 		return (await this.client.get(`${this.basePath}/search-console?${qs.toString()}`)).data;
 	}
+	/** Page/form targets that can be referenced by an event definition. */
+	async targets() {
+		return (await this.client.get(`${this.basePath}/targets`)).data;
+	}
+};
+var AnalyticsEventsEndpoint = class {
+	client;
+	constructor(client) {
+		this.client = client;
+	}
+	get basePath() {
+		return `${this.client.siteBasePath}/analytics/events`;
+	}
+	async list() {
+		return (await this.client.get(this.basePath)).data;
+	}
+	async get(eventId) {
+		return (await this.client.get(`${this.basePath}/${eventId}`)).data.event;
+	}
+	async create(data) {
+		return (await this.client.post(this.basePath, data)).data.event;
+	}
+	async update(eventId, data) {
+		return (await this.client.patch(`${this.basePath}/${eventId}`, data)).data.event;
+	}
+	async delete(eventId) {
+		await this.client.delete(`${this.basePath}/${eventId}`);
+	}
+};
+var AnalyticsFunnelsEndpoint = class {
+	client;
+	constructor(client) {
+		this.client = client;
+	}
+	get basePath() {
+		return `${this.client.siteBasePath}/analytics/funnels`;
+	}
+	async list() {
+		return (await this.client.get(this.basePath)).data;
+	}
+	async get(funnelId) {
+		return (await this.client.get(`${this.basePath}/${funnelId}`)).data.funnel;
+	}
+	async create(data) {
+		return (await this.client.post(this.basePath, data)).data.funnel;
+	}
+	async update(funnelId, data) {
+		return (await this.client.patch(`${this.basePath}/${funnelId}`, data)).data.funnel;
+	}
+	async delete(funnelId) {
+		await this.client.delete(`${this.basePath}/${funnelId}`);
+	}
 };
 //#endregion
 //#region ../sdk/src/endpoints/templates.ts
@@ -20731,6 +20791,11 @@ const READ_ONLY_TOOLS = /* @__PURE__ */ new Set([
 	"neopress_analytics_traffic_sources",
 	"neopress_analytics_forms",
 	"neopress_analytics_crawler_summary",
+	"neopress_analytics_events_list",
+	"neopress_analytics_event_get",
+	"neopress_analytics_funnels_list",
+	"neopress_analytics_funnel_get",
+	"neopress_analytics_targets_list",
 	"neopress_search_console_query",
 	"neopress_assets_list",
 	"neopress_asset_get",
@@ -20754,7 +20819,13 @@ const DESTRUCTIVE_TOOLS = /* @__PURE__ */ new Set([
 	"neopress_form_delete",
 	"neopress_asset_delete",
 	"neopress_template_mark",
-	"neopress_publish_site"
+	"neopress_publish_site",
+	"neopress_analytics_event_create",
+	"neopress_analytics_event_update",
+	"neopress_analytics_event_delete",
+	"neopress_analytics_funnel_create",
+	"neopress_analytics_funnel_update",
+	"neopress_analytics_funnel_delete"
 ]);
 const PUBLICATION_TOOLS = /* @__PURE__ */ new Set([
 	"neopress_entry_publish",
@@ -20795,6 +20866,12 @@ function asOptionalNumber(input, key) {
 function asOptionalString(input, key) {
 	return input[key];
 }
+function asOptionalBoolean(input, key) {
+	return input[key];
+}
+function omitUndefined(value) {
+	return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== void 0));
+}
 function siteId(input) {
 	return asOptionalNumber(input, "siteId");
 }
@@ -21021,10 +21098,11 @@ const toolDefinitions = [
 			title: string().optional(),
 			type: _enum(["static", "dynamic"]).optional(),
 			status: _enum(["draft", "published"]).optional(),
+			visibility: _enum(["public", "hidden"]).optional(),
 			collectionId: number().int().positive().optional(),
 			draftTsx: string().optional(),
 			draftI18n: optionalJsonSchema,
-			draftPublicLocales: array(string()).nullable().optional(),
+			draftPublicLocales: array(string()).nullable().optional().describe("Draft public languages. null means default language only; [] means none. Publish to apply."),
 			draftMeta: optionalJsonSchema,
 			queryConfig: optionalJsonSchema,
 			metadata: optionalJsonSchema
@@ -21035,6 +21113,7 @@ const toolDefinitions = [
 				title: asOptionalString(input, "title"),
 				type: input.type,
 				status: input.status,
+				visibility: input.visibility,
 				collectionId: asOptionalNumber(input, "collectionId"),
 				draftTsx: asOptionalString(input, "draftTsx"),
 				draftI18n: input.draftI18n,
@@ -21055,27 +21134,29 @@ const toolDefinitions = [
 			title: string().optional(),
 			type: _enum(["static", "dynamic"]).optional(),
 			status: string().optional(),
+			visibility: _enum(["public", "hidden"]).optional(),
 			collectionId: number().int().positive().optional(),
 			draftTsx: string().optional(),
 			draftI18n: optionalJsonSchema,
-			draftPublicLocales: array(string()).nullable().optional(),
+			draftPublicLocales: array(string()).nullable().optional().describe("Draft public languages. null means default language only; [] means none. Publish to apply."),
 			draftMeta: optionalJsonSchema,
 			queryConfig: optionalJsonSchema,
 			metadata: optionalJsonSchema
 		},
 		handler: async (input, context, extra) => {
-			return (await context.createClient({ siteId: siteId(input) }, extra)).pages.update(asNumber(input, "pageId"), {
+			return (await context.createClient({ siteId: siteId(input) }, extra)).pages.update(asNumber(input, "pageId"), omitUndefined({
 				path: asOptionalString(input, "path"),
 				title: asOptionalString(input, "title"),
 				type: asOptionalString(input, "type"),
 				status: asOptionalString(input, "status"),
+				visibility: input.visibility,
 				collectionId: asOptionalNumber(input, "collectionId"),
 				draftTsx: asOptionalString(input, "draftTsx"),
 				draftI18n: input.draftI18n,
 				draftPublicLocales: input.draftPublicLocales,
 				draftMeta: mergeDraftMeta(input.draftMeta, input.queryConfig),
 				metadata: input.metadata
-			});
+			}));
 		}
 	},
 	{
@@ -21231,6 +21312,19 @@ const toolDefinitions = [
 			return entry;
 		}
 	},
+	{
+		name: "neopress_entry_create_translation",
+		title: "Create Entry Translation Draft",
+		description: "Create or return a linked locale row in the source entry's translation group. New drafts copy source content; translate the returned entry with entry_update, then publish it. Existing translations are preserved.",
+		inputSchema: {
+			...siteIdShape,
+			entryId: number().int().positive(),
+			locale: string().min(1)
+		},
+		handler: async (input, context, extra) => {
+			return (await context.createClient({ siteId: siteId(input) }, extra)).entries.createTranslation(asNumber(input, "entryId"), asString(input, "locale"));
+		}
+	},
 	{
 		name: "neopress_entry_update",
 		title: "Update Entry",
@@ -21247,14 +21341,14 @@ const toolDefinitions = [
 		},
 		handler: async (input, context, extra) => {
 			const client = await context.createClient({ siteId: siteId(input) }, extra);
-			const entry = await client.entries.update(asNumber(input, "entryId"), {
+			const entry = await client.entries.update(asNumber(input, "entryId"), omitUndefined({
 				slug: asOptionalString(input, "slug"),
 				title: asOptionalString(input, "title"),
 				locale: asOptionalString(input, "locale"),
 				data: input.data,
 				metadata: input.metadata,
 				status: asOptionalString(input, "status")
-			});
+			}));
 			await client.entries.revalidateReaderCache(asNumber(input, "entryId"));
 			return entry;
 		}
@@ -21419,14 +21513,14 @@ const toolDefinitions = [
 			settings: optionalJsonSchema
 		},
 		handler: async (input, context, extra) => {
-			return (await context.createClient({ siteId: siteId(input) }, extra)).forms.update(asNumber(input, "formId"), {
+			return (await context.createClient({ siteId: siteId(input) }, extra)).forms.update(asNumber(input, "formId"), omitUndefined({
 				name: asOptionalString(input, "name"),
-				draftSchema: input.draftSchema ?? input.schema,
+				draftSchema: input.draftSchema !== void 0 ? input.draftSchema : input.schema,
 				draftLayout: input.draftLayout,
 				draftStyle: input.draftStyle,
 				draftI18n: input.draftI18n,
 				settings: input.settings
-			});
+			}));
 		}
 	},
 	{
@@ -21470,6 +21564,235 @@ const toolDefinitions = [
 			});
 		}
 	},
+	{
+		name: "neopress_analytics_events_list",
+		title: "List Analytics Events",
+		description: "List saved analytics event definitions for the active site.",
+		inputSchema: siteIdShape,
+		handler: async (input, context, extra) => {
+			return (await context.createClient({ siteId: siteId(input) }, extra)).analytics.events.list();
+		}
+	},
+	{
+		name: "neopress_analytics_event_get",
+		title: "Get Analytics Event",
+		description: "Get a saved analytics event definition by UUID.",
+		inputSchema: {
+			...siteIdShape,
+			eventId: string().uuid()
+		},
+		handler: async (input, context, extra) => {
+			return (await context.createClient({ siteId: siteId(input) }, extra)).analytics.events.get(asString(input, "eventId"));
+		}
+	},
+	{
+		name: "neopress_analytics_event_create",
+		title: "Create Analytics Event",
+		description: "Create a saved analytics event definition. Discover pages/forms with neopress_analytics_targets_list. Click/visibility require an existing stable [data-np-track=\"...\"] selector; page views reuse PAGE_VIEW. Optional id is a client UUID: reuse the same id and payload after an uncertain response.",
+		inputSchema: {
+			...siteIdShape,
+			id: string().uuid().optional(),
+			name: string(),
+			eventType: _enum([
+				"custom",
+				"page",
+				"click",
+				"form",
+				"scroll",
+				"visibility",
+				"dwell"
+			]),
+			eventName: string().optional(),
+			path: string().optional(),
+			selector: string().optional(),
+			formId: string().optional(),
+			scrollDepth: number().int().optional(),
+			dwellSeconds: number().int().optional()
+		},
+		handler: async (input, context, extra) => {
+			return (await context.createClient({ siteId: siteId(input) }, extra)).analytics.events.create({
+				id: asOptionalString(input, "id"),
+				name: asString(input, "name"),
+				eventType: input.eventType,
+				eventName: asOptionalString(input, "eventName"),
+				path: asOptionalString(input, "path"),
+				selector: asOptionalString(input, "selector"),
+				formId: asOptionalString(input, "formId"),
+				scrollDepth: asOptionalNumber(input, "scrollDepth"),
+				dwellSeconds: asOptionalNumber(input, "dwellSeconds")
+			});
+		}
+	},
+	{
+		name: "neopress_analytics_event_update",
+		title: "Update Analytics Event",
+		description: "Rename an analytics event with {name} while preserving tracking behavior, or update its display settings separately. Tracking identity cannot be changed after creation.",
+		inputSchema: {
+			...siteIdShape,
+			eventId: string().uuid(),
+			name: string().optional(),
+			eventType: _enum([
+				"custom",
+				"page",
+				"click",
+				"form",
+				"scroll",
+				"visibility",
+				"dwell"
+			]).optional(),
+			eventName: string().optional(),
+			path: string().optional(),
+			selector: string().optional(),
+			formId: string().optional(),
+			scrollDepth: number().int().optional(),
+			dwellSeconds: number().int().optional(),
+			chartVisible: boolean().optional(),
+			pinned: boolean().optional(),
+			chartColor: string().optional()
+		},
+		handler: async (input, context, extra) => {
+			const client = await context.createClient({ siteId: siteId(input) }, extra);
+			if ([
+				"chartVisible",
+				"pinned",
+				"chartColor"
+			].some((key) => key in input)) {
+				if ([
+					"name",
+					"eventType",
+					"eventName",
+					"path",
+					"selector",
+					"formId",
+					"scrollDepth",
+					"dwellSeconds"
+				].some((key) => input[key] !== void 0)) throw new Error("Update the definition and display settings in separate calls.");
+				return client.analytics.events.update(asString(input, "eventId"), { display: {
+					chartVisible: asOptionalBoolean(input, "chartVisible"),
+					pinned: asOptionalBoolean(input, "pinned"),
+					chartColor: asOptionalString(input, "chartColor")
+				} });
+			}
+			const definition = {
+				name: asString(input, "name"),
+				...input.eventType !== void 0 ? { eventType: input.eventType } : {},
+				eventName: asOptionalString(input, "eventName"),
+				path: asOptionalString(input, "path"),
+				selector: asOptionalString(input, "selector"),
+				formId: asOptionalString(input, "formId"),
+				scrollDepth: asOptionalNumber(input, "scrollDepth"),
+				dwellSeconds: asOptionalNumber(input, "dwellSeconds")
+			};
+			return client.analytics.events.update(asString(input, "eventId"), definition);
+		}
+	},
+	{
+		name: "neopress_analytics_event_delete",
+		title: "Delete Analytics Event",
+		description: "Permanently delete a saved analytics event. Events referenced by a funnel cannot be deleted.",
+		inputSchema: {
+			...siteIdShape,
+			eventId: string().uuid()
+		},
+		handler: async (input, context, extra) => {
+			await (await context.createClient({ siteId: siteId(input) }, extra)).analytics.events.delete(asString(input, "eventId"));
+			return { ok: true };
+		}
+	},
+	{
+		name: "neopress_analytics_funnels_list",
+		title: "List Analytics Funnels",
+		description: "List saved analytics funnel definitions for the active site.",
+		inputSchema: siteIdShape,
+		handler: async (input, context, extra) => {
+			return (await context.createClient({ siteId: siteId(input) }, extra)).analytics.funnels.list();
+		}
+	},
+	{
+		name: "neopress_analytics_funnel_get",
+		title: "Get Analytics Funnel",
+		description: "Get a saved analytics funnel definition by UUID.",
+		inputSchema: {
+			...siteIdShape,
+			funnelId: string().uuid()
+		},
+		handler: async (input, context, extra) => {
+			return (await context.createClient({ siteId: siteId(input) }, extra)).analytics.funnels.get(asString(input, "funnelId"));
+		}
+	},
+	{
+		name: "neopress_analytics_funnel_create",
+		title: "Create Analytics Funnel",
+		description: "Create a funnel with 2 to 5 ordered saved event UUIDs. Optional id is a client UUID; reuse it and the same payload after an uncertain response. Step filter is {version:1,root:{kind:'group',op:'and'|'or',children:[groups or {kind:'condition',field,operator,value?,key?}]}}. Fields: event.path/url/referrer/referrer_source/property; session.referrer/referrer_source/traffic_category/utm_source/utm_medium/utm_campaign/utm_content/utm_term. event.property requires key. Operators: eq,neq,contains,not_contains,starts_with,ends_with,exists,not_exists; property also supports gt,gte,lt,lte. Server validates bounds and grouping.",
+		inputSchema: {
+			...siteIdShape,
+			id: string().uuid().optional(),
+			name: string(),
+			steps: array(object$1({
+				eventId: string().uuid(),
+				path: string().optional(),
+				filter: unknown().optional()
+			})),
+			windowMode: _enum(["session", "time"]),
+			windowHours: number().int().nonnegative().optional()
+		},
+		handler: async (input, context, extra) => {
+			return (await context.createClient({ siteId: siteId(input) }, extra)).analytics.funnels.create({
+				id: asOptionalString(input, "id"),
+				name: asString(input, "name"),
+				steps: input.steps,
+				windowMode: input.windowMode,
+				windowHours: asOptionalNumber(input, "windowHours")
+			});
+		}
+	},
+	{
+		name: "neopress_analytics_funnel_update",
+		title: "Update Analytics Funnel",
+		description: "Replace a saved funnel definition with its ordered event steps and window semantics.",
+		inputSchema: {
+			...siteIdShape,
+			funnelId: string().uuid(),
+			name: string(),
+			steps: array(object$1({
+				eventId: string().uuid(),
+				path: string().optional(),
+				filter: unknown().optional()
+			})),
+			windowMode: _enum(["session", "time"]),
+			windowHours: number().int().nonnegative().optional()
+		},
+		handler: async (input, context, extra) => {
+			return (await context.createClient({ siteId: siteId(input) }, extra)).analytics.funnels.update(asString(input, "funnelId"), {
+				name: asString(input, "name"),
+				steps: input.steps,
+				windowMode: input.windowMode,
+				windowHours: asOptionalNumber(input, "windowHours")
+			});
+		}
+	},
+	{
+		name: "neopress_analytics_funnel_delete",
+		title: "Delete Analytics Funnel",
+		description: "Permanently delete a saved analytics funnel.",
+		inputSchema: {
+			...siteIdShape,
+			funnelId: string().uuid()
+		},
+		handler: async (input, context, extra) => {
+			await (await context.createClient({ siteId: siteId(input) }, extra)).analytics.funnels.delete(asString(input, "funnelId"));
+			return { ok: true };
+		}
+	},
+	{
+		name: "neopress_analytics_targets_list",
+		title: "List Analytics Event Targets",
+		description: "List site pages and forms available as analytics event targets.",
+		inputSchema: siteIdShape,
+		handler: async (input, context, extra) => {
+			return (await context.createClient({ siteId: siteId(input) }, extra)).analytics.targets();
+		}
+	},
 	{
 		name: "neopress_analytics_query",
 		title: "Query Analytics Pipe",