@sakupa/mcp 0.7.1 → 0.7.3

package/dist/bin.js

@@ -128,7 +128,7 @@ var FORBIDDEN_PATH_SEGMENTS = [
 var ALLOWED_HIDDEN_PATHS = [".well-known/"];
 
 // ../core/dist/domain/version.js
-var SAKUPA_MCP_VERSION = "0.7.1";
+var SAKUPA_MCP_VERSION = "0.7.3";
 
 // ../core/dist/domain/errors.js
 var HTTP_STATUS = {
@@ -467,6 +467,9 @@ var WEBHOOK_PROCESSING_LEASE_MS = 5 * 60 * 1e3;
 
 // src/config.ts
 var TEST_API_BASE_URL = "https://api-test.sakupa.com";
+function previewHostPatternFor(apiBaseUrl) {
+  return apiBaseUrl === TEST_API_BASE_URL ? "{shortId}-test.sakupa.com" : "{shortId}.sakupa.com";
+}
 function loadMcpRuntimeConfig(env = process.env, cwd = process.cwd()) {
   const apiBaseUrl = (env["SAKUPA_API_URL"] ?? DEFAULT_API_BASE_URL).replace(/\/+$/, "");
   const projectDir = env["SAKUPA_PROJECT_DIR"] ?? cwd;
@@ -1394,6 +1397,7 @@ async function uploadAll(ctx, targets, files, outputAbs) {
   return targets.length;
 }
 function registerTools(server, ctx) {
+  const previewHostPattern = previewHostPatternFor(ctx.apiBaseUrl);
   server.registerTool(
     "analyze_site",
     {
@@ -1427,7 +1431,7 @@ Next action: ${analysis.suggestedNextAction}`,
   server.registerTool(
     "deploy_site",
     {
-      description: `Deploy the local static output to Sakupa. First deploy creates a free temporary site (valid ${FREE_SITE_TTL_HOURS}h, public URL like https://{shortId}.sakupa.com) and stores the management credential in .sakupa/site.json. Later runs update the existing site (free sites also refresh their validity; subscribed sites are permanent). Runs analyze_site first and refuses to upload source projects, secrets, .env files, archives, media or server code. Never uploads anything when the analysis says the project is not deployable.`,
+      description: `Deploy the local static output to Sakupa. First deploy creates a free temporary site (valid ${FREE_SITE_TTL_HOURS}h, public URL like https://${previewHostPattern}) and stores the management credential in .sakupa/site.json. Later runs update the existing site (free sites also refresh their validity; subscribed sites are permanent). Runs analyze_site first and refuses to upload source projects, secrets, .env files, archives, media or server code. Never uploads anything when the analysis says the project is not deployable.`,
       outputSchema: STRUCTURED_TOOL_OUTPUT_SCHEMA,
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
       inputSchema: {
@@ -1610,7 +1614,7 @@ Free sites stay live for ${FREE_SITE_TTL_HOURS} hours after each deploy or refre
   server.registerTool(
     "subscribe_site",
     {
-      description: `Create a Stripe Checkout link that subscribes THIS site to a Sakupa Hosting monthly plan (${planCatalog()}). Paying makes the site PERMANENT on its {shortId}.sakupa.com URL \u2014 no more 24h expiry; that is the core value of paying. Binding a custom domain afterwards (bind_domain) is an optional included extra and requires DNS control of that domain. Owner-only: requires this project's site credential (.sakupa/site.json) \u2014 deploy_site first. If the site outgrows its plan, Sakupa shows an over-limit notice and never changes billing automatically. The owner can explicitly choose another plan through Stripe Customer Portal. Card details are entered only on the Stripe-hosted page \u2014 never through the AI tool. Opening and completing Stripe Checkout is the final subscription confirmation.`,
+      description: `Create a Stripe Checkout link that subscribes THIS site to a Sakupa Hosting monthly plan (${planCatalog()}). Paying makes the site PERMANENT on its ${previewHostPattern} URL \u2014 no more 24h expiry; that is the core value of paying. Binding a custom domain afterwards (bind_domain) is an optional included extra and requires DNS control of that domain. Owner-only: requires this project's site credential (.sakupa/site.json) \u2014 deploy_site first. If the site outgrows its plan, Sakupa shows an over-limit notice and never changes billing automatically. The owner can explicitly choose another plan through Stripe Customer Portal. Card details are entered only on the Stripe-hosted page \u2014 never through the AI tool. Opening and completing Stripe Checkout is the final subscription confirmation.`,
       outputSchema: STRUCTURED_TOOL_OUTPUT_SCHEMA,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
       inputSchema: {
@@ -1655,7 +1659,7 @@ Once payment confirms, the site becomes permanent on its current URL. Binding a
   server.registerTool(
     "bind_domain",
     {
-      description: "Bind a custom domain to this subscribed site \u2014 an OPTIONAL extra serving surface; the permanent {shortId}.sakupa.com URL keeps working alongside it. The binding unit is the APEX domain: binding example.com automatically includes www.example.com (both serve the same content, one apex TXT verification covers both), and one site binds at most ONE apex domain \u2014 a second domain needs a second subscribed site. Requires an ACTIVE subscription (subscribe_site). Ownership is proven ONLY by DNS control of the apex \u2014 payment never grants ownership. A binding request never reserves the domain: whoever proves DNS control first gets it, and unverified requests expire after 72 hours. Call again with verificationId to check progress.",
+      description: `Bind a custom domain to this subscribed site \u2014 an OPTIONAL extra serving surface; the permanent ${previewHostPattern} URL keeps working alongside it. The binding unit is the APEX domain: binding example.com automatically includes www.example.com (both serve the same content, one apex TXT verification covers both), and one site binds at most ONE apex domain \u2014 a second domain needs a second subscribed site. Requires an ACTIVE subscription (subscribe_site). Ownership is proven ONLY by DNS control of the apex \u2014 payment never grants ownership. A binding request never reserves the domain: whoever proves DNS control first gets it, and unverified requests expire after 72 hours. Call again with verificationId to check progress.`,
       outputSchema: STRUCTURED_TOOL_OUTPUT_SCHEMA,
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
       inputSchema: {
@@ -2288,28 +2292,34 @@ var FetchTransport = class {
 };
 
 // src/server.ts
-var INSTRUCTIONS = `Sakupa publishes AI-made static websites. AI-made pages, live in seconds.
+var instructionsFor = (hostPattern) => `Sakupa publishes AI-made static websites. AI-made pages, live in seconds.
 
 Workflow:
 1. analyze_site \u2014 check whether this project has deployable static output. If a build is needed
    (Vite/Vue/React/Svelte/Astro/Next static export/Nuxt generate), run the build LOCALLY first,
    then re-run analyze_site.
 2. deploy_site \u2014 uploads ONLY the built static output. The first deploy creates a free temporary
-   site (public URL {shortId}.sakupa.com, valid 24 hours, free banner shown) and stores the
+   site (public URL ${hostPattern}, valid 24 hours, free banner shown) and stores the
    management credential in .sakupa/site.json. Deploying again updates the site and refreshes
-   its validity; refresh_site extends validity without uploading.
-3. To make the site PERMANENT, subscribe it to a monthly hosting plan (subscribe_site ->
-   Stripe-hosted checkout; water/personal/share/business). Paying makes the
-   {shortId}.sakupa.com URL permanent \u2014 that is what payment buys. Usage over the chosen plan
+   its validity; refresh_site extends validity without uploading; site_status shows the
+   current deployment and serving state at any time.
+3. To make the site PERMANENT, subscribe it to a monthly hosting plan (list_billing_plans
+   shows the catalog; subscribe_site -> Stripe-hosted checkout;
+   water/personal/share/business). Paying makes the
+   ${hostPattern} URL permanent \u2014 that is what payment buys. Usage over the chosen plan
    shows an over-limit notice by default. An external AI may periodically query usage and
    recommend a plan, but Sakupa never changes a subscription automatically.
 4. Optionally bind a custom domain to the subscribed site (bind_domain): an included extra
    serving surface alongside the permanent URL. Ownership is proven only by DNS control; the
    first verified request wins; unverified requests expire after 72 hours. billing_status,
-   billing_status, change_subscription_plan, manage_billing and recover_domain_site manage the paid
-   lifecycle. Plan changes are confirmed only on Stripe and synchronized by Stripe webhook.
+   change_subscription_plan, manage_billing and recover_domain_site manage the paid
+   lifecycle; unbind_domain removes the custom domain (the permanent URL keeps serving) and
+   delete_site tears the whole site down after explicit confirmation.
+   Plan changes are confirmed only on Stripe and synchronized by Stripe webhook.
    A cancellation keeps the site paid through the current period. Sakupa reverts it to a free
    24h site and removes paid data after Stripe sends the signed final-cancellation webhook.
+5. create_support_ticket (subscribed sites) opens a support ticket; report_bug sends a
+   sanitized diagnostic report after the user explicitly confirms it.
 
 Safety boundaries:
 - Static output only: no SSR, API routes, middleware, server actions, databases or online builds.
@@ -2326,7 +2336,7 @@ function createSakupaMcpServer(opts) {
   );
   const server = new McpServer(
     { name: "sakupa", version: MCP_VERSION },
-    { instructions: INSTRUCTIONS }
+    { instructions: instructionsFor(previewHostPatternFor(opts.apiBaseUrl)) }
   );
   registerTools(server, {
     client,

package/dist/index.js

@@ -123,7 +123,7 @@ var FORBIDDEN_PATH_SEGMENTS = [
 var ALLOWED_HIDDEN_PATHS = [".well-known/"];
 
 // ../core/dist/domain/version.js
-var SAKUPA_MCP_VERSION = "0.7.1";
+var SAKUPA_MCP_VERSION = "0.7.3";
 
 // ../core/dist/domain/errors.js
 var HTTP_STATUS = {
@@ -466,6 +466,9 @@ var CLIENT_TYPE = "sakupa-mcp";
 
 // src/config.ts
 var TEST_API_BASE_URL = "https://api-test.sakupa.com";
+function previewHostPatternFor(apiBaseUrl) {
+  return apiBaseUrl === TEST_API_BASE_URL ? "{shortId}-test.sakupa.com" : "{shortId}.sakupa.com";
+}
 function loadMcpRuntimeConfig(env = process.env, cwd = process.cwd()) {
   const apiBaseUrl = (env["SAKUPA_API_URL"] ?? DEFAULT_API_BASE_URL).replace(/\/+$/, "");
   const projectDir = env["SAKUPA_PROJECT_DIR"] ?? cwd;
@@ -1456,6 +1459,7 @@ async function uploadAll(ctx, targets, files, outputAbs) {
   return targets.length;
 }
 function registerTools(server, ctx) {
+  const previewHostPattern = previewHostPatternFor(ctx.apiBaseUrl);
   server.registerTool(
     "analyze_site",
     {
@@ -1489,7 +1493,7 @@ Next action: ${analysis.suggestedNextAction}`,
   server.registerTool(
     "deploy_site",
     {
-      description: `Deploy the local static output to Sakupa. First deploy creates a free temporary site (valid ${FREE_SITE_TTL_HOURS}h, public URL like https://{shortId}.sakupa.com) and stores the management credential in .sakupa/site.json. Later runs update the existing site (free sites also refresh their validity; subscribed sites are permanent). Runs analyze_site first and refuses to upload source projects, secrets, .env files, archives, media or server code. Never uploads anything when the analysis says the project is not deployable.`,
+      description: `Deploy the local static output to Sakupa. First deploy creates a free temporary site (valid ${FREE_SITE_TTL_HOURS}h, public URL like https://${previewHostPattern}) and stores the management credential in .sakupa/site.json. Later runs update the existing site (free sites also refresh their validity; subscribed sites are permanent). Runs analyze_site first and refuses to upload source projects, secrets, .env files, archives, media or server code. Never uploads anything when the analysis says the project is not deployable.`,
       outputSchema: STRUCTURED_TOOL_OUTPUT_SCHEMA,
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
       inputSchema: {
@@ -1672,7 +1676,7 @@ Free sites stay live for ${FREE_SITE_TTL_HOURS} hours after each deploy or refre
   server.registerTool(
     "subscribe_site",
     {
-      description: `Create a Stripe Checkout link that subscribes THIS site to a Sakupa Hosting monthly plan (${planCatalog()}). Paying makes the site PERMANENT on its {shortId}.sakupa.com URL \u2014 no more 24h expiry; that is the core value of paying. Binding a custom domain afterwards (bind_domain) is an optional included extra and requires DNS control of that domain. Owner-only: requires this project's site credential (.sakupa/site.json) \u2014 deploy_site first. If the site outgrows its plan, Sakupa shows an over-limit notice and never changes billing automatically. The owner can explicitly choose another plan through Stripe Customer Portal. Card details are entered only on the Stripe-hosted page \u2014 never through the AI tool. Opening and completing Stripe Checkout is the final subscription confirmation.`,
+      description: `Create a Stripe Checkout link that subscribes THIS site to a Sakupa Hosting monthly plan (${planCatalog()}). Paying makes the site PERMANENT on its ${previewHostPattern} URL \u2014 no more 24h expiry; that is the core value of paying. Binding a custom domain afterwards (bind_domain) is an optional included extra and requires DNS control of that domain. Owner-only: requires this project's site credential (.sakupa/site.json) \u2014 deploy_site first. If the site outgrows its plan, Sakupa shows an over-limit notice and never changes billing automatically. The owner can explicitly choose another plan through Stripe Customer Portal. Card details are entered only on the Stripe-hosted page \u2014 never through the AI tool. Opening and completing Stripe Checkout is the final subscription confirmation.`,
       outputSchema: STRUCTURED_TOOL_OUTPUT_SCHEMA,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
       inputSchema: {
@@ -1717,7 +1721,7 @@ Once payment confirms, the site becomes permanent on its current URL. Binding a
   server.registerTool(
     "bind_domain",
     {
-      description: "Bind a custom domain to this subscribed site \u2014 an OPTIONAL extra serving surface; the permanent {shortId}.sakupa.com URL keeps working alongside it. The binding unit is the APEX domain: binding example.com automatically includes www.example.com (both serve the same content, one apex TXT verification covers both), and one site binds at most ONE apex domain \u2014 a second domain needs a second subscribed site. Requires an ACTIVE subscription (subscribe_site). Ownership is proven ONLY by DNS control of the apex \u2014 payment never grants ownership. A binding request never reserves the domain: whoever proves DNS control first gets it, and unverified requests expire after 72 hours. Call again with verificationId to check progress.",
+      description: `Bind a custom domain to this subscribed site \u2014 an OPTIONAL extra serving surface; the permanent ${previewHostPattern} URL keeps working alongside it. The binding unit is the APEX domain: binding example.com automatically includes www.example.com (both serve the same content, one apex TXT verification covers both), and one site binds at most ONE apex domain \u2014 a second domain needs a second subscribed site. Requires an ACTIVE subscription (subscribe_site). Ownership is proven ONLY by DNS control of the apex \u2014 payment never grants ownership. A binding request never reserves the domain: whoever proves DNS control first gets it, and unverified requests expire after 72 hours. Call again with verificationId to check progress.`,
       outputSchema: STRUCTURED_TOOL_OUTPUT_SCHEMA,
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
       inputSchema: {
@@ -2281,28 +2285,34 @@ function registerBillingTools(server, ctx) {
 }
 
 // src/server.ts
-var INSTRUCTIONS = `Sakupa publishes AI-made static websites. AI-made pages, live in seconds.
+var instructionsFor = (hostPattern) => `Sakupa publishes AI-made static websites. AI-made pages, live in seconds.
 
 Workflow:
 1. analyze_site \u2014 check whether this project has deployable static output. If a build is needed
    (Vite/Vue/React/Svelte/Astro/Next static export/Nuxt generate), run the build LOCALLY first,
    then re-run analyze_site.
 2. deploy_site \u2014 uploads ONLY the built static output. The first deploy creates a free temporary
-   site (public URL {shortId}.sakupa.com, valid 24 hours, free banner shown) and stores the
+   site (public URL ${hostPattern}, valid 24 hours, free banner shown) and stores the
    management credential in .sakupa/site.json. Deploying again updates the site and refreshes
-   its validity; refresh_site extends validity without uploading.
-3. To make the site PERMANENT, subscribe it to a monthly hosting plan (subscribe_site ->
-   Stripe-hosted checkout; water/personal/share/business). Paying makes the
-   {shortId}.sakupa.com URL permanent \u2014 that is what payment buys. Usage over the chosen plan
+   its validity; refresh_site extends validity without uploading; site_status shows the
+   current deployment and serving state at any time.
+3. To make the site PERMANENT, subscribe it to a monthly hosting plan (list_billing_plans
+   shows the catalog; subscribe_site -> Stripe-hosted checkout;
+   water/personal/share/business). Paying makes the
+   ${hostPattern} URL permanent \u2014 that is what payment buys. Usage over the chosen plan
    shows an over-limit notice by default. An external AI may periodically query usage and
    recommend a plan, but Sakupa never changes a subscription automatically.
 4. Optionally bind a custom domain to the subscribed site (bind_domain): an included extra
    serving surface alongside the permanent URL. Ownership is proven only by DNS control; the
    first verified request wins; unverified requests expire after 72 hours. billing_status,
-   billing_status, change_subscription_plan, manage_billing and recover_domain_site manage the paid
-   lifecycle. Plan changes are confirmed only on Stripe and synchronized by Stripe webhook.
+   change_subscription_plan, manage_billing and recover_domain_site manage the paid
+   lifecycle; unbind_domain removes the custom domain (the permanent URL keeps serving) and
+   delete_site tears the whole site down after explicit confirmation.
+   Plan changes are confirmed only on Stripe and synchronized by Stripe webhook.
    A cancellation keeps the site paid through the current period. Sakupa reverts it to a free
    24h site and removes paid data after Stripe sends the signed final-cancellation webhook.
+5. create_support_ticket (subscribed sites) opens a support ticket; report_bug sends a
+   sanitized diagnostic report after the user explicitly confirms it.
 
 Safety boundaries:
 - Static output only: no SSR, API routes, middleware, server actions, databases or online builds.
@@ -2319,7 +2329,7 @@ function createSakupaMcpServer(opts) {
   );
   const server = new McpServer(
     { name: "sakupa", version: MCP_VERSION },
-    { instructions: INSTRUCTIONS }
+    { instructions: instructionsFor(previewHostPatternFor(opts.apiBaseUrl)) }
   );
   registerTools(server, {
     client,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sakupa/mcp",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "Sakupa MCP server: publish AI-made static sites from your AI tool. AI-made pages, live in seconds.",
   "type": "module",
   "main": "dist/index.js",