@vantageos/mcp-boilerplate 0.7.0 → 0.8.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "vantage-mcp-boilerplate",
   "displayName": "VantageOS MCP Boilerplate",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Clonable MCP server template: SDK v2 on protocol 2026-07-28 (stdio + stateless Streamable HTTP), its own OAuth 2.1 authorization server (Clerk person + organisation), MCP Apps UI, FR/EN i18n and a declarative eval harness. Scaffold, extend, publish.",
   "author": {
     "name": "ElPi Corp / Laurent Perello"

package/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.8.0] - 2026-11-10
+
+### Added
+- `docs/manufact-gap.md`: the gap list of this boilerplate against every Manufact quality-score check (31 checks, server metadata, discoverability, policy review, domain), each with its verdict, the mcp-doctor rule, the evidence and the file that owns the fix.
+- Server metadata and discoverability (mcp-server-standard S-49, S-50; Manufact "Server Metadata" and "Discoverability"): `serverInfo` serves `title`, `description` (English, or French on `X-MCP-Locale: fr`), `websiteUrl` and a vector icon served at `/icon.svg`, all derived from `package.json` (`displayName`, `description`, `description_fr`, `homepage`) or the `MCP_SERVER_*` variables (`.env.example`); the instructions say how to use the tools instead of pointing to the README; the MCP Server Card is served without credential at `/mcp/server-card`, `/.well-known/mcp/server-card.json`, `/.well-known/mcp-server-card`, `/mcp.json` and `/.well-known/mcp.json`; a browser `GET /mcp` gets a bilingual setup page naming the MCP URL, ahead of the auth gate. Build identity (C-25): `/health` and `serverInfo` `buildId` is now the git commit the tree was built from (`dist/build-info.json`, written by `npm run build`), and the hash of the built files moves to `buildHash`.
+- **The view resource describes itself.** The `ui://` resource carries a bilingual `widgetDescription` (EN / FR) under `_meta.ui.widgetDescription` and `_meta["openai/widgetDescription"]`, the two keys Manufact's *tool-resource-metadata-complete* check reads (T2, docs/manufact-gap.md). The text lives in `src/locales/{en,fr}.json` (`widget.description`).
+
+### Fixed
+- **The package imports from a bundle: locales, version and identity fields are module values, never a file read at import.** `src/i18n.ts` read `locales/{en,fr}.json` and `src/version.ts` read `package.json` when imported, so a bundled consumer (a Convex action importing `@vantageos/lojii-client`, which depends on this package) failed with ENOENT before any code ran. `scripts/embed-static.mjs` now writes `src/embedded.generated.ts` from those files at build (`--check` refuses a stale copy); `getServerIdentity()` reads the embedded package fields too. Proven by importing the built `dist/` from a directory with no `locales/` and no `package.json` (tests/i18n-bundled.test.ts). Declared, unchanged: the server's runtime assets (mcp-server.json, the widget bundle, tool roles, the build-tree hash) are still read on demand when a server starts, not at import. (README: #server-side-i18n-fren)
+- `mcp-readme-fr` prints every line number 1-based: a region opened by `lang:fr` without its English part was reported as "opened at line 0", and an unclosed region at the end of a file ending with a newline named the empty line after it as the last line.
+
 ## [0.7.0] - 2026-11-02
 
 ### Added
@@ -532,6 +543,7 @@ Initial published release.
 - MIT license, clonable as a starter template.
 
 [Unreleased]: https://github.com/elpiarthera/vantage-mcp-boilerplate/compare/v0.4.0...HEAD
+[0.8.0]: https://www.npmjs.com/package/@vantageos/mcp-boilerplate/v/0.8.0
 [0.7.0]: https://www.npmjs.com/package/@vantageos/mcp-boilerplate/v/0.7.0
 [0.6.3]: https://www.npmjs.com/package/@vantageos/mcp-boilerplate/v/0.6.3
 [0.6.2]: https://www.npmjs.com/package/@vantageos/mcp-boilerplate/v/0.6.2

package/README.fr.md

@@ -23,7 +23,10 @@ src/
   toolRecord.ts         # fiche d'outil typée : autorité, verbe, table, mécanisme, pagination, coût
   pagination.ts         # pagination par curseur appliquée par l'outil (défaut, max fini, invalid_cursor)
   signedCursor.ts       # primitive de curseur signé HMAC (createCursorSigner), utilisée par tout curseur
-  buildIdentity.ts      # identité de build dérivée de l'arbre servi
+  buildIdentity.ts      # identité de build : le commit git construit (buildId) + le hachage des fichiers construits (buildHash)
+  serverIdentity.ts     # titre, description, site, icône, instructions : package.json ou env
+  serverCard.ts         # la MCP Server Card publique
+  landingPage.ts        # la page d'installation servie à un navigateur sur /mcp
   stdio.ts              # serveStdio(factory) : les deux ères du protocole sur stdio
   http.ts               # adaptateur Node http.Server autour de l'app Hono
   httpApp.ts            # createMcpHandler(factory) sur /mcp + la barrière OAuth
@@ -561,7 +564,10 @@ ligne.
 le client envoie `X-MCP-Locale: fr|en` (défaut `en`) ; le sélecteur navigateur suit
 `Accept-Language`. Les fichiers de ressources (`src/locales/{en,fr}.json`) gardent la
 convention `<Namespace>.<category>.<key>` de `@vantageos/mosaic-i18n`, FR et EN en
-parité.
+parité. Ils sont intégrés au module au build (`scripts/embed-static.mjs` écrit
+`src/embedded.generated.ts`, avec la version et les champs d'identité du paquet) : rien n'est lu sur le disque
+à l'import, et un consommateur empaqueté (le bundler Convex, esbuild) exécute le paquet sans dossier `locales/`
+ni `package.json` à côté ; `--check` refuse une copie périmée.
 
 ## Un README français généré depuis un README bilingue
 
@@ -623,6 +629,40 @@ modifie jamais `CHANGELOG.md`, dont le bloc `## [Unreleased]` reste vide. `npm r
 (`changelog.d/README.md`, `docs/releasing.md`). Deux pull requests qui ajoutent deux fichiers n'entrent jamais
 en conflit, là où deux modifications du même bloc le faisaient.
 
+## Identité du serveur et découverte
+
+Ce qu'un hôte ou un annuaire lit du serveur avant et pendant la connexion est dérivé, jamais tapé dans le
+source (`src/serverIdentity.ts`, mcp-server-standard S-49 / S-50) :
+
+| Servi comme | Variable d'environnement | Sinon, `package.json` |
+|---|---|---|
+| `serverInfo.title` | `MCP_SERVER_TITLE` | `displayName` |
+| `serverInfo.description` (anglais) | `MCP_SERVER_DESCRIPTION` | `description` |
+| `serverInfo.description` (français, `X-MCP-Locale: fr`) | `MCP_SERVER_DESCRIPTION_FR` | `description_fr` |
+| `serverInfo.websiteUrl` | `MCP_SERVER_WEBSITE_URL` (https, ou http en bouclage) | `homepage` |
+
+Un fork modifie ces champs de `package.json`, ou définit les variables (`.env.example`). Une valeur qu'aucune
+des deux sources ne porte arrête le serveur au démarrage, en nommant la variable et le champ : le serveur ne
+sert jamais de valeur fictive.
+
+- **Instructions** (`initialize` / `server/discover`) : comment un agent utilise les outils, dans la langue de
+  l'appelant, depuis `Mcp.server.instructions` dans `src/locales/{en,fr}.json`. Réécrivez-les pour vos
+  outils : `tests/serverMetadata.test.ts` échoue quand un outil servi n'y est pas nommé ou que le texte dépasse
+  2048 octets (le budget de champ de Claude Code).
+- **Icône** : un vectoriel, `src/serverIcon.ts` (remplacez le SVG par votre logo), servi à `/icon.svg` et
+  nommé dans `serverInfo.icons` ; en stdio il voyage en URI `data:`.
+- **Carte serveur** : la MCP Server Card (forme SEP-2127, plus `capabilities` et un résumé `tools` lu sur les
+  outils enregistrés), servie sans identifiant à `/mcp/server-card`, `/.well-known/mcp/server-card.json`,
+  `/.well-known/mcp-server-card`, `/mcp.json` et `/.well-known/mcp.json`. Son `name` est en DNS inversé, dérivé
+  du site (`io.github.<propriétaire>/<nom>` pour une URL GitHub).
+- **Page d'installation** : un `GET /mcp` de navigateur (sans `Authorization`, avec un `Accept` sans
+  `text/event-stream`) reçoit une page bilingue qui nomme l'URL MCP et comment se connecter, sur les deux
+  paliers. Toute requête MCP est inchangée, y compris le 401 + `WWW-Authenticate` du palier OAuth.
+
+La carte, la page et l'URL de l'icône nomment `PUBLIC_BASE_URL` + `/mcp` quand il est défini. Non défini
+(développement), elles nomment l'origine à laquelle la requête était adressée et partent avec
+`Cache-Control: no-store`. Définissez `PUBLIC_BASE_URL` sur tout déploiement public.
+
 ## Packaging & distribution
 
 Quatre manifestes sont **générés** depuis `scripts/plugin-manifest.source.json` et
@@ -729,9 +769,13 @@ curl -s -H 'Cache-Control: no-cache' https://registry.npmjs.org/@vantageos%2Fmcp
 
 Sommes égales : le registre sert ce que la source construit. Un serveur en marche
 prouve de la même façon ce qu'il sert : `GET /health` renvoie
-`{ status, version, buildId }` avant toute authentification. `buildId` est un hachage
-des fichiers dont le processus s'exécute ; il change quand ils changent, ce que
-`version` ne garantit pas.
+`{ status, version, buildId, buildHash }` avant toute authentification. `buildId` est le
+commit git à partir duquel l'arbre servi a été construit, dérivé par `npm run build`
+(`scripts/write-build-info.mjs` écrit `dist/build-info.json`) : `BUILD_COMMIT`, sinon le commit qu'un
+hébergeur injecte au build (`RAILWAY_GIT_COMMIT_SHA`, `VERCEL_GIT_COMMIT_SHA`, `RENDER_GIT_COMMIT`,
+`GITHUB_SHA`, `SOURCE_VERSION`), sinon `git rev-parse HEAD` ; sans aucun, le build échoue en nommant
+`BUILD_COMMIT`. `buildHash` est un hachage des fichiers dont le processus s'exécute ; il change aussi
+quand un arbre modifié ou un `dist/` retouché est servi, ce que ni `version` ni le commit ne garantissent.
 
 ## Couche UI MCP Apps
 

package/README.md

@@ -22,7 +22,10 @@ src/
   toolRecord.ts         # typed tool record: authority, verb, table, mechanism, pagination, cost
   pagination.ts         # cursor pagination applied by the tool (default, finite max, invalid_cursor)
   signedCursor.ts       # HMAC-signed cursor primitive (createCursorSigner), used by every cursor
-  buildIdentity.ts      # build identity derived from the served tree
+  buildIdentity.ts      # build identity: the git commit built (buildId) + the hash of the built files (buildHash)
+  serverIdentity.ts     # title, description, website, icon, instructions: package.json or env
+  serverCard.ts         # the public MCP Server Card
+  landingPage.ts        # the setup page a browser gets at /mcp
   stdio.ts              # serveStdio(factory): both protocol eras over stdio
   http.ts               # Node http.Server adapter around the Hono app
   httpApp.ts            # createMcpHandler(factory) on /mcp + the OAuth gate
@@ -531,7 +534,10 @@ row value.
 client sends `X-MCP-Locale: fr|en` (default `en`); the browser picker follows
 `Accept-Language`. Resource files (`src/locales/{en,fr}.json`) keep the
 `<Namespace>.<category>.<key>` convention of `@vantageos/mosaic-i18n`, FR and EN
-in lockstep.
+in lockstep. They are embedded in the module at build (`scripts/embed-static.mjs` writes
+`src/embedded.generated.ts`, with the package version and identity fields), so nothing is read from disk at
+import and a bundled consumer (the Convex bundler, esbuild) runs the package with no `locales/` folder or
+`package.json` beside it; `--check` refuses a stale copy.
 
 ## A French README generated from a bilingual one
 
@@ -589,6 +595,39 @@ refuses a malformed fragment or an entry written under `## [Unreleased]`. At rel
 (`changelog.d/README.md`, `docs/releasing.md`). Two pull requests adding two files never conflict, where two
 edits of the same block did.
 
+## Server identity and discovery
+
+What a host or a directory reads about the server before and at connection is derived, never typed in
+source (`src/serverIdentity.ts`, mcp-server-standard S-49 / S-50):
+
+| Served as | Environment override | Otherwise, `package.json` |
+|---|---|---|
+| `serverInfo.title` | `MCP_SERVER_TITLE` | `displayName` |
+| `serverInfo.description` (English) | `MCP_SERVER_DESCRIPTION` | `description` |
+| `serverInfo.description` (French, `X-MCP-Locale: fr`) | `MCP_SERVER_DESCRIPTION_FR` | `description_fr` |
+| `serverInfo.websiteUrl` | `MCP_SERVER_WEBSITE_URL` (https, or http on loopback) | `homepage` |
+
+A fork edits those `package.json` fields, or sets the variables (`.env.example`). A value neither source
+carries stops the server at start, naming the variable and the field: the server never serves a placeholder.
+
+- **Instructions** (`initialize` / `server/discover`): how an agent uses the tools, in the caller's locale, from
+  `Mcp.server.instructions` in `src/locales/{en,fr}.json`. Rewrite them for your tools:
+  `tests/serverMetadata.test.ts` fails when a served tool is not named or the text passes 2048 bytes (Claude
+  Code's field budget).
+- **Icon**: a vector, `src/serverIcon.ts` (replace the SVG with your mark), served at `/icon.svg` and named
+  in `serverInfo.icons`; on stdio it travels as a `data:` URI.
+- **Server card**: the MCP Server Card (SEP-2127 shape, plus `capabilities` and a `tools` summary read from
+  the registered tools), served without credential at `/mcp/server-card`, `/.well-known/mcp/server-card.json`,
+  `/.well-known/mcp-server-card`, `/mcp.json` and `/.well-known/mcp.json`. Its `name` is reverse-DNS, derived
+  from the website (`io.github.<owner>/<name>` for a GitHub URL).
+- **Setup page**: a browser `GET /mcp` (no `Authorization`, an `Accept` without `text/event-stream`) gets a
+  bilingual page naming the MCP URL and how to connect, on both tiers. Every MCP request is unchanged,
+  including the OAuth tier's 401 + `WWW-Authenticate`.
+
+The card, the page and the icon URL name `PUBLIC_BASE_URL` + `/mcp` when it is set. Unset (development),
+they name the origin the request was addressed to and are sent `Cache-Control: no-store`. Set
+`PUBLIC_BASE_URL` on every public deployment.
+
 ## Packaging & distribution
 
 Four manifests are **generated** from `scripts/plugin-manifest.source.json` and
@@ -690,9 +729,13 @@ curl -s -H 'Cache-Control: no-cache' https://registry.npmjs.org/@vantageos%2Fmcp
 ```
 
 Equal sums: the registry serves what the source builds. A running server proves what
-it serves the same way: `GET /health` returns `{ status, version, buildId }` before any
-authentication. `buildId` is a hash of the files the process runs from, so it changes
-when they change, which `version` does not guarantee.
+it serves the same way: `GET /health` returns `{ status, version, buildId, buildHash }` before any
+authentication. `buildId` is the git commit the served tree was built from, derived by `npm run build`
+(`scripts/write-build-info.mjs` writes `dist/build-info.json`): `BUILD_COMMIT`, else the commit a host
+injects at build time (`RAILWAY_GIT_COMMIT_SHA`, `VERCEL_GIT_COMMIT_SHA`, `RENDER_GIT_COMMIT`, `GITHUB_SHA`,
+`SOURCE_VERSION`), else `git rev-parse HEAD`; with none, the build fails, naming `BUILD_COMMIT`. `buildHash` is
+a hash of the files the process runs from, so it also changes when a dirty tree or a patched `dist/` is
+served, which neither `version` nor the commit guarantees.
 
 ## MCP Apps UI layer
 

package/dist/build-info.json

@@ -0,0 +1 @@
+{"commit":"4193f2a535d8229f071524265a7e6bb98e19d34e"}

package/dist/buildIdentity.d.ts

@@ -17,3 +17,19 @@
 export declare function computeBuildIdentity(dir: string): string;
 /** The identity of the tree THIS process runs from, computed once. */
 export declare function getBuildIdentity(): string;
+/**
+ * The git commit the served tree was built from: the `buildId` of /health and serverInfo (C-25,
+ * ruling: build identity = the commit). It is DERIVED at build time by
+ * scripts/write-build-info.mjs (`npm run build`), which writes `dist/build-info.json`, and read
+ * here — never typed. `src/` and `dist/` both sit one level under the package root, so the same
+ * relative URL resolves in source mode (vitest) and in the built output.
+ *
+ * The hash of the built files above stays served beside it as `buildHash`: the commit names the
+ * source, the hash proves the files a process runs from (a dirty tree or a patched dist changes
+ * the hash, not the commit).
+ */
+export declare const BUILD_INFO_URL: URL;
+/** The commit recorded in a build-info file. Throws, naming the file, if it is not readable. */
+export declare function readBuildCommit(path: string): string;
+/** The build commit of THIS process, read once. */
+export declare function getBuildCommit(): string;

package/dist/buildIdentity.js

@@ -60,3 +60,42 @@ export function getBuildIdentity() {
     processIdentity ??= computeBuildIdentity(dirname(fileURLToPath(import.meta.url)));
     return processIdentity;
 }
+/**
+ * The git commit the served tree was built from: the `buildId` of /health and serverInfo (C-25,
+ * ruling: build identity = the commit). It is DERIVED at build time by
+ * scripts/write-build-info.mjs (`npm run build`), which writes `dist/build-info.json`, and read
+ * here — never typed. `src/` and `dist/` both sit one level under the package root, so the same
+ * relative URL resolves in source mode (vitest) and in the built output.
+ *
+ * The hash of the built files above stays served beside it as `buildHash`: the commit names the
+ * source, the hash proves the files a process runs from (a dirty tree or a patched dist changes
+ * the hash, not the commit).
+ */
+export const BUILD_INFO_URL = new URL("../dist/build-info.json", import.meta.url);
+const FULL_COMMIT = /^[0-9a-f]{40}$/;
+/** The commit recorded in a build-info file. Throws, naming the file, if it is not readable. */
+export function readBuildCommit(path) {
+    let commit;
+    try {
+        commit = JSON.parse(readFileSync(path, "utf8")).commit;
+    }
+    catch (error) {
+        throw new Error(tBoth("buildIdentity.commitUnreadable", {
+            file: path,
+            reason: error instanceof Error ? error.message : String(error),
+        }));
+    }
+    if (typeof commit !== "string" || !FULL_COMMIT.test(commit)) {
+        throw new Error(tBoth("buildIdentity.commitUnreadable", {
+            file: path,
+            reason: "commit is not a 40-hex git commit id",
+        }));
+    }
+    return commit;
+}
+let processCommit;
+/** The build commit of THIS process, read once. */
+export function getBuildCommit() {
+    processCommit ??= readBuildCommit(fileURLToPath(BUILD_INFO_URL));
+    return processCommit;
+}

package/dist/embedded.generated.d.ts

@@ -0,0 +1,225 @@
+export declare const EMBEDDED_LOCALES: {
+    readonly en: {
+        readonly Mcp: {
+            readonly auth: {
+                readonly unauthorized: "Unauthorized";
+                readonly originNotAllowed: "This origin is not allowed to call this endpoint";
+            };
+            readonly tenant: {
+                readonly permissionDenied: "permission denied: no tenant resolved for this caller";
+            };
+            readonly person: {
+                readonly identityNotConfigured: "permission denied: this tool needs the verified person, and this server resolves no person (identity is not configured)";
+                readonly noVerifiedSession: "permission denied: this tool needs the verified person, and this call carries no verified session";
+                readonly refused: "permission denied: the verified person behind this call could not be resolved";
+            };
+            readonly rateLimit: {
+                readonly exceeded: "too many tool calls: retry in {seconds} s";
+            };
+            readonly validation: {
+                readonly messageTooLong: "message exceeds the maximum length of 200 characters";
+            };
+            readonly oauth: {
+                readonly pickerTitle: "Connect {client}";
+                readonly pickerIntro: "{client} asks to act on your behalf. Choose the organisation it may reach, then approve or deny.";
+                readonly handoffTitle: "Returning to the application";
+                readonly handoffLink: "Continue to the application";
+                readonly pickerNoAllowedOrganisation: "None of your organisations is authorised on this server.";
+                readonly pickerDestination: "After approval you are sent to:";
+                readonly pickerScope: "Requested access:";
+                readonly pickerUnverified: "Unverified client: it registered itself automatically and nobody has vouched for it. Approve only if you recognise the address above.";
+                readonly pickerOrganisation: "Organisation";
+                readonly approve: "Approve";
+                readonly deny: "Deny";
+                readonly denied: "The request was denied; you can close this window.";
+                readonly unavailable: "Authorization is not configured on this server.";
+                readonly inMemoryWarning: "Running on in-memory OAuth stores: codes and registered clients are lost on restart and not shared between instances. Fine for development; set {knob}=1 to acknowledge, or inject durable adapters.";
+                readonly consentTokenRequired: "The consent token is missing: reload the page and try again.";
+                readonly registryFull: "Client registration is temporarily unavailable: the registry is full. Retry later.";
+                readonly devInstanceRemote: "Development Clerk instance on a remote server: its hosted sign-in page redirects only to localhost or to the instance Home URL. Set the development instance's Home URL (development origin) to this server's origin for a remote test and revert it afterwards, or use a Clerk production instance (see README, \"Sign-in with ChatGPT and Claude\").";
+            };
+            readonly manifest: {
+                readonly unreadableField: "cannot read field \"{field}\" of {source} (expected: {expected})";
+                readonly expect: {
+                    readonly string: "a non-empty string";
+                    readonly semver: "a semantic version (x.y.z)";
+                    readonly object: "an object";
+                    readonly boolean: "true or false";
+                    readonly positiveInteger: "a positive whole number";
+                    readonly atLeastPerTool: "at least the perTool ceiling";
+                    readonly stringArray: "an array of non-empty strings";
+                };
+            };
+            readonly toolRoles: {
+                readonly identityMissing: "the identity stores are not injected (AppDeps.identity): on the OAuth tier a caller's role is decided for the organisation the identity layer resolves, so both are required";
+                readonly denied: "permission denied: your role does not grant the tool {tool} ({reason})";
+                readonly unresolved: "permission denied: your role could not be read, so no tool is granted";
+                readonly configMissing: "{variable} is not set: on the OAuth tier every tool is decided by the caller's role, read from that roles file";
+                readonly configInvalid: "{variable} ({path}) is not a valid roles file: {problem}";
+            };
+            readonly toolRecord: {
+                readonly unsound: "tool records or the context ceiling are unsound: {problems}";
+            };
+            readonly pagination: {
+                readonly invalidCursor: "invalid cursor: it was not issued by this tool or is no longer valid; start again without a cursor";
+            };
+            readonly lake: {
+                readonly unreadable: "the data source answered something this server cannot read; no row is shown rather than a partial or wrong page";
+            };
+            readonly buildIdentity: {
+                readonly unreadable: "cannot compute the build identity: {dir} is unreadable ({reason})";
+                readonly empty: "cannot compute the build identity: {dir} is empty (no file), nothing was built";
+                readonly commitUnreadable: "cannot read the build commit from {file} ({reason}): run npm run build, which writes it (scripts/write-build-info.mjs)";
+            };
+            readonly config: {
+                readonly refused: "configuration refused: {problems}";
+                readonly missing: "{env} is missing (expected: {expected})";
+                readonly invalid: "{env} is set but invalid (expected: {expected}; value not shown)";
+                readonly expect: {
+                    readonly string: "a non-empty string";
+                    readonly integer: "an integer from {min} to {max}";
+                    readonly integerAtLeast: "an integer of at least {min}";
+                    readonly boolean: "\"0\" or \"1\"";
+                    readonly url: "an https URL (http on loopback only)";
+                    readonly originList: "a comma-separated list of origins (scheme://host[:port], no path)";
+                    readonly enum: "one of: {values}";
+                    readonly json: "a JSON object or array";
+                };
+            };
+            readonly server: {
+                readonly instructions: "This server exposes three read-only example tools.\n1. Call whoami first. It returns who is calling on this connection (null on the public tier and on stdio), the caller's role, and grantedTools: the tools that role may call. Never ask the user for their identity and never pass one as an argument.\n2. ping proves the connection end to end; pass message to have it echoed back.\n3. list_items lists the items of the caller's organisation and renders them in an interactive widget where the client supports MCP Apps. It is paged: pass the returned nextCursor to read the next page; exhausted: true means the last page. Never invent a cursor.\n4. A result with isError and structuredContent.error.code is a refusal, not an empty result: rate_limited (wait retryAfterMs, then retry once), invalid_cursor (restart from the first page), lake_unreadable, TOOL_ROLE_DENIED or TOOL_ROLE_UNRESOLVED (the caller may not use this tool). Report it to the user; never read it as \"nothing exists\".\n5. Send the X-MCP-Locale header (en or fr) to receive messages in that language.";
+                readonly identityMissing: "the server identity has no {item}: set {variable}, or the \"{field}\" field of package.json";
+                readonly identityInvalid: "the server identity's {item} is not an https URL (http on a loopback host only): {source}";
+            };
+            readonly landing: {
+                readonly pageTitle: "{title} — MCP server";
+                readonly intro: "This address is a Model Context Protocol (MCP) server. Add it to your AI client as a remote MCP server:";
+                readonly claudeAi: "Claude.ai: add a custom connector with this URL, then Connect.";
+                readonly chatgpt: "ChatGPT: add a custom MCP server (developer mode) with this URL.";
+                readonly claudeCode: "Claude Code:";
+                readonly other: "Any other MCP client: a Streamable HTTP server at the URL above.";
+                readonly authOauth: "Your client then opens a sign-in page (OAuth 2.1). There is no token to copy.";
+                readonly authPublic: "This server runs without sign-in: connect directly.";
+                readonly website: "Website:";
+            };
+            readonly widget: {
+                readonly description: "Shows the example items returned by list_items as a list, with their name and status; read-only, it makes no request of its own.";
+            };
+        };
+    };
+    readonly fr: {
+        readonly Mcp: {
+            readonly auth: {
+                readonly unauthorized: "Non autorisé";
+                readonly originNotAllowed: "Cette origine n'est pas autorisée à appeler ce point d'accès";
+            };
+            readonly tenant: {
+                readonly permissionDenied: "permission refusée : aucun tenant résolu pour cet appelant";
+            };
+            readonly person: {
+                readonly identityNotConfigured: "permission refusée : cet outil exige la personne vérifiée, et ce serveur ne résout aucune personne (identité non configurée)";
+                readonly noVerifiedSession: "permission refusée : cet outil exige la personne vérifiée, et cet appel ne porte aucune session vérifiée";
+                readonly refused: "permission refusée : la personne vérifiée derrière cet appel n'a pas pu être résolue";
+            };
+            readonly rateLimit: {
+                readonly exceeded: "trop d’appels d’outils : réessayez dans {seconds} s";
+            };
+            readonly validation: {
+                readonly messageTooLong: "le message dépasse la longueur maximale de 200 caractères";
+            };
+            readonly oauth: {
+                readonly pickerTitle: "Connecter {client}";
+                readonly pickerIntro: "{client} demande à agir en votre nom. Choisissez l'organisation à laquelle il peut accéder, puis approuvez ou refusez.";
+                readonly handoffTitle: "Retour à l'application";
+                readonly handoffLink: "Continuer vers l'application";
+                readonly pickerNoAllowedOrganisation: "Aucune de vos organisations n'est autorisée sur ce serveur.";
+                readonly pickerDestination: "Redirection après validation vers :";
+                readonly pickerScope: "Accès demandé :";
+                readonly pickerUnverified: "Client non vérifié : il s'est enregistré automatiquement et personne ne s'en porte garant. N'approuvez que si vous reconnaissez l'adresse ci-dessus.";
+                readonly pickerOrganisation: "Organisation";
+                readonly approve: "Approuver";
+                readonly deny: "Refuser";
+                readonly denied: "La demande a été refusée ; vous pouvez fermer cette fenêtre.";
+                readonly unavailable: "L'autorisation n'est pas configurée sur ce serveur.";
+                readonly inMemoryWarning: "Stores OAuth en mémoire : les codes et les clients enregistrés sont perdus au redémarrage et non partagés entre instances. Acceptable en développement ; définissez {knob}=1 pour l'accepter, ou injectez des adaptateurs durables.";
+                readonly consentTokenRequired: "Le jeton de consentement est absent : rechargez la page et réessayez.";
+                readonly registryFull: "L'enregistrement de clients est temporairement indisponible : le registre est plein. Réessayez plus tard.";
+                readonly devInstanceRemote: "Instance Clerk de développement sur un serveur distant : sa page de connexion hébergée ne redirige que vers localhost ou vers l'URL d'accueil (Home URL) de l'instance. Pour un test distant, réglez l'URL d'accueil (origine de développement) de l'instance sur l'origine de ce serveur, puis rétablissez-la ; sinon utilisez une instance Clerk de production (voir README, « Connexion avec ChatGPT et Claude »).";
+            };
+            readonly manifest: {
+                readonly unreadableField: "champ \"{field}\" illisible dans {source} (attendu : {expected})";
+                readonly expect: {
+                    readonly string: "une chaîne non vide";
+                    readonly semver: "une version sémantique (x.y.z)";
+                    readonly object: "un objet";
+                    readonly boolean: "true ou false";
+                    readonly positiveInteger: "un entier strictement positif";
+                    readonly atLeastPerTool: "au moins le plafond perTool";
+                    readonly stringArray: "un tableau de chaînes non vides";
+                };
+            };
+            readonly toolRoles: {
+                readonly identityMissing: "les stores d'identité ne sont pas injectés (AppDeps.identity) : sur le niveau OAuth, le rôle d'un appelant est décidé pour l'organisation que la couche d'identité résout, les deux sont donc requis";
+                readonly denied: "permission refusée : votre rôle n'accorde pas l'outil {tool} ({reason})";
+                readonly unresolved: "permission refusée : votre rôle n'a pas pu être lu, aucun outil n'est accordé";
+                readonly configMissing: "{variable} n'est pas défini : sur le niveau OAuth, chaque outil est décidé par le rôle de l'appelant, lu dans ce fichier de rôles";
+                readonly configInvalid: "{variable} ({path}) n'est pas un fichier de rôles valide : {problem}";
+            };
+            readonly toolRecord: {
+                readonly unsound: "fiches d'outils ou plafond de contexte invalides : {problems}";
+            };
+            readonly pagination: {
+                readonly invalidCursor: "curseur invalide : il n'a pas été émis par cet outil ou n'est plus valide ; recommencez sans curseur";
+            };
+            readonly lake: {
+                readonly unreadable: "la source de données a renvoyé une réponse illisible pour ce serveur ; aucune ligne n'est affichée plutôt qu'une page partielle ou fausse";
+            };
+            readonly buildIdentity: {
+                readonly unreadable: "identité de build incalculable : {dir} est illisible ({reason})";
+                readonly empty: "identité de build incalculable : {dir} est vide (aucun fichier), rien n'a été construit";
+                readonly commitUnreadable: "impossible de lire le commit de build dans {file} ({reason}) : lancez npm run build, qui l'écrit (scripts/write-build-info.mjs)";
+            };
+            readonly config: {
+                readonly refused: "configuration refusée : {problems}";
+                readonly missing: "{env} est manquante (attendu : {expected})";
+                readonly invalid: "{env} est définie mais invalide (attendu : {expected} ; valeur non affichée)";
+                readonly expect: {
+                    readonly string: "une chaîne non vide";
+                    readonly integer: "un entier de {min} à {max}";
+                    readonly integerAtLeast: "un entier d'au moins {min}";
+                    readonly boolean: "\"0\" ou \"1\"";
+                    readonly url: "une URL https (http seulement sur la boucle locale)";
+                    readonly originList: "une liste d'origines séparées par des virgules (schéma://hôte[:port], sans chemin)";
+                    readonly enum: "une valeur parmi : {values}";
+                    readonly json: "un objet ou un tableau JSON";
+                };
+            };
+            readonly server: {
+                readonly instructions: "Ce serveur expose trois outils d'exemple en lecture seule.\n1. Appelez whoami d'abord. Il renvoie qui appelle sur cette connexion (null sur le niveau public et en stdio), le rôle de l'appelant et grantedTools : les outils que ce rôle peut appeler. Ne demandez jamais son identité à l'utilisateur et n'en passez jamais une en argument.\n2. ping prouve la connexion de bout en bout ; passez message pour qu'il soit renvoyé tel quel.\n3. list_items liste les éléments de l'organisation de l'appelant et les affiche dans un widget interactif quand le client prend en charge MCP Apps. Il est paginé : passez le nextCursor renvoyé pour lire la page suivante ; exhausted: true signale la dernière page. N'inventez jamais de curseur.\n4. Un résultat avec isError et structuredContent.error.code est un refus, pas un résultat vide : rate_limited (attendez retryAfterMs, puis réessayez une fois), invalid_cursor (repartez de la première page), lake_unreadable, TOOL_ROLE_DENIED ou TOOL_ROLE_UNRESOLVED (l'appelant ne peut pas utiliser cet outil). Signalez-le à l'utilisateur ; ne le lisez jamais comme « rien n'existe ».\n5. Envoyez l'en-tête X-MCP-Locale (en ou fr) pour recevoir les messages dans cette langue.";
+                readonly identityMissing: "l'identité du serveur n'a pas de {item} : définissez {variable}, ou le champ « {field} » de package.json";
+                readonly identityInvalid: "{item} de l'identité du serveur n'est pas une URL https (http sur un hôte de bouclage seulement) : {source}";
+            };
+            readonly landing: {
+                readonly pageTitle: "{title} — serveur MCP";
+                readonly intro: "Cette adresse est un serveur Model Context Protocol (MCP). Ajoutez-la à votre client IA comme serveur MCP distant :";
+                readonly claudeAi: "Claude.ai : ajoutez un connecteur personnalisé avec cette URL, puis Connecter.";
+                readonly chatgpt: "ChatGPT : ajoutez un serveur MCP personnalisé (mode développeur) avec cette URL.";
+                readonly claudeCode: "Claude Code :";
+                readonly other: "Tout autre client MCP : un serveur Streamable HTTP à l'URL ci-dessus.";
+                readonly authOauth: "Votre client ouvre ensuite une page de connexion (OAuth 2.1). Aucun jeton à copier.";
+                readonly authPublic: "Ce serveur fonctionne sans connexion : branchez-vous directement.";
+                readonly website: "Site :";
+            };
+            readonly widget: {
+                readonly description: "Affiche sous forme de liste les éléments d'exemple renvoyés par list_items, avec leur nom et leur statut ; en lecture seule, il ne fait aucune requête lui-même.";
+            };
+        };
+    };
+};
+export declare const EMBEDDED_PACKAGE_VERSION = "0.8.0";
+export declare const EMBEDDED_PACKAGE_IDENTITY: {
+    displayName: string;
+    description: string;
+    description_fr: string;
+    homepage: string;
+};

package/dist/embedded.generated.js

@@ -0,0 +1,8 @@
+// GENERATED by scripts/embed-static.mjs from src/locales/{en,fr}.json and package.json. Do not edit:
+// `node scripts/embed-static.mjs --check` refuses any difference (tests/embedded-static.test.ts).
+export const EMBEDDED_LOCALES = {
+    en: { "Mcp": { "auth": { "unauthorized": "Unauthorized", "originNotAllowed": "This origin is not allowed to call this endpoint" }, "tenant": { "permissionDenied": "permission denied: no tenant resolved for this caller" }, "person": { "identityNotConfigured": "permission denied: this tool needs the verified person, and this server resolves no person (identity is not configured)", "noVerifiedSession": "permission denied: this tool needs the verified person, and this call carries no verified session", "refused": "permission denied: the verified person behind this call could not be resolved" }, "rateLimit": { "exceeded": "too many tool calls: retry in {seconds} s" }, "validation": { "messageTooLong": "message exceeds the maximum length of 200 characters" }, "oauth": { "pickerTitle": "Connect {client}", "pickerIntro": "{client} asks to act on your behalf. Choose the organisation it may reach, then approve or deny.", "handoffTitle": "Returning to the application", "handoffLink": "Continue to the application", "pickerNoAllowedOrganisation": "None of your organisations is authorised on this server.", "pickerDestination": "After approval you are sent to:", "pickerScope": "Requested access:", "pickerUnverified": "Unverified client: it registered itself automatically and nobody has vouched for it. Approve only if you recognise the address above.", "pickerOrganisation": "Organisation", "approve": "Approve", "deny": "Deny", "denied": "The request was denied; you can close this window.", "unavailable": "Authorization is not configured on this server.", "inMemoryWarning": "Running on in-memory OAuth stores: codes and registered clients are lost on restart and not shared between instances. Fine for development; set {knob}=1 to acknowledge, or inject durable adapters.", "consentTokenRequired": "The consent token is missing: reload the page and try again.", "registryFull": "Client registration is temporarily unavailable: the registry is full. Retry later.", "devInstanceRemote": "Development Clerk instance on a remote server: its hosted sign-in page redirects only to localhost or to the instance Home URL. Set the development instance's Home URL (development origin) to this server's origin for a remote test and revert it afterwards, or use a Clerk production instance (see README, \"Sign-in with ChatGPT and Claude\")." }, "manifest": { "unreadableField": "cannot read field \"{field}\" of {source} (expected: {expected})", "expect": { "string": "a non-empty string", "semver": "a semantic version (x.y.z)", "object": "an object", "boolean": "true or false", "positiveInteger": "a positive whole number", "atLeastPerTool": "at least the perTool ceiling", "stringArray": "an array of non-empty strings" } }, "toolRoles": { "identityMissing": "the identity stores are not injected (AppDeps.identity): on the OAuth tier a caller's role is decided for the organisation the identity layer resolves, so both are required", "denied": "permission denied: your role does not grant the tool {tool} ({reason})", "unresolved": "permission denied: your role could not be read, so no tool is granted", "configMissing": "{variable} is not set: on the OAuth tier every tool is decided by the caller's role, read from that roles file", "configInvalid": "{variable} ({path}) is not a valid roles file: {problem}" }, "toolRecord": { "unsound": "tool records or the context ceiling are unsound: {problems}" }, "pagination": { "invalidCursor": "invalid cursor: it was not issued by this tool or is no longer valid; start again without a cursor" }, "lake": { "unreadable": "the data source answered something this server cannot read; no row is shown rather than a partial or wrong page" }, "buildIdentity": { "unreadable": "cannot compute the build identity: {dir} is unreadable ({reason})", "empty": "cannot compute the build identity: {dir} is empty (no file), nothing was built", "commitUnreadable": "cannot read the build commit from {file} ({reason}): run npm run build, which writes it (scripts/write-build-info.mjs)" }, "config": { "refused": "configuration refused: {problems}", "missing": "{env} is missing (expected: {expected})", "invalid": "{env} is set but invalid (expected: {expected}; value not shown)", "expect": { "string": "a non-empty string", "integer": "an integer from {min} to {max}", "integerAtLeast": "an integer of at least {min}", "boolean": "\"0\" or \"1\"", "url": "an https URL (http on loopback only)", "originList": "a comma-separated list of origins (scheme://host[:port], no path)", "enum": "one of: {values}", "json": "a JSON object or array" } }, "server": { "instructions": "This server exposes three read-only example tools.\n1. Call whoami first. It returns who is calling on this connection (null on the public tier and on stdio), the caller's role, and grantedTools: the tools that role may call. Never ask the user for their identity and never pass one as an argument.\n2. ping proves the connection end to end; pass message to have it echoed back.\n3. list_items lists the items of the caller's organisation and renders them in an interactive widget where the client supports MCP Apps. It is paged: pass the returned nextCursor to read the next page; exhausted: true means the last page. Never invent a cursor.\n4. A result with isError and structuredContent.error.code is a refusal, not an empty result: rate_limited (wait retryAfterMs, then retry once), invalid_cursor (restart from the first page), lake_unreadable, TOOL_ROLE_DENIED or TOOL_ROLE_UNRESOLVED (the caller may not use this tool). Report it to the user; never read it as \"nothing exists\".\n5. Send the X-MCP-Locale header (en or fr) to receive messages in that language.", "identityMissing": "the server identity has no {item}: set {variable}, or the \"{field}\" field of package.json", "identityInvalid": "the server identity's {item} is not an https URL (http on a loopback host only): {source}" }, "landing": { "pageTitle": "{title} — MCP server", "intro": "This address is a Model Context Protocol (MCP) server. Add it to your AI client as a remote MCP server:", "claudeAi": "Claude.ai: add a custom connector with this URL, then Connect.", "chatgpt": "ChatGPT: add a custom MCP server (developer mode) with this URL.", "claudeCode": "Claude Code:", "other": "Any other MCP client: a Streamable HTTP server at the URL above.", "authOauth": "Your client then opens a sign-in page (OAuth 2.1). There is no token to copy.", "authPublic": "This server runs without sign-in: connect directly.", "website": "Website:" }, "widget": { "description": "Shows the example items returned by list_items as a list, with their name and status; read-only, it makes no request of its own." } } },
+    fr: { "Mcp": { "auth": { "unauthorized": "Non autorisé", "originNotAllowed": "Cette origine n'est pas autorisée à appeler ce point d'accès" }, "tenant": { "permissionDenied": "permission refusée : aucun tenant résolu pour cet appelant" }, "person": { "identityNotConfigured": "permission refusée : cet outil exige la personne vérifiée, et ce serveur ne résout aucune personne (identité non configurée)", "noVerifiedSession": "permission refusée : cet outil exige la personne vérifiée, et cet appel ne porte aucune session vérifiée", "refused": "permission refusée : la personne vérifiée derrière cet appel n'a pas pu être résolue" }, "rateLimit": { "exceeded": "trop d’appels d’outils : réessayez dans {seconds} s" }, "validation": { "messageTooLong": "le message dépasse la longueur maximale de 200 caractères" }, "oauth": { "pickerTitle": "Connecter {client}", "pickerIntro": "{client} demande à agir en votre nom. Choisissez l'organisation à laquelle il peut accéder, puis approuvez ou refusez.", "handoffTitle": "Retour à l'application", "handoffLink": "Continuer vers l'application", "pickerNoAllowedOrganisation": "Aucune de vos organisations n'est autorisée sur ce serveur.", "pickerDestination": "Redirection après validation vers :", "pickerScope": "Accès demandé :", "pickerUnverified": "Client non vérifié : il s'est enregistré automatiquement et personne ne s'en porte garant. N'approuvez que si vous reconnaissez l'adresse ci-dessus.", "pickerOrganisation": "Organisation", "approve": "Approuver", "deny": "Refuser", "denied": "La demande a été refusée ; vous pouvez fermer cette fenêtre.", "unavailable": "L'autorisation n'est pas configurée sur ce serveur.", "inMemoryWarning": "Stores OAuth en mémoire : les codes et les clients enregistrés sont perdus au redémarrage et non partagés entre instances. Acceptable en développement ; définissez {knob}=1 pour l'accepter, ou injectez des adaptateurs durables.", "consentTokenRequired": "Le jeton de consentement est absent : rechargez la page et réessayez.", "registryFull": "L'enregistrement de clients est temporairement indisponible : le registre est plein. Réessayez plus tard.", "devInstanceRemote": "Instance Clerk de développement sur un serveur distant : sa page de connexion hébergée ne redirige que vers localhost ou vers l'URL d'accueil (Home URL) de l'instance. Pour un test distant, réglez l'URL d'accueil (origine de développement) de l'instance sur l'origine de ce serveur, puis rétablissez-la ; sinon utilisez une instance Clerk de production (voir README, « Connexion avec ChatGPT et Claude »)." }, "manifest": { "unreadableField": "champ \"{field}\" illisible dans {source} (attendu : {expected})", "expect": { "string": "une chaîne non vide", "semver": "une version sémantique (x.y.z)", "object": "un objet", "boolean": "true ou false", "positiveInteger": "un entier strictement positif", "atLeastPerTool": "au moins le plafond perTool", "stringArray": "un tableau de chaînes non vides" } }, "toolRoles": { "identityMissing": "les stores d'identité ne sont pas injectés (AppDeps.identity) : sur le niveau OAuth, le rôle d'un appelant est décidé pour l'organisation que la couche d'identité résout, les deux sont donc requis", "denied": "permission refusée : votre rôle n'accorde pas l'outil {tool} ({reason})", "unresolved": "permission refusée : votre rôle n'a pas pu être lu, aucun outil n'est accordé", "configMissing": "{variable} n'est pas défini : sur le niveau OAuth, chaque outil est décidé par le rôle de l'appelant, lu dans ce fichier de rôles", "configInvalid": "{variable} ({path}) n'est pas un fichier de rôles valide : {problem}" }, "toolRecord": { "unsound": "fiches d'outils ou plafond de contexte invalides : {problems}" }, "pagination": { "invalidCursor": "curseur invalide : il n'a pas été émis par cet outil ou n'est plus valide ; recommencez sans curseur" }, "lake": { "unreadable": "la source de données a renvoyé une réponse illisible pour ce serveur ; aucune ligne n'est affichée plutôt qu'une page partielle ou fausse" }, "buildIdentity": { "unreadable": "identité de build incalculable : {dir} est illisible ({reason})", "empty": "identité de build incalculable : {dir} est vide (aucun fichier), rien n'a été construit", "commitUnreadable": "impossible de lire le commit de build dans {file} ({reason}) : lancez npm run build, qui l'écrit (scripts/write-build-info.mjs)" }, "config": { "refused": "configuration refusée : {problems}", "missing": "{env} est manquante (attendu : {expected})", "invalid": "{env} est définie mais invalide (attendu : {expected} ; valeur non affichée)", "expect": { "string": "une chaîne non vide", "integer": "un entier de {min} à {max}", "integerAtLeast": "un entier d'au moins {min}", "boolean": "\"0\" ou \"1\"", "url": "une URL https (http seulement sur la boucle locale)", "originList": "une liste d'origines séparées par des virgules (schéma://hôte[:port], sans chemin)", "enum": "une valeur parmi : {values}", "json": "un objet ou un tableau JSON" } }, "server": { "instructions": "Ce serveur expose trois outils d'exemple en lecture seule.\n1. Appelez whoami d'abord. Il renvoie qui appelle sur cette connexion (null sur le niveau public et en stdio), le rôle de l'appelant et grantedTools : les outils que ce rôle peut appeler. Ne demandez jamais son identité à l'utilisateur et n'en passez jamais une en argument.\n2. ping prouve la connexion de bout en bout ; passez message pour qu'il soit renvoyé tel quel.\n3. list_items liste les éléments de l'organisation de l'appelant et les affiche dans un widget interactif quand le client prend en charge MCP Apps. Il est paginé : passez le nextCursor renvoyé pour lire la page suivante ; exhausted: true signale la dernière page. N'inventez jamais de curseur.\n4. Un résultat avec isError et structuredContent.error.code est un refus, pas un résultat vide : rate_limited (attendez retryAfterMs, puis réessayez une fois), invalid_cursor (repartez de la première page), lake_unreadable, TOOL_ROLE_DENIED ou TOOL_ROLE_UNRESOLVED (l'appelant ne peut pas utiliser cet outil). Signalez-le à l'utilisateur ; ne le lisez jamais comme « rien n'existe ».\n5. Envoyez l'en-tête X-MCP-Locale (en ou fr) pour recevoir les messages dans cette langue.", "identityMissing": "l'identité du serveur n'a pas de {item} : définissez {variable}, ou le champ « {field} » de package.json", "identityInvalid": "{item} de l'identité du serveur n'est pas une URL https (http sur un hôte de bouclage seulement) : {source}" }, "landing": { "pageTitle": "{title} — serveur MCP", "intro": "Cette adresse est un serveur Model Context Protocol (MCP). Ajoutez-la à votre client IA comme serveur MCP distant :", "claudeAi": "Claude.ai : ajoutez un connecteur personnalisé avec cette URL, puis Connecter.", "chatgpt": "ChatGPT : ajoutez un serveur MCP personnalisé (mode développeur) avec cette URL.", "claudeCode": "Claude Code :", "other": "Tout autre client MCP : un serveur Streamable HTTP à l'URL ci-dessus.", "authOauth": "Votre client ouvre ensuite une page de connexion (OAuth 2.1). Aucun jeton à copier.", "authPublic": "Ce serveur fonctionne sans connexion : branchez-vous directement.", "website": "Site :" }, "widget": { "description": "Affiche sous forme de liste les éléments d'exemple renvoyés par list_items, avec leur nom et leur statut ; en lecture seule, il ne fait aucune requête lui-même." } } },
+};
+export const EMBEDDED_PACKAGE_VERSION = "0.8.0";
+export const EMBEDDED_PACKAGE_IDENTITY = { "displayName": "MCP Boilerplate", "description": "Clonable MCP server skeleton on the official @modelcontextprotocol/server SDK v2 (protocol 2026-07-28 + 2025 legacy, stdio + stateless Streamable HTTP), with its own OAuth 2.1 authorization server (Clerk person + organisation, cloud-identity), MCP Apps UI, tenant scoping, FR/EN i18n and a declarative eval harness.", "description_fr": "Squelette de serveur MCP clonable sur le SDK officiel @modelcontextprotocol/server v2 (protocole 2026-07-28 + héritage 2025, stdio + Streamable HTTP sans état), avec son propre serveur d'autorisation OAuth 2.1 (personne + organisation Clerk, cloud-identity), UI MCP Apps, scoping tenant, i18n FR/EN et un harnais d'évaluations déclaratif.", "homepage": "https://github.com/elpiarthera/vantage-mcp-boilerplate#readme" };

package/dist/http.js

@@ -15,11 +15,13 @@ const { allowedOrigins } = loadHttpSettings();
 // settings from the environment per request — a missing value answers 503, see
 // src/oauth/settings.ts.
 const externalIssuer = Boolean(process.env.MCP_OAUTH_ISSUER && process.env.MCP_OAUTH_AUDIENCE);
+// S-50: the server card, the setup page and the icon name the public origin when it is set.
+const publicBaseUrl = process.env.PUBLIC_BASE_URL || undefined;
 const app = buildHttpApp(authMode === "oauth"
     ? externalIssuer
-        ? { authMode, auth: loadAuthConfig(), uiDomain, allowedOrigins }
-        : { authMode, authorizationServer: {}, uiDomain, allowedOrigins }
-    : { authMode, uiDomain, allowedOrigins });
+        ? { authMode, auth: loadAuthConfig(), uiDomain, allowedOrigins, publicBaseUrl }
+        : { authMode, authorizationServer: {}, uiDomain, allowedOrigins, publicBaseUrl }
+    : { authMode, uiDomain, allowedOrigins, publicBaseUrl });
 const port = Number(process.env.PORT ?? 8787);
 // Hono's fetch handler adapted onto Node's http server, with the request-body cap
 // (MCP_MAX_BODY_BYTES, default 1 MiB) enforced while the body streams in: src/nodeAdapter.ts.

package/dist/httpApp.d.ts

@@ -41,6 +41,12 @@ export interface AppDeps {
     auth?: AuthConfig;
     /** Own authorization server (R1). Takes precedence over `auth`. */
     authorizationServer?: AuthorizationServerDeps;
+    /**
+     * The public base URL (`PUBLIC_BASE_URL`, src/http.ts): the server card, the setup page and the
+     * serverInfo icon name `<base>/mcp` and `<base>/icon.svg`. Absent (development), they name the
+     * origin the request was addressed to, and those answers are sent `no-store`.
+     */
+    publicBaseUrl?: string;
     /** Dedicated sandbox origin for the MCP Apps widget (`_meta.ui.domain`). */
     uiDomain?: string;
     /**