@snokam/mcp-api 0.111.1 → 0.111.2

package/dist/index.js

@@ -15,29 +15,34 @@ import { getAccessToken } from "./auth.js";
 // State
 // ---------------------------------------------------------------------------
 let currentEnvironment = process.env.SNOKAM_ENVIRONMENT ?? "production";
-let currentApiDomain = null;
+let apiHostOverride = null;
 let endpoints = [];
 let endpointsByTool = new Map();
 const serviceUrlOverrides = new Map();
+// Backends are reached at {host}/api/{service} on the business's snosky host.
+// SNOKAM_API_HOST sets it explicitly (injected per-business), else it's derived
+// from SNOKAM_BUSINESS + env, and SwitchDomain overrides it at runtime.
+function resolveApiHost(environment) {
+    const explicit = process.env.SNOKAM_API_HOST;
+    if (explicit)
+        return normalizeDomain(explicit);
+    const suffix = environment === "test" ? "test.snosky.no" : "snosky.no";
+    const business = process.env.SNOKAM_BUSINESS;
+    return business ? `${business}.${suffix}` : suffix;
+}
+function activeApiHost() {
+    return apiHostOverride ?? resolveApiHost(currentEnvironment);
+}
 async function loadEndpoints(environment) {
     currentEnvironment = environment;
-    endpoints = await fetchSpecs(environment);
+    endpoints = await fetchSpecs(environment, activeApiHost());
     endpointsByTool = new Map();
     for (const ep of endpoints) {
         endpointsByTool.set(ep.toolName, ep);
     }
-    // Re-target every service at the active business domain (if set), then layer
-    // per-service overrides on top (most specific wins).
-    applyDomainOverride();
+    // Layer per-service overrides (e.g. localhost) on top; most specific wins.
     applyUrlOverrides();
 }
-function applyDomainOverride() {
-    if (!currentApiDomain)
-        return;
-    for (const ep of endpoints) {
-        ep.baseUrl = `https://${ep.service}.${currentApiDomain}`;
-    }
-}
 function applyUrlOverrides() {
     for (const ep of endpoints) {
         const override = serviceUrlOverrides.get(ep.service);
@@ -111,13 +116,13 @@ const resetUrlToolDef = {
 const SWITCH_DOMAIN_TOOL_NAME = "SwitchDomain";
 const switchDomainToolDef = {
     name: SWITCH_DOMAIN_TOOL_NAME,
-    description: "Point all Snokam API calls at a specific business's API domain, so the same MCP can serve any tenant. Pass the business's API domain (custom, e.g. api.acme.com, or its snosky fallback, e.g. api.acme.snosky.no); calls then go to {service}.{domain}. Pass an empty string to reset to the platform-wide snosky default.",
+    description: "Point all Snokam API calls at a specific business's API host, so the same MCP can serve any tenant. Pass the business's API host (custom, e.g. acme.no, or its snosky fallback, e.g. acme.snosky.no); calls then go to {host}/api/{service}. Pass an empty string to reset to the environment default.",
     inputSchema: {
         type: "object",
         properties: {
             domain: {
                 type: "string",
-                description: "The business's API base domain (e.g. api.acme.com). Empty string resets to the platform-wide snosky default.",
+                description: "The business's API host (e.g. acme.snosky.no). Empty string resets to the environment default.",
             },
         },
         required: ["domain"],
@@ -375,16 +380,16 @@ Controls: Sonos speakers, lights, YouTube queue
         }
         // Handle SwitchDomain
         if (name === SWITCH_DOMAIN_TOOL_NAME) {
-            currentApiDomain = normalizeDomain(String(args.domain ?? "")) || null;
+            apiHostOverride = normalizeDomain(String(args.domain ?? "")) || null;
             await loadEndpoints(currentEnvironment);
             await server.sendToolListChanged();
             return {
                 content: [
                     {
                         type: "text",
-                        text: currentApiDomain
-                            ? `API calls now target ${currentApiDomain} ({service}.${currentApiDomain}).`
-                            : "API domain reset to the environment default.",
+                        text: apiHostOverride
+                            ? `API calls now target ${apiHostOverride}/api/{service}.`
+                            : `API host reset to the environment default (${activeApiHost()}).`,
                     },
                 ],
             };

package/dist/openapi-loader.d.ts

@@ -1,11 +1,12 @@
 /**
  * Fetch OpenAPI specs from live Snokam APIs and produce tool definitions.
  *
- * Backends are reached on the platform-wide snosky domain, which is uniform
- * across every business (no per-customer hostname): `{service}.api.snosky.no`
- * (prod) or `{service}.api.test.snosky.no` (test). A specific business domain
- * can still be targeted at runtime via the SwitchDomain tool. The loader
- * extracts endpoints, parameters, and OAuth scopes for MCP tool metadata.
+ * Backends are reached per-business at `{business}.snosky.no/api/{service}`
+ * (prod) or `{business}.test.snosky.no/api/{service}` (test) — the uniform
+ * snosky routing that works for every tenant, no per-customer hostname. The
+ * business API host is injected (SNOKAM_API_HOST) and can be retargeted at
+ * runtime via the SwitchDomain tool. The loader extracts endpoints,
+ * parameters, and OAuth scopes for MCP tool metadata.
  */
 export interface ApiEndpoint {
     service: string;
@@ -48,5 +49,5 @@ interface OpenApiRequestBody {
  * and return parsed endpoints for that service.
  */
 export declare function fetchSpecFromUrl(service: string, baseUrl: string): Promise<ApiEndpoint[]>;
-export declare function fetchSpecs(environment: string): Promise<ApiEndpoint[]>;
+export declare function fetchSpecs(environment: string, apiHost: string): Promise<ApiEndpoint[]>;
 export {};

package/dist/openapi-loader.js

@@ -1,11 +1,12 @@
 /**
  * Fetch OpenAPI specs from live Snokam APIs and produce tool definitions.
  *
- * Backends are reached on the platform-wide snosky domain, which is uniform
- * across every business (no per-customer hostname): `{service}.api.snosky.no`
- * (prod) or `{service}.api.test.snosky.no` (test). A specific business domain
- * can still be targeted at runtime via the SwitchDomain tool. The loader
- * extracts endpoints, parameters, and OAuth scopes for MCP tool metadata.
+ * Backends are reached per-business at `{business}.snosky.no/api/{service}`
+ * (prod) or `{business}.test.snosky.no/api/{service}` (test) — the uniform
+ * snosky routing that works for every tenant, no per-customer hostname. The
+ * business API host is injected (SNOKAM_API_HOST) and can be retargeted at
+ * runtime via the SwitchDomain tool. The loader extracts endpoints,
+ * parameters, and OAuth scopes for MCP tool metadata.
  */
 // ---------------------------------------------------------------------------
 // Service discovery - reads from bundled specs directory at runtime
@@ -31,13 +32,8 @@ async function discoverServices(environment) {
 // ---------------------------------------------------------------------------
 // Environment-aware URL resolution
 // ---------------------------------------------------------------------------
-const PROD_DOMAIN = "api.snosky.no";
-const TEST_DOMAIN = "api.test.snosky.no";
-function getBaseDomain(environment) {
-    return environment === "test" ? TEST_DOMAIN : PROD_DOMAIN;
-}
-function getBaseUrl(service, environment) {
-    return `https://${service}.${getBaseDomain(environment)}`;
+function getBaseUrl(service, apiHost) {
+    return `https://${apiHost}/api/${service}`;
 }
 // ---------------------------------------------------------------------------
 // Scope extraction
@@ -117,10 +113,10 @@ export async function fetchSpecFromUrl(service, baseUrl) {
     const spec = (await response.json());
     return parseSpec(spec, service, baseUrl);
 }
-export async function fetchSpecs(environment) {
+export async function fetchSpecs(environment, apiHost) {
     // Try to load bundled specs first (for speed)
     try {
-        const bundledSpecs = await loadBundledSpecs(environment);
+        const bundledSpecs = await loadBundledSpecs(environment, apiHost);
         if (bundledSpecs.length > 0) {
             console.error(`[snokam-mcp] Loaded ${bundledSpecs.length} endpoints from bundled specs (env=${environment})`);
             return bundledSpecs;
@@ -138,7 +134,7 @@ export async function fetchSpecs(environment) {
     }
     const endpoints = [];
     const results = await Promise.allSettled(services.map(async (service) => {
-        const baseUrl = getBaseUrl(service, environment);
+        const baseUrl = getBaseUrl(service, apiHost);
         const swaggerUrl = `${baseUrl}/swagger.json`;
         const response = await fetch(swaggerUrl, {
             signal: AbortSignal.timeout(10_000),
@@ -164,7 +160,7 @@ export async function fetchSpecs(environment) {
     console.error(`[snokam-mcp] Loaded ${endpoints.length} endpoints from ${successCount}/${services.length} services (env=${environment})`);
     return endpoints;
 }
-async function loadBundledSpecs(environment) {
+async function loadBundledSpecs(environment, apiHost) {
     const { readFile } = await import("fs/promises");
     const { fileURLToPath } = await import("url");
     const { dirname, join } = await import("path");
@@ -178,7 +174,7 @@ async function loadBundledSpecs(environment) {
             const specPath = join(specsDir, `${service}.json`);
             const specData = await readFile(specPath, "utf-8");
             const spec = JSON.parse(specData);
-            const baseUrl = getBaseUrl(service, environment);
+            const baseUrl = getBaseUrl(service, apiHost);
             endpoints.push(...parseSpec(spec, service, baseUrl));
         }
         catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snokam/mcp-api",
-  "version": "0.111.1",
+  "version": "0.111.2",
   "description": "MCP server exposing Snokam backend APIs as tools for Claude Code and other MCP clients",
   "type": "module",
   "bin": {