mcp-context-card 1.2.0 → 1.3.1

package/.well-known/fafa

@@ -9,7 +9,7 @@ agent:
   name: "mcp-context-card"
   displayName: "mcp-context-card"
   vendor: "io.github.Wolfe-Jam"
-  version: "1.2.0"
+  version: "1.3.1"
   description: >-
     The essential MCP components for a project's context (AGENTS.md),
     cross-session memory, and identity — a base MCP on its own, or a

package/CHANGELOG.md

@@ -2,6 +2,55 @@
 
 All notable changes to this project. Adheres to [Semantic Versioning](https://semver.org).
 
+## 1.3.1
+
+The registry listing catches up with 1.3.0.
+
+- **`MCP_CONTEXT_CARD_ROOT` is described as it works now.** The listing
+  still said that, unset, the server reads its own bundled copies. Since
+  1.3.0 it follows the host's MCP roots, then the start directory if it has
+  an `AGENTS.md`. Hosts that install from `server.json` show this text when
+  you add the server.
+- **A display name and a website.** `title` is "MCP Context Card" (it was
+  the package name), and `websiteUrl` points at the README.
+- **`project.faf` scores 100% on the always-33 scorer** (it was 56% on
+  faf-cli 8): the enterprise slots a single npm package doesn't use are
+  marked `slotignored`, `package_manager` is `npm`, and the build, test, dev
+  and start commands are listed. CI checks it with faf-cli 8.1.0 (it was
+  pinned to 7.10.1, which counted only 21 slots).
+
+No code change.
+
+## 1.3.0
+
+Your project, with nothing to configure.
+
+- **Finds your project from the host.** With no `MCP_CONTEXT_CARD_ROOT`, a
+  local (stdio) server asks the host which project you're in, through MCP
+  roots (goose sends its session's working directory), and follows it when
+  it changes. It falls back to the directory it was started in if that has
+  an `AGENTS.md`, then to its own folder, as before. An explicit
+  `MCP_CONTEXT_CARD_ROOT` always wins; HTTP is unchanged.
+- **`list_context_sources`** reports `project: { path, from }`: which
+  project the server is reading, and how it found it.
+- **`save_context_card`** opens its reply with what it did, as a plain fact:
+  `New file:` (with one line on what the file is) or `Updated:`, and the
+  path.
+- **An empty project gets next steps, not dead ends,** on both the HTML and
+  the text card: no `AGENTS.md` yet → ask your agent to draft one
+  (`author_agents_md`, from the repo's real build and test commands); no
+  facts yet → ask it to remember something. The placeholder "MCP context
+  card" pill is gone.
+- **A project with no identity file** (no `.well-known/fafa`, no
+  `package.json`) is named after its folder on the card, not after this
+  server.
+
+- **HTML comments in `AGENTS.md` are hidden** on the card, as GitHub hides
+  them. `agents-md-facts` marks its managed block with comments, and the
+  card showed them as text. Comments inside code stay, as content.
+
+No API change. 134 tests, all green.
+
 ## 1.2.0
 
 The card reaches people in any host: inline where the host supports MCP

package/README.md

@@ -146,22 +146,25 @@ or redirected (`> card.html`, a script, CI) it writes raw HTML to stdout instead
 
 ### Wire it into a host
 
-Claude Desktop, Cursor, or any stdio host:
+goose, Claude Desktop, Cursor, or any stdio host:
 
 ```jsonc
 {
   "mcpServers": {
     "context-card": {
       "command": "npx",
-      "args": ["-y", "mcp-context-card"],
-      "env": { "MCP_CONTEXT_CARD_ROOT": "/abs/path/to/your/project" }
+      "args": ["-y", "mcp-context-card"]
     }
   }
 }
 ```
 
-`MCP_CONTEXT_CARD_ROOT` points at the directory with your `AGENTS.md`. The
-memory tools work with or without it; identity is optional. Over HTTP instead:
+No path to configure: the server asks the host which project you're in (MCP
+roots — goose sends its session's working directory), then falls back to the
+directory it was started in if that has an `AGENTS.md`. `list_context_sources`
+reports which project it picked and how. To pin one project instead, set
+`"env": { "MCP_CONTEXT_CARD_ROOT": "/abs/path/to/your/project" }`; that always
+wins. Identity is optional. Over HTTP instead:
 `PORT=8080 npx mcp-context-card`. Requires Node ≥20.
 
 If `command: "npx"` fails to spawn (`spawn npx ENOENT` — seen on Cursor, whose
@@ -232,7 +235,7 @@ over both transports:
 4. **Discovery** — `list_context_sources()`, then the same server over stateless
    HTTP with its `.well-known` routes and `GET /card`.
 
-117 tests on Linux, macOS, and Windows, coverage‑gated in CI. Two spawn a real
+134 tests on Linux, macOS, and Windows, coverage‑gated in CI. Two spawn a real
 child process and check a remembered fact survives the restart — one against
 an existing `project.fafm`, one starting from a project that has never had
 one; another checks the stdio and HTTP tool surfaces match, and another checks

package/dist/bin.d.ts

@@ -8,7 +8,7 @@ export interface Launch {
     root: string;
 }
 /** what a bare `--help` / `help` prints. */
-export declare const HELP = "mcp-context-card 1.2.0\nServe a project's context (AGENTS.md), memory, and identity over MCP.\n\nUSAGE\n  mcp-context-card                  stdio MCP server \u2014 what an MCP host spawns (default)\n  mcp-context-card --http           stateless Streamable HTTP on PORT (default 3000)\n  mcp-context-card --stdio          force stdio even when PORT is set\n  mcp-context-card card             this dir's context card \u2014 opens it in your browser\n                                    at a terminal; HTML to stdout when piped ( > f.html )\n                                      --theme light|dark   --accent #hex\n                                      --expanded (all sections open)   --stdout\n  mcp-context-card --help           this text\n  mcp-context-card --version        print version\n\nENV\n  MCP_CONTEXT_CARD_ROOT   read AGENTS.md / project.fafm / .well-known/ from here\n  PORT                    if set, run HTTP instead of stdio\n\nA bare run is an stdio server: it waits for a host to speak JSON-RPC on stdin,\nso it looks idle at a terminal. Try `card` (opens your context in a browser) or `--http`.\nhttps://github.com/Wolfe-Jam/mcp-context-card\n";
+export declare const HELP = "mcp-context-card 1.3.1\nServe a project's context (AGENTS.md), memory, and identity over MCP.\n\nUSAGE\n  mcp-context-card                  stdio MCP server \u2014 what an MCP host spawns (default)\n  mcp-context-card --http           stateless Streamable HTTP on PORT (default 3000)\n  mcp-context-card --stdio          force stdio even when PORT is set\n  mcp-context-card card             this dir's context card \u2014 opens it in your browser\n                                    at a terminal; HTML to stdout when piped ( > f.html )\n                                      --theme light|dark   --accent #hex\n                                      --expanded (all sections open)   --stdout\n  mcp-context-card --help           this text\n  mcp-context-card --version        print version\n\nENV\n  MCP_CONTEXT_CARD_ROOT   read AGENTS.md / project.fafm / .well-known/ from here\n  PORT                    if set, run HTTP instead of stdio\n\nA bare run is an stdio server: it waits for a host to speak JSON-RPC on stdin,\nso it looks idle at a terminal. Try `card` (opens your context in a browser) or `--http`.\nhttps://github.com/Wolfe-Jam/mcp-context-card\n";
 /**
  * Decide how to launch, from argv + env. Pure — so the mode matrix is unit
  * tested without spawning a process.

package/dist/bin.js

@@ -140,7 +140,12 @@ if (entryPath && import.meta.url === pathToFileURL(entryPath).href) {
         // terminal otherwise looks hung.
         console.error(`${NAME} · stdio · waiting for an MCP host on stdin  (--help for usage · Ctrl-C to exit)`);
         // stdio = a host on this machine, so save_context_card can open the card.
+        // With no MCP_CONTEXT_CARD_ROOT, find the user's project: the host's MCP
+        // roots, then the start directory. So a host needs no config to show yours.
         const { openInBrowser } = await import("./open.js");
-        await serve(new StdioServerTransport(), root, { openFile: openInBrowser });
+        await serve(new StdioServerTransport(), root, {
+            openFile: openInBrowser,
+            detectRoot: !process.env.MCP_CONTEXT_CARD_ROOT,
+        });
     }
 }

package/dist/constants.d.ts

@@ -1,7 +1,7 @@
 /** Server identity constants, in their own module so any file can import
  *  them without pulling in the whole server. */
 export declare const NAME = "mcp-context-card";
-export declare const VERSION = "1.2.0";
+export declare const VERSION = "1.3.1";
 export declare const SERVER_CARD_URI = "mcp-context-card://server-card";
 /** MCP Apps (io.modelcontextprotocol/ui): the card as an inline UI resource.
  *  A host that supports MCP Apps fetches this resource and renders it in a

package/dist/constants.js

@@ -1,7 +1,7 @@
 /** Server identity constants, in their own module so any file can import
  *  them without pulling in the whole server. */
 export const NAME = "mcp-context-card";
-export const VERSION = "1.2.0";
+export const VERSION = "1.3.1";
 export const SERVER_CARD_URI = "mcp-context-card://server-card";
 /** MCP Apps (io.modelcontextprotocol/ui): the card as an inline UI resource.
  *  A host that supports MCP Apps fetches this resource and renders it in a

package/dist/md.js

@@ -58,8 +58,70 @@ const TABLE_SEP = /^\s*\|?[\s:|-]*-[\s:|-]*\|?\s*$/;
 function tableRow(line) {
     return line.trim().replace(/^\|/, "").replace(/\|$/, "").split("|").map((c) => c.trim());
 }
+/**
+ * Drop HTML comments, as GitHub does when it renders Markdown: tools such as
+ * agents-md-facts mark their managed blocks with them. A comment may span
+ * lines. Inside a fenced block or an inline `code` span it's content, so kept.
+ */
+function stripComments(src) {
+    const out = [];
+    let inFence = null;
+    let inComment = false;
+    for (const line of src.split("\n")) {
+        if (inFence) {
+            out.push(line);
+            if (inFence.test(line))
+                inFence = null;
+            continue;
+        }
+        const fence = !inComment && line.match(FENCE);
+        if (fence) {
+            inFence = fence[2][0] === "`" ? /^\s*```+\s*$/ : /^\s*~~~+\s*$/;
+            out.push(line);
+            continue;
+        }
+        // outside code: split on inline code spans, strip comments only between them
+        let kept = "";
+        const parts = line.split(/(`+[^`]*`+)/);
+        for (let k = 0; k < parts.length; k++) {
+            let part = parts[k];
+            if (k % 2 === 1 && !inComment) {
+                kept += part;
+                continue;
+            }
+            while (part.length) {
+                if (inComment) {
+                    const end = part.indexOf("-->");
+                    if (end < 0) {
+                        part = "";
+                    }
+                    else {
+                        part = part.slice(end + 3);
+                        inComment = false;
+                    }
+                }
+                else {
+                    const start = part.indexOf("<!--");
+                    if (start < 0) {
+                        kept += part;
+                        part = "";
+                    }
+                    else {
+                        kept += part.slice(0, start);
+                        part = part.slice(start + 4);
+                        inComment = true;
+                    }
+                }
+            }
+        }
+        // a line that held only a comment disappears, rather than leaving a blank gap
+        if (kept.trim() || !line.includes("<!--") && !line.includes("-->"))
+            out.push(kept);
+    }
+    return out.join("\n");
+}
 export function renderMarkdown(src) {
-    const lines = src.replace(/\r\n/g, "\n").split("\n");
+    const lines = stripComments(src.replace(/\r\n/g, "\n")).split("\n");
     const out = [];
     let i = 0;
     const flushPara = (buf) => {

package/dist/render-card.js

@@ -10,11 +10,11 @@
  * is the expand-all / print helper (TOGGLE_SCRIPT) — a progressive enhancement;
  * every section still opens on its own without it. Renders anywhere.
  */
-import { join } from "node:path";
+import { basename, join, resolve } from "node:path";
 import { parseAgentsMd } from "./agents-md.js";
 import { parseFafm } from "./memory.js";
 import { resolveIdentity, serverCardMeta, META_NS } from "./identity.js";
-import { NAME, SERVER_CARD_URI } from "./constants.js";
+import { SERVER_CARD_URI } from "./constants.js";
 import { escapeHtml, renderInline, renderMarkdown, slug } from "./md.js";
 /** AAIF brand orange (aaif.io). The default accent. */
 export const AAIF_ACCENT = "#FF702D";
@@ -121,7 +121,7 @@ export function renderCard(root, opts = {}) {
     const mem = parseFafm(join(root, "project.fafm"));
     const id = resolveIdentity(root);
     const meta = serverCardMeta();
-    const name = id?.displayName ?? id?.name ?? NAME;
+    const name = id?.displayName ?? id?.name ?? basename(resolve(root));
     const pills = [
         id?.vendor && id.vendor !== id.status && `<span class="pill">${escapeHtml(id.vendor)}</span>`,
         id?.agentVersion && `<span class="pill">v${escapeHtml(id.agentVersion)}</span>`,
@@ -152,7 +152,7 @@ export function renderCard(root, opts = {}) {
             : ""}</div>
     ${preamble ? `<div class="ctx-preamble md">${renderMarkdown(preamble)}</div>` : ""}
     <div class="ctx-body">${sections}</div>`
-        : `<p class="none">No AGENTS.md in this project.</p>`;
+        : `<p class="none">No AGENTS.md yet. Ask your agent to draft one: <code>author_agents_md</code> builds it from this repo's real build and test commands, nothing invented.</p>`;
     // MEMORY
     const memoryBody = mem.facts.length
         ? mem.facts
@@ -164,7 +164,7 @@ export function renderCard(root, opts = {}) {
             return `<div class="fact"><p>${renderInline(f.text)}</p><div class="meta">${tags}<span class="dot${verified ? "" : " pending"}" title="${verified ? "verified" : f.verification_status ?? "unverified"}"></span></div></div>`;
         })
             .join("")
-        : `<p class="none">No facts yet.</p>`;
+        : `<p class="none">No facts yet. Ask your agent to remember something, and it lands here.</p>`;
     // DISCOVERY
     const rows = Object.entries(meta)
         .map(([k, v]) => {
@@ -184,7 +184,7 @@ export function renderCard(root, opts = {}) {
 <main class="card">
   <div class="top">
     <h1>${escapeHtml(name)}</h1>
-    <div class="pills">${pills || '<span class="pill">MCP context card</span>'}</div>
+    ${pills ? `<div class="pills">${pills}</div>` : ""}
   </div>
   <section>
     <p class="label">Context — AGENTS.md</p>
@@ -268,7 +268,7 @@ export function renderCardText(root, opts = {}) {
     const mem = parseFafm(join(root, "project.fafm"));
     const id = resolveIdentity(root);
     const meta = serverCardMeta();
-    const name = id?.displayName ?? id?.name ?? NAME;
+    const name = id?.displayName ?? id?.name ?? basename(resolve(root));
     const plural = (n, w) => `${n} ${w}${n === 1 ? "" : "s"}`;
     const out = [`### ${name} — context card`];
     const pills = [
@@ -284,7 +284,7 @@ export function renderCardText(root, opts = {}) {
     const sections = agents?.sections.filter((s) => s.level > 1) ?? [];
     out.push(agents
         ? `**Context — AGENTS.md** · ${plural(sections.length, "section")}\n${sections.map((s) => s.heading).join(" · ")}`
-        : "**Context — AGENTS.md** · none in this project");
+        : "**Context — AGENTS.md** · none yet. `author_agents_md` drafts one from this repo's real build and test commands, nothing invented.");
     const full = opts.detail === "full";
     const shown = full ? mem.facts : mem.facts.slice(0, TLDR_FACTS);
     const rest = mem.facts.length - shown.length;
@@ -292,7 +292,7 @@ export function renderCardText(root, opts = {}) {
         ? `**Memory** · ${plural(mem.facts.length, "fact")}\n${shown
             .map((f) => `- ${full ? f.text : clip(f.text, TLDR_CHARS)}${f.verification_status === "verified" ? " ✓" : ""}`)
             .join("\n")}${rest ? `\n\n…and ${plural(rest, "more fact")}, in the full card` : ""}`
-        : "**Memory** · no facts yet");
+        : "**Memory** · no facts yet. Ask your agent to remember something, and it lands here.");
     const rows = Object.entries(meta).map(([k, v]) => `| ${k.slice(META_NS.length + 1)} | \`${v.source}\` | \`${v.mediaType}\` |`);
     out.push(["**Discovery**", "| concern | source | media type |", "|---|---|---|", ...rows].join("\n"));
     return out.join("\n\n");

package/dist/server.d.ts

@@ -54,6 +54,11 @@ export interface ServerOptions {
     /** Open a saved file for the person. Set only for a local (stdio) server;
      *  over HTTP the browser would open on the server, so it stays unset. */
     openFile?: (path: string) => void;
+    /** No root was configured: find the user's project instead — the client's
+     *  MCP roots, then `cwd` if it holds an AGENTS.md, then `root`. Local only. */
+    detectRoot?: boolean;
+    /** The directory the server was started in (default: process.cwd()). */
+    cwd?: string;
 }
 export declare function createServer(root?: string, opts?: ServerOptions): Server;
 /** Connect a server instance to a transport (stdio or http). */

package/dist/server.js

@@ -16,14 +16,14 @@
  */
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
+import { CallToolRequestSchema, ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, RootsListChangedNotificationSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { existsSync, statSync, writeFileSync } from "node:fs";
+import { basename, dirname, join } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { findSection, parseAgentsMd } from "./agents-md.js";
 import { authorAgentsMd } from "./author.js";
 import { forget, parseFafm, recall, remember } from "./memory.js";
-import { identity, serverCardMeta, whoami } from "./identity.js";
+import { identity, resolveIdentity, serverCardMeta, whoami } from "./identity.js";
 import { renderCard, renderCardText, safeAccent } from "./render-card.js";
 export { NAME, VERSION, SERVER_CARD_URI } from "./constants.js";
 import { NAME, VERSION, SERVER_CARD_URI, CARD_UI_URI, MCP_APP_MIME, UI_EXTENSION } from "./constants.js";
@@ -76,10 +76,59 @@ function hostRendersApps(server) {
     return Array.isArray(ext?.mimeTypes) && ext.mimeTypes.includes(MCP_APP_MIME);
 }
 export function createServer(root = ROOT, opts = {}) {
-    const AGENTS = join(root, "AGENTS.md");
-    const FAFM = join(root, "project.fafm");
-    const FAFA = join(root, ".well-known/fafa");
     const server = new Server({ name: NAME, version: VERSION }, { capabilities: { tools: {}, resources: {} }, instructions: INSTRUCTIONS });
+    // ── Which project? ────────────────────────────────────────────────────
+    // Resolved per call, not at startup: a client's roots are only known once
+    // it has connected, and they can change (goose sends its session's working
+    // directory, and notifies when it moves).
+    let found;
+    server.setNotificationHandler(RootsListChangedNotificationSchema, async () => {
+        found = undefined;
+    });
+    const isDir = (p) => {
+        try {
+            return statSync(p).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    };
+    async function fromClientRoots() {
+        if (!server.getClientCapabilities()?.roots)
+            return undefined;
+        try {
+            const { roots } = await server.listRoots(undefined, { timeout: 5000 });
+            for (const r of roots) {
+                if (!r.uri.startsWith("file:"))
+                    continue;
+                const dir = fileURLToPath(r.uri);
+                if (isDir(dir))
+                    return dir;
+            }
+        }
+        catch {
+            // a client that declares roots but doesn't answer: fall through
+        }
+        return undefined;
+    }
+    async function project() {
+        if (!opts.detectRoot)
+            return { root, from: root === ROOT ? "package" : "configured" };
+        if (found)
+            return found;
+        const fromRoots = await fromClientRoots();
+        const cwd = opts.cwd ?? process.cwd();
+        found = fromRoots
+            ? { root: fromRoots, from: "client roots" }
+            : existsSync(join(cwd, "AGENTS.md"))
+                ? { root: cwd, from: "start directory" }
+                : { root, from: "package" };
+        return found;
+    }
+    const files = (dir) => ({
+        AGENTS: join(dir, "AGENTS.md"),
+        FAFM: join(dir, "project.fafm"),
+    });
     // ── Mechanism 1: the Server Card resource + its _meta context block ───
     server.setRequestHandler(ListResourcesRequestSchema, async () => ({
         resources: [
@@ -103,7 +152,7 @@ export function createServer(root = ROOT, opts = {}) {
             // self-contained (inline CSS, no external requests), and its one script
             // is progressive enhancement, so it still works in a strict sandbox.
             return {
-                contents: [{ uri: CARD_UI_URI, mimeType: MCP_APP_MIME, text: renderCard(root, { theme: "auto" }) }],
+                contents: [{ uri: CARD_UI_URI, mimeType: MCP_APP_MIME, text: renderCard((await project()).root, { theme: "auto" }) }],
             };
         }
         if (req.params.uri !== SERVER_CARD_URI) {
@@ -255,6 +304,8 @@ export function createServer(root = ROOT, opts = {}) {
     }));
     server.setRequestHandler(CallToolRequestSchema, async (req) => {
         const args = (req.params.arguments ?? {});
+        const { root, from } = await project();
+        const { AGENTS, FAFM } = files(root);
         switch (req.params.name) {
             case "read_agents_md": {
                 const doc = parseAgentsMd(AGENTS);
@@ -304,7 +355,7 @@ export function createServer(root = ROOT, opts = {}) {
                     const mem = parseFafm(FAFM);
                     const sections = doc?.sections.length ?? 0;
                     const facts = mem.facts.length;
-                    return text(`Showing the context card for ${NAME}: AGENTS.md with ${sections} section${sections === 1 ? "" : "s"}, ` +
+                    return text(`Showing the context card for ${resolveIdentity(root)?.name ?? basename(root)}: AGENTS.md with ${sections} section${sections === 1 ? "" : "s"}, ` +
                         `${facts} remembered fact${facts === 1 ? "" : "s"}, and this server's identity. ` +
                         "The card is displayed to the user; call read_agents_md or recall for the text itself.");
                 }
@@ -312,23 +363,30 @@ export function createServer(root = ROOT, opts = {}) {
             }
             case "save_context_card": {
                 const out = join(root, "context-card.html");
+                const existed = existsSync(out);
                 writeFileSync(out, renderCard(root, cardOptions(args)));
+                // First line, plain fact: models tend to rewrite the end of a reply, not the start.
+                const saved = existed
+                    ? `**Updated:** \`context-card.html\` in your project, at ${out}.`
+                    : `**New file:** \`context-card.html\` in your project, at ${out}. A snapshot of the context your agent reads.`;
                 // Many hosts won't follow a file:// link, so a local server opens it.
                 const raw = args.open;
                 const opened = !!opts.openFile && raw !== false && raw !== "false";
                 if (opened)
                     opts.openFile(out);
-                return text(`${renderCardText(root, { detail: args.detail === "full" ? "full" : "tldr" })}\n\n` +
+                return text(`${saved}\n\n` +
+                    `${renderCardText(root, { detail: args.detail === "full" ? "full" : "tldr" })}\n\n` +
                     "_In a host that supports MCP Apps, this card shows inline._\n\n---\n\n" +
                     (opened ? "Opened the full card in your browser.\n\n" : "") +
                     `**[Open the full card in your browser](${pathToFileURL(out).href})**\n\n` +
                     // Some hosts won't follow a file:// link; a code block gets a copy button.
-                    `Or copy this into your browser's address bar:\n\n\`\`\`\n${pathToFileURL(out).href}\n\`\`\`\n\nSaved to ${out}`);
+                    `Or copy this into your browser's address bar:\n\n\`\`\`\n${pathToFileURL(out).href}\n\`\`\``);
             }
             case "list_context_sources": {
                 const doc = parseAgentsMd(AGENTS);
                 const mem = parseFafm(FAFM);
                 return text(JSON.stringify({
+                    project: { path: root, from },
                     context: {
                         source: "AGENTS.md",
                         mediaType: "text/markdown",
@@ -375,5 +433,6 @@ export async function serve(transport, root = ROOT, opts = {}) {
 // this correct on Windows, where argv[1] is a `C:\...` path.
 if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
     const { openInBrowser } = await import("./open.js");
-    await serve(new StdioServerTransport(), ROOT, { openFile: openInBrowser });
+    const pinned = process.env.MCP_CONTEXT_CARD_ROOT;
+    await serve(new StdioServerTransport(), pinned ?? ROOT, { openFile: openInBrowser, detectRoot: !pinned });
 }

package/docs/MECHANISMS.md

@@ -29,7 +29,7 @@ Both return:
 ```jsonc
 {
   "name": "mcp-context-card",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "_meta": {
     "io.github.Wolfe-Jam.mcp-context-card/context": {
       "source": "AGENTS.md",

package/docs/WIRING.md

@@ -16,15 +16,20 @@
   "mcpServers": {
     "context-card": {
       "command": "npx",
-      "args": ["-y", "mcp-context-card"],
-      "env": { "MCP_CONTEXT_CARD_ROOT": "/abs/path/to/your/project" }
+      "args": ["-y", "mcp-context-card"]
     }
   }
 }
 ```
 
-- **`MCP_CONTEXT_CARD_ROOT`** — directory holding `AGENTS.md`, `project.fafm`, and
-  `.well-known/fafa`. Omit it and the server uses its own bundled copies.
+- **Which project.** Unset, a stdio server finds it per call: the host's first
+  MCP root (a `file://` directory), then the start directory if it holds an
+  `AGENTS.md`, then the server's own bundled copies. A `roots/list_changed`
+  notification makes the next call look again. `list_context_sources` reports
+  `project: { path, from }`.
+- **`MCP_CONTEXT_CARD_ROOT`** — pins the project: a directory holding
+  `AGENTS.md`, `project.fafm`, and `.well-known/fafa`. Always wins over roots.
+  Over HTTP there are no roots, so it's the only way to pick a project there.
 - `stdout` is the JSON‑RPC wire; logging is on `stderr`.
 - **`command: "npx"` fails to spawn on some hosts** (`spawn npx ENOENT`) — the
   host's process spawn doesn't inherit a shell `PATH` that has `npx` on it,

package/docs/card-dark.html

@@ -100,7 +100,7 @@ details.ctx-section>.md{padding:0 0 16px}
 <main class="card">
   <div class="top">
     <h1>mcp-context-card</h1>
-    <div class="pills"><span class="pill">io.github.Wolfe-Jam</span><span class="pill">v1.2.0</span><span class="pill accent">published</span><span class="pill">MIT</span></div>
+    <div class="pills"><span class="pill">io.github.Wolfe-Jam</span><span class="pill">v1.3.1</span><span class="pill accent">published</span><span class="pill">MIT</span></div>
   </div>
   <section>
     <p class="label">Context — AGENTS.md</p>

package/docs/card-light.html

@@ -100,7 +100,7 @@ details.ctx-section>.md{padding:0 0 16px}
 <main class="card">
   <div class="top">
     <h1>mcp-context-card</h1>
-    <div class="pills"><span class="pill">io.github.Wolfe-Jam</span><span class="pill">v1.2.0</span><span class="pill accent">published</span><span class="pill">MIT</span></div>
+    <div class="pills"><span class="pill">io.github.Wolfe-Jam</span><span class="pill">v1.3.1</span><span class="pill accent">published</span><span class="pill">MIT</span></div>
   </div>
   <section>
     <p class="label">Context — AGENTS.md</p>

package/docs/card.html

@@ -100,7 +100,7 @@ details.ctx-section>.md{padding:0 0 16px}
 <main class="card">
   <div class="top">
     <h1>mcp-context-card</h1>
-    <div class="pills"><span class="pill">io.github.Wolfe-Jam</span><span class="pill">v1.2.0</span><span class="pill accent">published</span><span class="pill">MIT</span></div>
+    <div class="pills"><span class="pill">io.github.Wolfe-Jam</span><span class="pill">v1.3.1</span><span class="pill accent">published</span><span class="pill">MIT</span></div>
   </div>
   <section>
     <p class="label">Context — AGENTS.md</p>

package/docs/index.html

@@ -100,7 +100,7 @@ details.ctx-section>.md{padding:0 0 16px}
 <main class="card">
   <div class="top">
     <h1>mcp-context-card</h1>
-    <div class="pills"><span class="pill">io.github.Wolfe-Jam</span><span class="pill">v1.2.0</span><span class="pill accent">published</span><span class="pill">MIT</span></div>
+    <div class="pills"><span class="pill">io.github.Wolfe-Jam</span><span class="pill">v1.3.1</span><span class="pill accent">published</span><span class="pill">MIT</span></div>
   </div>
   <section>
     <p class="label">Context — AGENTS.md</p>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-context-card",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "mcpName": "io.github.Wolfe-Jam/mcp-context-card",
   "description": "The essential MCP components for a project's context (AGENTS.md), cross-session memory, and identity — a base MCP on its own, or a drop-in extension for any existing MCP server. Discoverable through the Server Card _meta block and ai-catalog.json sibling entries.",
   "keywords": [
@@ -28,7 +28,7 @@
     "./package.json": "./package.json"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "files": [
     "dist",

package/project.faf

@@ -17,6 +17,13 @@ stack:
   connection: slotignored  # no database
   hosting: Docker / any Node host — stdio for local, stateless Streamable HTTP for remote
   cicd: GitHub Actions — typecheck + build + test:coverage + demo on 3 OSes; catalog:check + card:check on Linux
+  monorepo_tool: slotignored
+  package_manager: npm
+  workspaces: slotignored
+  admin: slotignored
+  cache: slotignored
+  search: slotignored
+  storage: slotignored
 tech_stack: [TypeScript, "@modelcontextprotocol/sdk", "agents-md-facts", hono, "@hono/node-server", yaml]
 human_context:
   who: MCP host and server implementers who want a project's AGENTS.md, memory, and identity available over MCP without inventing an ad-hoc shape for each.
@@ -26,3 +33,14 @@ human_context:
   when: "2026-08-12"
   how: TypeScript on the MCP SDK. Dual transport in src/bin.ts. The Server Card _meta block and ai-catalog.json are generated from the same three sources (AGENTS.md, project.fafm, .well-known/fafa) — a CI check fails on drift. remember/recall are real file-backed reads/writes proven across a process boundary in demo.ts and the test suite. See docs/MECHANISMS.md, docs/WIRING.md, docs/TRANSPORT.md.
 key_files: [package.json, README.md, AGENTS.md, docs/MECHANISMS.md, src/server.ts, src/identity.ts, src/render-card.ts, src/author.ts, src/agents-md.ts, src/catalog-gen.ts, src/transport/http.ts]
+monorepo:
+  packages_count: slotignored
+  build_orchestrator: slotignored
+  versioning_strategy: slotignored
+  shared_configs: slotignored
+  remote_cache: slotignored
+commands:
+  build: npm run build
+  test: npm run test
+  dev: npm run dev
+  start: npm run start

package/server.json

@@ -1,19 +1,20 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.Wolfe-Jam/mcp-context-card",
-  "title": "mcp-context-card",
+  "title": "MCP Context Card",
   "description": "MCP server for a project's context (AGENTS.md), memory, and identity — base or drop-in extension.",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "repository": {
     "url": "https://github.com/Wolfe-Jam/mcp-context-card",
     "source": "github"
   },
+  "websiteUrl": "https://github.com/Wolfe-Jam/mcp-context-card#readme",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "mcp-context-card",
-      "version": "1.2.0",
+      "version": "1.3.1",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"
@@ -21,7 +22,7 @@
       "environmentVariables": [
         {
           "name": "MCP_CONTEXT_CARD_ROOT",
-          "description": "Directory holding project.faf / project.fafm / .well-known/fafa. Omitted → the server's own bundled copies.",
+          "description": "Pins the project: a directory with AGENTS.md, project.fafm and .well-known/fafa. Unset: the host's MCP roots, then the start directory if it has an AGENTS.md.",
           "isRequired": false
         }
       ]