@neopress/mcp 1.5.0 → 1.6.1

package/dist/index.js

@@ -173,6 +173,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];
@@ -450,8 +454,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`;
@@ -508,6 +516,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
@@ -863,9 +923,8 @@ Use these rules before generating pages, collection schemas, entries, forms, or
 
 ## Operating boundary
 
-- Authentication is OAuth bearer token based. Use \`NEOPRESS_ACCESS_TOKEN\` or the OAuth session created by \`neopress login\`.
-- API keys and API-key based public integrations are not part of this surface.
-- MCP is available as local stdio and remote Streamable HTTP over the first-party SDK/API.
+- Connect the remote MCP server and sign in with your Neopress account through OAuth.
+- MCP is available on Launch and above. Your site role controls which actions you can perform.
 - MCP is a Neopress contract adapter, not a reference crawler or managed page generator.
 - The host coding agent should perform \`r.jina.ai\` markdown fetches, browser screenshots, DOM/CSS/SVG/background-image extraction, reference analysis, and TSX authoring with its own tools and tokens.
 - Use MCP to read/write Neopress resources, upload or register assets, compile, publish, and verify. Do not expect MCP to spend Neopress server-side LLM tokens for reference analysis or page generation.
@@ -879,9 +938,9 @@ Use these rules before generating pages, collection schemas, entries, forms, or
 
 ## Cache
 
-- Site publish invalidates site/layout/collection reader cache tags in the API environment that handled the request.
+- Site publish invalidates site/layout/collection reader cache tags in the environment connected to MCP.
 - Entry publish/unpublish invalidates entry reader cache when production visibility changes.
-- A localhost publish does not invalidate production reader cache. For production validation, publish through the production API and verify the live URL.
+- A localhost publish does not invalidate production reader cache. For production validation, publish through the production MCP server and verify the live URL.
 
 ## Analytics and autopilot
 
@@ -894,7 +953,7 @@ Use these rules before generating pages, collection schemas, entries, forms, or
 
 - Layout owns header, footer, global CSS, and 404. Page TSX starts at page content.
 - Generated page TSX is sandboxed. Do not import Supabase, create API clients, read env vars, use filesystem/process APIs, or assume arbitrary npm packages.
-- Use allowed runtime packages only: React/Next basics, react-dom (createPortal), shadcn UI imports, lucide-react, @base-ui/react/drawer, @base-ui/react/dialog, @base-ui/react/accordion, @base-ui/react/switch, @base-ui/react/tabs, @base-ui/react/select, @neopress/youtube, @neopress/map, clsx, class-variance-authority, tailwind-merge, motion/react (never \`framer-motion\` — old package name, not on the allowlist), motion-plus/react (Motion+ premium components: Ticker, Carousel, Cursor, AnimateNumber, AnimateText, Typewriter, ScrambleText, Curtains), @paper-design/shaders-react, gsap (including \`gsap/ScrollTrigger\`, driven via \`@gsap/react\`'s \`useGSAP\`), react-hook-form, zod, @hookform/resolvers, @hookform/resolvers/zod, @neopress/content, @neopress/routing, @neopress/i18n, and @neopress/forms.
+- Use allowed runtime packages only: React/Next basics, react-dom (createPortal), shadcn UI imports, lucide-react, @base-ui/react/drawer, @base-ui/react/dialog, @base-ui/react/accordion, @base-ui/react/switch, @base-ui/react/tabs, @base-ui/react/select, @neopress/youtube, @neopress/map, clsx, class-variance-authority, tailwind-merge, motion/react (never \`framer-motion\` — old package name, not on the allowlist), motion-plus/react (Motion+ premium components: Ticker, Carousel, Cursor, AnimateNumber, AnimateText, Typewriter, ScrambleText, Curtains), @paper-design/shaders-react, gsap (including \`gsap/ScrollTrigger\`, driven via \`@gsap/react\`'s \`useGSAP\`), react-hook-form, zod, @hookform/resolvers, @hookform/resolvers/zod, @neopress/content, @neopress/routing, @neopress/i18n, @neopress/responsive (MobileOnly with deferred desktop/mobile callbacks), and @neopress/forms.
 - For dates, render an existing \`displayDate\` field directly when available. For raw timestamps, use \`Intl.DateTimeFormat\` or \`Date#toLocaleDateString\` with an explicit locale and \`timeZone\` so server rendering and hydration agree; use the site's required zone, or \`UTC\` when none is specified.
 - @base-ui/react/select is an accessible listbox/dropdown (replaces a native \`<select>\`, whose popup is unstyled OS chrome). Compose its parts directly in page TSX; a \`<Select.Item value>\` is a string or the documented \`null\` sentinel (unlike Radix, an empty string is not banned); the \`Select.Popup\` portals to \`document.body\`, so give it an explicit z-index and an opaque background; match the trigger width with \`min-w-[var(--anchor-width)]\` (from \`Select.Positioner\`), cap the list with \`max-h-[var(--available-height)]\`, and set \`alignItemWithTrigger={false}\` for standard below-trigger placement. @base-ui/react/drawer is the gesture mobile sheet; @base-ui/react/dialog the non-gesture modal — both portal to \`document.body\`, need an opaque Popup background + z-index, and take \`modal\` for focus-trap.
 - react-dom is for \`createPortal\` — portal full-viewport overlays (mobile drawer, modal) to \`document.body\` so a \`backdrop-filter\`/\`transform\` ancestor can't trap their \`position: fixed\` inside its box. ALWAYS render the portal behind an open-state guard (\`{open && createPortal(…, document.body)}\`): an unguarded \`document\` reference throws during SSR.
@@ -916,7 +975,9 @@ Use these rules before generating pages, collection schemas, entries, forms, or
 - \`queryConfig\` is stored in page \`draftMeta.queryConfig\`.
 - Query labels become React props. Entry query results are flattened, so use \`post.body\` instead of \`post.data.body\`.
 - A query may include \`collectionWindow\` on an \`entries\` query for a dynamic detail route. Its label receives \`{ before, after, items }\`; each is a flattened-entry array around the current entry, and \`items\` combines both directions. Windows use \`published_at DESC, id DESC\`, allow 0–20 entries per direction, and may only declare that exact order. Use the exact configured label, never a guessed prop name. Optional \`matchFields\` compare raw anchor-snapshot fields only when the source field has a value.
-- Initial CMS data arrives through those injected query props. \`entryClient\`, when injected in reader/preview for a site handle, is only a client-side auxiliary for load-more/filter/get/create interactions after the initial render; do not use it for initial render or server data loading.
+- Initial CMS data arrives through those injected query props. \`entryClient\`, when injected in reader/preview for a site handle, is only a client-side auxiliary for load-more/filter/get/create interactions after the initial render; do not use it for initial render or server data loading. Its entries come back flattened like injected props, ordered \`published_at DESC, id DESC\`.
+- Server-side binding is the default because injected props are server-rendered and crawlable; \`entryClient\` is for after-hydration needs only (large-collection load-more, a read that depends on visitor input such as search text or a chosen filter, or an explicit client-side request).
+- Load-more pagination: give the list query a \`limit\` (first page injected server-side), then append \`entryClient.more(propLabel, { offset: shown.length, filters? })\` — the server re-runs that page's stored binding query from the offset, so the page restates nothing; \`filters\` is equality on scalar schema fields (\`{ category: "TECH" }\`), applied to the same published data. \`entryClient.list({ collectionId, offset, limit, filters? })\` is only for reads whose query depends on visitor input or that are too large to inject; a light, fixed set revealed on click is a bound query instead. Judge "light" by what the query injects into the page, not by how much the UI shows: a query without a \`limit\` ships every entry with every field. Without a \`limit\` a list query injects every entry, so paginate by slicing the prop instead.
 - Use numeric \`collection_id\` filters. Runtime controls site, status, locale, deleted state, and published snapshots.
 
 ## Collections and entries
@@ -930,7 +991,7 @@ Use these rules before generating pages, collection schemas, entries, forms, or
 
 - Reference fields require a schema field with \`type: "references"\` and target \`collection_id\`.
 - Links live in \`entry_references\`, not only in raw entry \`data\`.
-- \`includeReferences\` fetches arrays keyed by the includeReferences alias or field key, and parent entry \`id\` must be selected. With an alias, the alias prop remains an array of referenced entries. Without an alias, if the field key matches a raw numeric reference field in \`entry.data\`, flattening unwraps that array to one flattened object or null.
+- \`includeReferences\` fetches arrays keyed by the includeReferences alias or field key, and parent entry \`id\` must be selected. With an alias, the alias prop remains an array of referenced entries. Without an alias, if the field key matches a raw numeric reference field in \`entry.data\`, flattening unwraps that array to one object or null; references linked only through \`entry_references\` stay arrays. Every referenced entry is flattened like the parent (\`ref.<fieldId>\`; \`ref.data\` kept for backward compatibility), one level deep.
 - After changing references, publish the source entry again.
 
 ## Forms
@@ -943,7 +1004,7 @@ Use these rules before generating pages, collection schemas, entries, forms, or
 ## Unsupported visitor features
 
 Generated Neopress pages do not support visitor login/accounts, member areas, carts, checkout, payments, subscriptions, or order management.`;
-const SERVER_INSTRUCTIONS = `Use Neopress MCP tools to manage a selected Neopress site through the first-party OAuth API.
+const SERVER_INSTRUCTIONS = `Use Neopress MCP tools to manage a selected Neopress site through an authenticated MCP connection.
 
 Before generating TSX or schema-backed pages, call neopress_get_runtime_contract or read neopress://runtime-contract.
 Use numeric IDs returned by tools. Publish entries separately from site publish. Use read-only analytics tools before autopilot recommendations. Verify production URLs after production publish.
@@ -1233,6 +1294,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",
@@ -1256,7 +1322,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",
@@ -1297,6 +1369,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");
 }
@@ -1349,7 +1427,7 @@ const toolDefinitions = [
 	{
 		name: "neopress_site_select",
 		title: "Select Active Site",
-		description: "Verify access to a site and store it as the active site for future MCP/CLI operations.",
+		description: "Verify access to a site and store it as the active site for future MCP operations.",
 		inputSchema: { siteId: z.number().int().positive() },
 		handler: async (input, context, extra) => {
 			const selectedSiteId = asNumber(input, "siteId");
@@ -1523,10 +1601,11 @@ const toolDefinitions = [
 			title: z.string().optional(),
 			type: z.enum(["static", "dynamic"]).optional(),
 			status: z.enum(["draft", "published"]).optional(),
+			visibility: z.enum(["public", "hidden"]).optional(),
 			collectionId: z.number().int().positive().optional(),
 			draftTsx: z.string().optional(),
 			draftI18n: optionalJsonSchema,
-			draftPublicLocales: z.array(z.string()).nullable().optional(),
+			draftPublicLocales: z.array(z.string()).nullable().optional().describe("Draft public languages. null means default language only; [] means none. Publish to apply."),
 			draftMeta: optionalJsonSchema,
 			queryConfig: optionalJsonSchema,
 			metadata: optionalJsonSchema
@@ -1537,6 +1616,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,
@@ -1557,27 +1637,29 @@ const toolDefinitions = [
 			title: z.string().optional(),
 			type: z.enum(["static", "dynamic"]).optional(),
 			status: z.string().optional(),
+			visibility: z.enum(["public", "hidden"]).optional(),
 			collectionId: z.number().int().positive().optional(),
 			draftTsx: z.string().optional(),
 			draftI18n: optionalJsonSchema,
-			draftPublicLocales: z.array(z.string()).nullable().optional(),
+			draftPublicLocales: z.array(z.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
-			});
+			}));
 		}
 	},
 	{
@@ -1733,6 +1815,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: z.number().int().positive(),
+			locale: z.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",
@@ -1749,14 +1844,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;
 		}
@@ -1921,14 +2016,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
-			});
+			}));
 		}
 	},
 	{
@@ -1972,6 +2067,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: z.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 over raw analytics signals. Discover page and form IDs with neopress_analytics_targets_list. Click targets use an observed href:<absolute-url> or selector:<fingerprint> key; outbound counts external-link clicks site-wide. Built-in events start collecting without editing or republishing page TSX. Optional id is a client UUID: reuse the same id and payload after an uncertain response.",
+		inputSchema: {
+			...siteIdShape,
+			id: z.string().uuid().optional(),
+			name: z.string(),
+			eventType: z.enum([
+				"custom",
+				"page",
+				"click",
+				"form",
+				"scroll",
+				"dwell",
+				"outbound"
+			]),
+			eventName: z.string().optional(),
+			path: z.string().optional(),
+			selector: z.string().optional(),
+			formId: z.string().optional(),
+			scrollDepth: z.number().int().optional(),
+			dwellSeconds: z.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: z.string().uuid(),
+			name: z.string().optional(),
+			eventType: z.enum([
+				"custom",
+				"page",
+				"click",
+				"form",
+				"scroll",
+				"dwell",
+				"outbound"
+			]).optional(),
+			eventName: z.string().optional(),
+			path: z.string().optional(),
+			selector: z.string().optional(),
+			formId: z.string().optional(),
+			scrollDepth: z.number().int().optional(),
+			dwellSeconds: z.number().int().optional(),
+			chartVisible: z.boolean().optional(),
+			pinned: z.boolean().optional(),
+			chartColor: z.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: z.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: z.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: z.string().uuid().optional(),
+			name: z.string(),
+			steps: z.array(z.object({
+				eventId: z.string().uuid(),
+				path: z.string().optional(),
+				filter: z.unknown().optional()
+			})),
+			windowMode: z.enum(["session", "time"]),
+			windowHours: z.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: z.string().uuid(),
+			name: z.string(),
+			steps: z.array(z.object({
+				eventId: z.string().uuid(),
+				path: z.string().optional(),
+				filter: z.unknown().optional()
+			})),
+			windowMode: z.enum(["session", "time"]),
+			windowHours: z.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: z.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",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neopress/mcp",
-  "version": "1.5.0",
+  "version": "1.6.1",
   "description": "Neopress MCP server for first-party AI agents",
   "type": "module",
   "bin": {