mcp-context-card 1.6.1 → 1.7.1

package/.well-known/ai-catalog.json

@@ -11,7 +11,7 @@
       "data": {
         "$schema": "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json",
         "name": "io.github.Wolfe-Jam/mcp-context-card",
-        "version": "1.6.1",
+        "version": "1.7.1",
         "title": "MCP Context Card",
         "description": "MCP server for a project's context (AGENTS.md), memory, and identity — base or drop-in extension.",
         "websiteUrl": "https://github.com/Wolfe-Jam/mcp-context-card",

package/.well-known/fafa

@@ -13,7 +13,7 @@ agent:
   # a deployment for your own project uses your domain.
   id: "urn:air:faf.one:agent:mcp-context-card"
   vendor: "io.github.Wolfe-Jam"
-  version: "1.6.1"
+  version: "1.7.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
@@ -23,6 +23,8 @@ agent:
   license: "MIT"
 metadata:
   cards:
+    # The card's colour: AAIF orange. Without one, a card is drawn in ink.
+    accent: "#FF702D"
     packages:
       - registryType: "npm"
         identifier: "mcp-context-card"

package/AGENTS.md

@@ -15,7 +15,7 @@ connection.
 npm ci
 ```
 
-Node 20 or newer. No other system dependencies.
+Node 22 or newer. No other system dependencies.
 
 ## Build
 

package/CHANGELOG.md

@@ -2,6 +2,42 @@
 
 All notable changes to this project. Adheres to [Semantic Versioning](https://semver.org).
 
+## 1.7.1
+
+The business card printer is now its own package.
+
+- [agent-business-card](https://www.npmjs.com/package/agent-business-card)
+  renders the business card and prints it to screen. It is a new
+  dependency. Printing a business card no longer needs an MCP server: the
+  renderer has no dependencies and runs in the browser, so any page or tool
+  can print the same business card from its own facts (an A2A Agent Card,
+  an MCP Server Card, a `.fafa`). mcp-context-card is one reader that
+  supplies them.
+- Same code, moved unchanged. The business cards are byte-identical to
+  1.7.0.
+- `renderBusinessCard`, `cardInitials`, `safeAccent` and the `BusinessCard`
+  types are still exported from `render-card`, so nothing changes for
+  callers.
+
+## 1.7.0
+
+A card's colour is the owner's.
+
+- **No colour declared = ink.** A card is drawn in its own ink, black on a
+  light card and white on a dark one, unless a colour is declared. Nothing
+  is guessed. The monogram's letter takes the card colour, so it stays
+  readable. Before, every card defaulted to the AAIF orange.
+- **The owner declares it in the `.fafa`:** `metadata.cards.accent: "#0066cc"`.
+  A colour passed in (`--accent`, `?accent`, the tools' `accent`) still
+  wins.
+- A bad value, passed or declared, is dropped and the card falls back to
+  ink. `safeAccent` now returns `undefined` for anything that isn't a hex
+  (it used to return the AAIF orange).
+- This project's own `.fafa` declares the AAIF orange, so its card looks
+  the same.
+- Docs: Node 22 or newer (README and AGENTS.md said 20; `engines` has
+  required `>=22`).
+
 ## 1.6.1
 
 The logo is the first letter.

package/README.md

@@ -119,11 +119,14 @@ remembers. `detail: "full"` lists every fact whole. The server's
 instructions tell the model to show that rather than paste the HTML into
 the chat.
 
-Light, dark, or auto; the accent defaults to the AAIF palette and takes any hex.
+Light, dark, or auto. The colour is the owner's: set it in the project's
+`.fafa` (`metadata.cards.accent: "#0066cc"`), or pass any hex with `--accent`
+or `?accent`. With none, the card is drawn in ink, black or white; no colour
+is guessed.
 This repo's own card, live: [auto](https://wolfe-jam.github.io/mcp-context-card/) ·
 [light](https://wolfe-jam.github.io/mcp-context-card/card-light.html) ·
 [dark](https://wolfe-jam.github.io/mcp-context-card/card-dark.html)
-(all in the AAIF accent shown here — pass any hex to change it).
+(in the AAIF orange its `.fafa` declares).
 
 ## Add it to your setup
 
@@ -177,7 +180,7 @@ 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.
+`PORT=8080 npx mcp-context-card`. Requires Node ≥22.
 
 HTTP mode is local by default, as the MCP transports spec asks: it binds
 `127.0.0.1`, refuses foreign browser origins with 403, and refuses DNS names
@@ -271,7 +274,7 @@ over both transports:
 4. **Discovery** — `list_context_sources()`, then the same server over stateless
    HTTP with its `.well-known` routes and `GET /card`.
 
-209 tests on Linux, macOS, and Windows, coverage‑gated in CI.
+210 tests on Linux, macOS, and Windows, coverage‑gated in CI.
 `npm run wjttc` runs the WJTTC certification suite (seven tiers, from protocol
 and Server Card conformance to stdio/HTTP parity and the shipped package). Two spawn a real
 child process and check a remembered fact survives the restart — one against
@@ -289,7 +292,7 @@ transport security against the specs, one MUST or SHOULD at a time.
 | `src/agents-md.ts` | reads and section‑splits `AGENTS.md` |
 | `src/author.ts` | `author_agents_md` — BETTER via [`agents-md-facts`](https://github.com/Wolfe-Jam/agents-md-facts), BEST when `project.faf` exists |
 | `src/md.ts` | a minimal dependency‑free Markdown → HTML renderer |
-| `src/render-card.ts` | the card — identity + `AGENTS.md` + memory + discovery, as one HTML page |
+| `src/render-card.ts` | the card — reads identity + `AGENTS.md` + memory + discovery into a card; [`agent-business-card`](https://github.com/Wolfe-Jam/agent-business-card) draws it as one HTML page |
 | `src/memory.ts` | file‑backed `remember` / `recall` / `forget` |
 | `src/identity.ts` | `whoami` (`.fafa` → `package.json` fallback) + the `_meta` block |
 | `src/server-card.ts` | the MCP Server Card (SEP-2127, schema v1) |

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.6.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)   --portrait   --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  HOST                    HTTP bind address (default 127.0.0.1, this machine\n                          only); 0.0.0.0 exposes it, e.g. in a container\n  MCP_CONTEXT_CARD_ALLOWED_HOSTS / _ALLOWED_ORIGINS\n                          comma-separated Host names / browser origins to\n                          accept besides this machine's own (reverse proxy, web app)\n  MCP_CONTEXT_CARD_PUBLISH_MEMORY=1\n                          HTTP: serve project.fafm, list it in the AI Catalog,\n                          and show its facts on an exposed /card (off: memory\n                          is session data). HTTP has no auth\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.7.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)   --portrait   --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  HOST                    HTTP bind address (default 127.0.0.1, this machine\n                          only); 0.0.0.0 exposes it, e.g. in a container\n  MCP_CONTEXT_CARD_ALLOWED_HOSTS / _ALLOWED_ORIGINS\n                          comma-separated Host names / browser origins to\n                          accept besides this machine's own (reverse proxy, web app)\n  MCP_CONTEXT_CARD_PUBLISH_MEMORY=1\n                          HTTP: serve project.fafm, list it in the AI Catalog,\n                          and show its facts on an exposed /card (off: memory\n                          is session data). HTTP has no auth\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";
 /**
  * The address the HTTP server binds: `HOST`, else 127.0.0.1. Local by default,
  * as the MCP transports spec recommends; a hosted deploy sets HOST=0.0.0.0.

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.6.1";
+export declare const VERSION = "1.7.1";
 export declare const SERVER_CARD_URI = "mcp-context-card://server-card";
 /** The server's registry identity: reverse-DNS, the same as server.json `name`.
  *  It is also `serverInfo.name`, so a Server Card never contradicts the live

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.6.1";
+export const VERSION = "1.7.1";
 export const SERVER_CARD_URI = "mcp-context-card://server-card";
 /** The server's registry identity: reverse-DNS, the same as server.json `name`.
  *  It is also `serverInfo.name`, so a Server Card never contradicts the live

package/dist/faf/parse-fafa.js

@@ -50,5 +50,6 @@ function extras(doc) {
         ...(endpoints.length ? { endpoints } : {}),
         ...(skills.length ? { skills } : {}),
         ...(packages.length ? { packages } : {}),
+        ...(typeof cards.accent === "string" && cards.accent.trim() ? { accent: cards.accent.trim() } : {}),
     };
 }

package/dist/faf/types.d.ts

@@ -48,4 +48,6 @@ export interface AgentIdentity {
         registryType: string;
         identifier: string;
     }[];
+    /** The owner's card colour (`.fafa` `metadata.cards.accent`), a hex. Validated when drawn. */
+    accent?: string;
 }

package/dist/render-card.d.ts

@@ -1,8 +1,13 @@
 import type { AgentIdentity } from "./faf/types.js";
-export type Theme = "light" | "dark" | "auto";
+import { type BusinessCard, type Theme } from "agent-business-card";
+export { cardInitials, renderBusinessCard, safeAccent } from "agent-business-card";
+export type { BusinessCard, RenderOptions, Theme } from "agent-business-card";
 export interface CardOptions {
     theme?: Theme;
-    /** CSS hex colour for the accent. Validated; invalid falls back to AAIF. */
+    /**
+     * CSS hex colour for the accent. Validated; invalid is ignored. Wins over the
+     * owner's colour; with neither, the card is drawn in ink (black or white).
+     */
     accent?: string;
     /**
      * Render every AGENTS.md section open. Default: sections collapse to their
@@ -18,58 +23,18 @@ export interface CardOptions {
     /** Business-card view. Default `landscape`; the reader can switch it too. */
     layout?: "landscape" | "portrait";
 }
-/** AAIF brand orange (aaif.io). The default accent. */
+/** AAIF brand orange (aaif.io): this project's own card colour, declared in its `.fafa`. */
 export declare const AAIF_ACCENT = "#FF702D";
-export declare function safeAccent(a?: string): string;
 /** What the front calls this thing, from where it runs: "MCP server", "A2A agent", or both. */
 export declare function cardKind(id: AgentIdentity | null): string[];
 /** The front's title line: what it is, then its version. Empty when nothing is known. */
 export declare function cardTitle(id: AgentIdentity | null): string;
-/**
- * The front's logo: the first letter of the name's first meaningful word
- * (generic words like "mcp", "server", "sdk" skipped), plus a second letter
- * only when it's obvious: a known name (github → GH, typescript → TS) or a
- * word written with two capitals (GitHub, TypeScript). Never more than two.
- */
-export declare function cardInitials(name: string): string;
 /** The front's one-liner: the first sentence of the description. */
 export declare function cardOneLiner(id: AgentIdentity | null, max?: number): string;
-/**
- * A business card, independent of where its facts came from: everything the
- * renderer draws. `readCard` builds one from a project's files; another reader
- * (an A2A Agent Card, an MCP Server Card, a person's card) can build one too,
- * and `renderBusinessCard` draws any of them the same way.
- */
-export interface BusinessCard {
-    name: string;
-    /** What it is (and its version): "MCP server · v1.5.0", or a person's role. */
-    title?: string;
-    oneLiner?: string;
-    /** Shown bottom-left on the front, e.g. the publisher domain. */
-    domain?: string;
-    /** Footer chips; `accent` highlights one (e.g. the status). Plain text. */
-    chips: {
-        text: string;
-        accent?: boolean;
-    }[];
-    /** The back's tabs, in order. `key` is [a-z0-9-]; `html` is already-safe markup. */
-    tabs: {
-        key: string;
-        label: string;
-        heading: string;
-        html: string;
-    }[];
-    /** The (i) panel, as already-safe markup. */
-    about: string;
-}
-/** How to draw a card: the owner's colour and accent, the view, and the flat (print) layout. */
-export type RenderOptions = Pick<CardOptions, "theme" | "accent" | "layout" | "expanded">;
 /** The project's card: read its files, then draw. */
 export declare function renderCard(root: string, opts?: CardOptions): string;
 /** Read a project's AGENTS.md, memory and identity into a business card. */
 export declare function readCard(root: string, opts?: Pick<CardOptions, "expanded" | "memory">): BusinessCard;
-/** Draw any business card as one self-contained HTML page. */
-export declare function renderBusinessCard(card: BusinessCard, opts?: RenderOptions): string;
 /** tl;dr: the first few facts, each cut to about a line. `full`: every fact, whole. */
 export type Detail = "tldr" | "full";
 /**

package/dist/render-card.js

@@ -16,192 +16,11 @@ import { parseFafm } from "./memory.js";
 import { resolveIdentity, serverCardMeta, META_NS } from "./identity.js";
 import { PUBLISH_MEMORY_ENV, SERVER_CARD_URI } from "./constants.js";
 import { escapeHtml, renderInline, renderMarkdown, slug } from "./md.js";
-/** AAIF brand orange (aaif.io). The default accent. */
+import { renderBusinessCard } from "agent-business-card";
+// The renderer lives in agent-business-card; these readers build the card from a project's files.
+export { cardInitials, renderBusinessCard, safeAccent } from "agent-business-card";
+/** AAIF brand orange (aaif.io): this project's own card colour, declared in its `.fafa`. */
 export const AAIF_ACCENT = "#FF702D";
-const ACCENT_OK = /^#[0-9a-fA-F]{3}(?:[0-9a-fA-F]{3}(?:[0-9a-fA-F]{2})?)?$/;
-export function safeAccent(a) {
-    return a && ACCENT_OK.test(a) ? a : AAIF_ACCENT;
-}
-const CSS = (accent) => `
-/* The page and the card are themed independently. The page follows the
-   viewer's OS. The card is the owner's choice: body[data-theme] (light | dark;
-   none = follow the OS), and the reader can switch it with the ◐ toggle (#ink). */
-:root{
-  --accent:${accent};
-  --page-bg:#f4f4f5;--page-muted:#6b6b70;--page-line:rgba(0,0,0,.09);--page-chip:rgba(0,0,0,.05);
-}
-@media (prefers-color-scheme:dark){
-  :root{--page-bg:#000;--page-muted:#9a9aa0;--page-line:rgba(255,255,255,.13);--page-chip:rgba(255,255,255,.07)}
-}
-.bcard{--card:#fff;--fg:#0a0a0a;--muted:#6b6b70;--line:rgba(0,0,0,.09);--chip:rgba(0,0,0,.05);--card-shadow:0 1px 3px rgba(0,0,0,.06),0 12px 32px rgba(0,0,0,.10)}
-body[data-theme="dark"] .bcard,
-body[data-theme="light"] #ink:checked~.stage .bcard{--card:#0d0d0d;--fg:#fafafa;--muted:#9a9aa0;--line:rgba(255,255,255,.13);--chip:rgba(255,255,255,.07);--card-shadow:0 0 0 1px rgba(255,255,255,.16),0 8px 40px color-mix(in srgb,var(--accent) 20%,transparent)}
-body[data-theme="dark"] #ink:checked~.stage .bcard{--card:#fff;--fg:#0a0a0a;--muted:#6b6b70;--line:rgba(0,0,0,.09);--chip:rgba(0,0,0,.05);--card-shadow:0 1px 3px rgba(0,0,0,.06),0 12px 32px rgba(0,0,0,.10)}
-@media (prefers-color-scheme:dark){
-  body:not([data-theme]) .bcard{--card:#0d0d0d;--fg:#fafafa;--muted:#9a9aa0;--line:rgba(255,255,255,.13);--chip:rgba(255,255,255,.07);--card-shadow:0 0 0 1px rgba(255,255,255,.16),0 8px 40px color-mix(in srgb,var(--accent) 20%,transparent)}
-  body:not([data-theme]) #ink:checked~.stage .bcard{--card:#fff;--fg:#0a0a0a;--muted:#6b6b70;--line:rgba(0,0,0,.09);--chip:rgba(0,0,0,.05);--card-shadow:0 1px 3px rgba(0,0,0,.06),0 12px 32px rgba(0,0,0,.10)}
-}
-@media (prefers-color-scheme:light){
-  body:not([data-theme]) #ink:checked~.stage .bcard{--card:#0d0d0d;--fg:#fafafa;--muted:#9a9aa0;--line:rgba(255,255,255,.13);--chip:rgba(255,255,255,.07);--card-shadow:0 0 0 1px rgba(255,255,255,.16),0 8px 40px color-mix(in srgb,var(--accent) 20%,transparent)}
-}
-.bcard{color:var(--fg)}
-*{box-sizing:border-box}
-body{margin:0;background:var(--page-bg);color:var(--page-muted);
-  font:15px/1.6 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,Helvetica,Arial,sans-serif;
-  padding:40px 16px}
-/* ── the business card: two faces, flip, two views ─────────────────── */
-.sr{position:absolute;width:1px;height:1px;margin:-1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap}
-.stage{max-width:760px;margin:0 auto}
-.views{display:flex;justify-content:flex-end;margin:0 0 10px}
-.view,.hint label{cursor:pointer}
-.view{font-size:.78rem;font-weight:600;padding:3px 11px;border-radius:20px;border:1px solid var(--page-line);
-  background:var(--page-chip);color:var(--page-muted);letter-spacing:.2em}
-.views{gap:8px}
-.view:hover,.hint label:hover{color:var(--accent);border-color:var(--accent)}
-.bcard{margin:0 auto;width:100%;aspect-ratio:7/4;perspective:1600px}
-#portrait:checked~.stage{max-width:480px}
-#portrait:checked~.stage .bcard{aspect-ratio:4/7}
-.faces{position:relative;width:100%;height:100%;transform-style:preserve-3d;transition:transform .6s ease}
-#flip:checked~.stage .faces{transform:rotateY(180deg)}
-.face{position:absolute;inset:0;background:var(--card);border:1px solid var(--line);border-radius:16px;
-  box-shadow:var(--card-shadow);backface-visibility:hidden;-webkit-backface-visibility:hidden;overflow:hidden}
-.back{transform:rotateY(180deg) translateZ(1px);display:flex;flex-direction:column}
-/* The face turned away takes no pointer or wheel events, so the visible face
-   scrolls (a hidden backface can still win hit-testing, notably in Chrome/Safari on macOS). */
-#flip:checked~.stage .front,#flip:not(:checked)~.stage .back{pointer-events:none;visibility:hidden;transition:visibility 0s .3s}
-#flip:checked~.stage .back,#flip:not(:checked)~.stage .front{visibility:visible;transition:visibility 0s .3s}
-.panes{overscroll-behavior:contain;-webkit-overflow-scrolling:touch}
-.front{display:flex;flex-direction:column;justify-content:center;padding:34px 44px;
-  border-top:5px solid var(--accent);
-  background:linear-gradient(135deg,color-mix(in srgb,var(--accent) 10%,var(--card)) 0%,var(--card) 55%)}
-.front .id{max-width:34em}
-h1{margin:0;font-size:2.1rem;line-height:1.15;letter-spacing:-.025em}
-.title{margin:8px 0 0;font-size:.82rem;font-weight:700;letter-spacing:.14em;text-transform:uppercase;color:var(--accent)}
-.oneliner{margin:16px 0 0;font-size:1.05rem;color:var(--muted);line-height:1.5}
-.foot-front{position:absolute;left:44px;right:130px;bottom:22px;display:flex;flex-wrap:wrap;align-items:center;gap:6px 12px}
-.domain{font:.8rem ui-monospace,SFMono-Regular,Menlo,monospace;color:var(--muted)}
-.corner{position:absolute;width:30px;height:30px;border-radius:50%;display:grid;place-items:center;
-  cursor:pointer;font-weight:700;font-size:.9rem;color:var(--muted);background:var(--chip);border:1px solid var(--line);z-index:4}
-.corner:hover{color:var(--accent);border-color:var(--accent)}
-.corner.tr{top:16px;right:16px;font-family:Georgia,serif;font-style:italic}
-.logo{position:absolute;top:34px;left:44px;width:84px;height:84px;border-radius:50%;display:grid;place-items:center;
-  color:#fff;font-weight:800;font-size:2rem;letter-spacing:-.02em;line-height:1;
-  background:radial-gradient(circle at 30% 25%,color-mix(in srgb,var(--accent) 80%,#fff),var(--accent) 45%,color-mix(in srgb,var(--accent) 50%,#000));
-  box-shadow:0 0 0 3px var(--card),0 0 0 4px color-mix(in srgb,var(--accent) 45%,transparent),0 6px 20px color-mix(in srgb,var(--accent) 30%,transparent)}
-.front .id{margin-top:70px}
-.corner.br{bottom:16px;right:16px}
-.flipbtn{position:absolute;right:18px;bottom:16px;z-index:4;cursor:pointer;width:42px;height:42px;border-radius:50%;
-  display:grid;place-items:center;color:var(--fg);background:transparent;box-shadow:inset 0 0 0 2px var(--fg);
-  transition:transform .2s ease}
-.flipbtn span{font-size:1.3rem;line-height:1;font-weight:700}
-
-/* the back's button: same spot and outline as the front's; ↺ instead of ↻. Over
-   scrolling text it takes the card's colour, so the arrow stays readable. */
-.flipbtn.back-btn{background:var(--card)}
-/* fast tooltip: shows at once on hover or keyboard focus (a title tooltip waits ~1 s) */
-.flipbtn[data-tip]::after{content:attr(data-tip);position:absolute;right:0;bottom:calc(100% + 8px);white-space:nowrap;
-  font:600 .74rem/1 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serif;letter-spacing:0;padding:6px 9px;border-radius:7px;
-  color:var(--card);background:var(--fg);opacity:0;transform:translateY(3px);pointer-events:none;transition:opacity .08s,transform .08s}
-.flipbtn[data-tip]:hover::after,#flip:focus-visible~.stage .flipbtn[data-tip]::after{opacity:1;transform:none}
-.flipbtn:hover{transform:none}.flipbtn:hover span{transform:rotate(-25deg)}.flipbtn span{transition:transform .2s ease}
-.whatis{position:absolute;top:16px;right:16px;z-index:5}
-.whatis>summary{position:static;list-style:none}
-.whatis>summary::-webkit-details-marker{display:none}
-.whatis[open]>summary{color:var(--accent);border-color:var(--accent)}
-.whatis-panel{position:absolute;right:0;top:38px;width:min(320px,70vw);padding:14px 16px;border-radius:12px;
-  background:var(--card);border:1px solid var(--line);box-shadow:var(--card-shadow);font-size:.84rem;line-height:1.5}
-.whatis-panel p{margin:0 0 8px}.whatis-head{font-weight:800;color:var(--accent);letter-spacing:-.01em;font-size:.95rem}
-.whatis-foot{color:var(--muted);margin:0!important}.whatis-panel code{font:.86em ui-monospace,SFMono-Regular,Menlo,monospace}
-.tabbar{display:flex;flex-wrap:wrap;gap:4px;padding:14px 60px 0 18px;border-bottom:1px solid var(--line);border-top:5px solid var(--accent)}
-.tabbar label{cursor:pointer;font-size:.8rem;font-weight:600;color:var(--muted);padding:6px 11px;border-radius:8px 8px 0 0}
-.tabbar label:hover{color:var(--fg)}
-.panes{flex:1;overflow:auto;padding:20px 26px 72px}
-.pane{display:none}
-.lead{margin:0 0 14px;font-size:1rem;line-height:1.6}
-.kv{border-collapse:collapse;font-size:.86rem;width:100%}
-.kv th{text-align:left;font-weight:600;color:var(--muted);padding:6px 14px 6px 0;white-space:nowrap;vertical-align:top}
-.kv td{padding:6px 0;border-bottom:1px solid var(--line)}
-.kv code,.lead code{font:.86em ui-monospace,SFMono-Regular,Menlo,monospace}
-.hint{text-align:center;color:var(--page-muted);font-size:.78rem;margin:14px 0 0}
-.hint label{color:var(--accent)}
-#flip:focus-visible~.stage .flipbtn,#portrait:focus-visible~.stage .view[for=portrait],#ink:focus-visible~.stage .view[for=ink]{outline:2px solid var(--accent);outline-offset:2px}
-@media (max-width:640px){
-  .bcard,#portrait:checked~.stage .bcard{aspect-ratio:auto;height:min(78vh,720px)}
-  .front{padding:28px 26px}.foot-front{left:26px}
-  .logo{top:24px;left:26px;width:64px;height:64px;font-size:1.5rem}.front .id{margin-top:56px}
-  h1{font-size:1.7rem}
-}
-/* flat: expanded render and print — both faces, every tab, no flip */
-.flat .faces,.flat .face{position:static;transform:none!important;height:auto}
-.flat .bcard{aspect-ratio:auto;perspective:none}
-.flat .face{margin:0 0 18px}.flat .front{min-height:260px;position:relative}
-.flat .pane{display:block;margin:0 0 22px}.flat .bcard{color:var(--fg)}.flat .tabbar,.flat .views,.flat .hint,.flat .corner,.flat .flipbtn,.flat .whatis{display:none}
-.flat .panes{overflow:visible}
-@media print{
-  .faces,.face{position:static!important;transform:none!important;height:auto!important}
-  .bcard{aspect-ratio:auto!important}.face{margin:0 0 18px;box-shadow:none}
-  .pane{display:block!important;margin:0 0 22px}.tabbar,.views,.hint,.corner,.flipbtn,.whatis{display:none!important}
-  .panes{overflow:visible}
-}
-.pills{display:flex;flex-wrap:wrap;gap:6px}
-.pill{font-size:.74rem;font-weight:600;padding:3px 9px;border-radius:20px;background:var(--chip);color:var(--muted)}
-.pill.accent{background:color-mix(in srgb,var(--accent) 16%,transparent);color:var(--accent)}
-.label{font-size:.7rem;font-weight:700;letter-spacing:.16em;text-transform:uppercase;
-  color:var(--accent);margin:0 0 14px}
-.toc{display:flex;flex-wrap:wrap;gap:6px 14px;margin:0;padding:0;list-style:none}
-.toc a{font-size:.82rem;color:var(--muted);text-decoration:none}
-.toc a:hover{color:var(--accent)}
-/* ── collapsible context ─────────────────────────────────────────── */
-.ctx-nav{position:sticky;top:-20px;z-index:3;background:var(--card);
-  margin:0 -26px 16px;padding:11px 26px;border-bottom:1px solid var(--line);
-  display:flex;flex-wrap:wrap;align-items:flex-start;gap:8px 16px}
-.xall{margin-left:auto;flex:none;font:inherit;font-size:.76rem;font-weight:600;
-  white-space:nowrap;padding:3px 11px;border-radius:20px;border:1px solid var(--line);
-  background:var(--chip);color:var(--muted);cursor:pointer}
-.xall:hover{color:var(--accent);border-color:var(--accent)}
-.ctx-preamble{padding-bottom:4px}
-details.ctx-section{border-top:1px solid var(--line)}
-details.ctx-section>summary{cursor:pointer;list-style:none;padding:11px 0;
-  font-weight:600;font-size:1rem;letter-spacing:-.01em;display:flex;gap:9px}
-details.ctx-section>summary::-webkit-details-marker{display:none}
-details.ctx-section>summary::before{content:"›";color:var(--accent);font-weight:700;
-  transition:transform .15s ease}
-details.ctx-section[open]>summary::before{transform:rotate(90deg)}
-details.ctx-section>.md{padding:0 0 16px}
-@media print{
-  .ctx-nav{display:none}
-  details.ctx-section:not([open])>.md{display:block!important}
-  details.ctx-section>summary::before{content:""}
-}
-.md h1,.md h2,.md h3,.md h4{margin:22px 0 8px;font-size:1rem;letter-spacing:-.01em}
-.md h1{font-size:1.15rem}
-.md p{margin:8px 0}
-.md ul,.md ol{margin:8px 0;padding-left:22px}
-.md li{margin:3px 0}
-.md code{background:var(--chip);padding:1px 5px;border-radius:5px;
-  font:.86em ui-monospace,SFMono-Regular,Menlo,monospace}
-.md pre{background:var(--chip);padding:14px 16px;border-radius:9px;overflow:auto}
-.md pre code{background:none;padding:0}
-.md table{border-collapse:collapse;width:100%;margin:12px 0;font-size:.88rem;display:block;overflow:auto}
-.md th,.md td{border:1px solid var(--line);padding:6px 10px;text-align:left}
-.md blockquote{margin:10px 0;padding-left:14px;border-left:3px solid var(--line);color:var(--muted)}
-.md a{color:var(--accent)}
-.fact{padding:12px 0;border-bottom:1px solid var(--line)}
-.fact:last-child{border-bottom:0}
-.fact p{margin:0 0 7px}
-.meta{display:flex;flex-wrap:wrap;gap:6px;align-items:center}
-.tag{font-size:.72rem;padding:2px 8px;border-radius:5px;background:var(--chip);color:var(--muted)}
-.dot{width:7px;height:7px;border-radius:50%;background:var(--accent);display:inline-block}
-.dot.pending{background:var(--muted)}
-.disc{width:100%;border-collapse:collapse;font-size:.84rem}
-.disc th,.disc td{text-align:left;padding:6px 10px;border-bottom:1px solid var(--line)}
-.disc th{color:var(--muted);font-weight:600}
-.disc code{font:.86em ui-monospace,SFMono-Regular,Menlo,monospace;color:var(--muted)}
-.fetch{margin:14px 0 0;font-size:.82rem;color:var(--muted)}
-.fetch code{background:var(--chip);padding:1px 5px;border-radius:5px}
-.none{color:var(--muted);font-style:italic}
-`;
-const htmlAttr = (theme) => theme === "auto" ? "" : ` data-theme="${theme}"`;
 /** What the front calls this thing, from where it runs: "MCP server", "A2A agent", or both. */
 export function cardKind(id) {
     const kinds = [];
@@ -216,28 +35,6 @@ export function cardKind(id) {
 export function cardTitle(id) {
     return [cardKind(id).join(" · "), id?.agentVersion ? `v${id.agentVersion}` : ""].filter(Boolean).join(" · ");
 }
-/** The front's logo: the first letters of the name's first two words ("mcp-context-card" → "MC"). */
-/** Words that say what kind of thing it is, not whose: never the logo ("mcp-context-card" → C, not M). */
-const GENERIC_WORDS = new Set(["mcp", "server", "servers", "sdk", "agent", "agents", "api", "cli", "app", "tool", "tools", "plugin", "core", "the"]);
-/** Names whose two-letter mark is obvious. */
-const OBVIOUS_MARKS = { github: "GH", gitlab: "GL", typescript: "TS", javascript: "JS" };
-/**
- * The front's logo: the first letter of the name's first meaningful word
- * (generic words like "mcp", "server", "sdk" skipped), plus a second letter
- * only when it's obvious: a known name (github → GH, typescript → TS) or a
- * word written with two capitals (GitHub, TypeScript). Never more than two.
- */
-export function cardInitials(name) {
-    const words = name.split(/[^\p{L}\p{N}]+/u).filter(Boolean);
-    const first = words.find((w) => !GENERIC_WORDS.has(w.toLowerCase())) ?? words[0] ?? "";
-    const known = OBVIOUS_MARKS[first.toLowerCase()];
-    if (known)
-        return known;
-    const capitals = first.match(/\p{Lu}/gu) ?? [];
-    if (capitals.length === 2 && /^\p{Lu}/u.test(first) && /\p{Ll}/u.test(first))
-        return capitals.join("");
-    return (Array.from(first)[0] ?? "").toUpperCase();
-}
 /** The front's one-liner: the first sentence of the description. */
 export function cardOneLiner(id, max = 140) {
     const d = id?.description;
@@ -368,112 +165,9 @@ export function readCard(root, opts = {}) {
         chips,
         tabs: tabs.map(([key, label, heading, html]) => ({ key, label, heading, html })),
         about: AGENT_ABOUT,
+        ...(id?.accent ? { accent: id.accent } : {}),
     };
 }
-/** Draw any business card as one self-contained HTML page. */
-export function renderBusinessCard(card, opts = {}) {
-    const theme = opts.theme ?? "auto";
-    const accent = safeAccent(opts.accent);
-    const portrait = opts.layout === "portrait";
-    const flat = !!opts.expanded;
-    const { name, title, oneLiner, domain } = card;
-    const tabs = card.tabs.map((t) => ({ ...t, key: t.key.replace(/[^a-z0-9-]/gi, "").toLowerCase() || "tab" }));
-    const pills = card.chips
-        .map((c) => `<span class="pill${c.accent ? " accent" : ""}">${escapeHtml(c.text)}</span>`)
-        .join("");
-    const radios = tabs
-        .map((t, i) => `<input type="radio" name="tab" id="t-${t.key}" class="sr"${i === 0 ? " checked" : ""}>`)
-        .join("");
-    const tabbar = tabs.map((t) => `<label for="t-${t.key}">${escapeHtml(t.label)}</label>`).join("");
-    const panes = tabs
-        .map((t) => `<div class="pane p-${t.key}"><p class="label">${escapeHtml(t.heading)}</p>${t.html}</div>`)
-        .join("");
-    // One CSS rule pair per tab: its pane shows, its label lights, when its radio is checked.
-    const tabCss = tabs
-        .map((t) => `#t-${t.key}:checked~.panes .p-${t.key}{display:block}#t-${t.key}:checked~.tabbar label[for=t-${t.key}]{color:var(--accent);background:var(--chip)}`)
-        .join("");
-    // The (i) panel: the same control, in the same spot, on both faces.
-    const WHATIS = `<details class="whatis">
-          <summary class="corner tr" title="About this card" aria-label="About this card">i</summary>
-          <div class="whatis-panel">
-            ${card.about}
-          </div>
-        </details>`;
-    return `<!doctype html>
-<html lang="en">
-<head>
-<meta charset="utf-8">
-<meta name="viewport" content="width=device-width,initial-scale=1">
-<title>${escapeHtml(name)} — business card</title>
-<style>${CSS(accent)}${tabCss}</style>
-</head>
-<body${flat ? ` class="flat"` : ""}${htmlAttr(theme)}>
-<input type="checkbox" id="flip" class="sr" aria-label="Flip the card">
-<input type="checkbox" id="ink" class="sr" aria-label="Switch the card between light and dark">
-<input type="checkbox" id="portrait" class="sr" aria-label="Portrait view"${portrait ? " checked" : ""}>
-<div class="stage">
-  <div class="views"><label for="ink" class="view" title="Card: light or dark">◐</label><label for="portrait" class="view" title="Landscape or portrait">▭ ▯</label></div>
-  <main class="bcard">
-    <div class="faces">
-      <section class="face front">
-        <div class="logo" aria-hidden="true">${escapeHtml(cardInitials(name))}</div>
-        ${WHATIS}
-        <div class="id">
-          <h1>${escapeHtml(name)}</h1>
-          ${title ? `<p class="title">${escapeHtml(title)}</p>` : ""}
-          ${oneLiner ? `<p class="oneliner">${escapeHtml(oneLiner)}</p>` : ""}
-        </div>
-        <div class="foot-front">${domain ? `<span class="domain">${escapeHtml(domain)}</span>` : ""}${pills ? `<div class="pills">${pills}</div>` : ""}</div>
-        <label for="flip" class="flipbtn" data-tip="Flip the card" aria-label="Flip the card"><span aria-hidden="true">↻</span></label>
-      </section>
-      <section class="face back">
-        ${radios}
-        ${WHATIS}
-        <div class="tabbar">${tabbar}</div>
-        <div class="panes">${panes}</div>
-        <label for="flip" class="flipbtn back-btn" data-tip="Flip back" aria-label="Flip back"><span aria-hidden="true">↺</span></label>
-      </section>
-    </div>
-  </main>
-  <p class="hint">${escapeHtml(name)} · business card · <label for="flip">flip it over</label></p>
-</div>
-${CARD_SCRIPT}
-</body>
-</html>
-`;
-}
-/**
- * The card's only script — a progressive enhancement. Flip, tabs and the view
- * toggle are CSS (checkbox and radio inputs) and work without it. It adds:
- * Expand all / Collapse all for the context sections, opening the section a
- * `#hash` names (flipping to the back and its Context tab first), and opening
- * every section for printing (browsers disagree on printing a closed
- * `<details>`).
- */
-const CARD_SCRIPT = `<script>
-(function(){
-  var secs=[].slice.call(document.querySelectorAll("details.ctx-section"));
-  var btn=document.querySelector(".xall");
-  var sync=function(){if(btn)btn.textContent=secs.every(function(d){return d.open})?"Collapse all":"Expand all"};
-  if(btn&&secs.length){
-    btn.hidden=false;
-    btn.addEventListener("click",function(){var open=!secs.every(function(d){return d.open});secs.forEach(function(d){d.open=open});sync()});
-    secs.forEach(function(d){d.addEventListener("toggle",sync)});
-  }
-  var openHash=function(){
-    var d=document.getElementById(decodeURIComponent(location.hash.slice(1)));
-    if(!d||d.tagName!=="DETAILS")return;
-    var f=document.getElementById("flip"),t=document.getElementById("t-context");
-    if(f)f.checked=true;if(t)t.checked=true;d.open=true;sync();
-    setTimeout(function(){d.scrollIntoView({block:"nearest"})},620);
-  };
-  addEventListener("hashchange",openHash);openHash();
-  var pre=[];
-  addEventListener("beforeprint",function(){pre=secs.map(function(d){return d.open});secs.forEach(function(d){d.open=true})});
-  addEventListener("afterprint",function(){secs.forEach(function(d,i){d.open=pre[i]});sync()});
-  sync();
-})();
-</script>`;
 const TLDR_FACTS = 5;
 const TLDR_CHARS = 160;
 /**

package/dist/server.js

@@ -62,7 +62,7 @@ function cardOptions(args) {
 }
 const CARD_ARGS = {
     theme: { type: "string", enum: ["light", "dark", "auto"], description: "default: auto" },
-    accent: { type: "string", description: "CSS hex colour, e.g. #FF702D (default: the AAIF palette)" },
+    accent: { type: "string", description: "CSS hex colour, e.g. #0066cc (default: the .fafa metadata.cards.accent, else black/white ink)" },
     expanded: { type: "boolean", description: "render every AGENTS.md section open (default: collapsed)" },
     layout: { type: "string", enum: ["landscape", "portrait"], description: "business-card view (default: landscape)" },
 };

package/docs/MECHANISMS.md

@@ -32,7 +32,7 @@ Streamable HTTP endpoint at `<origin>/mcp` and its protocol versions):
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json",
   "name": "io.github.Wolfe-Jam/mcp-context-card",
-  "version": "1.6.1",
+  "version": "1.7.1",
   "title": "MCP Context Card",
   "description": "MCP server for a project's context (AGENTS.md), memory, and identity — base or drop-in extension.",
   "websiteUrl": "https://github.com/Wolfe-Jam/mcp-context-card",
@@ -85,7 +85,7 @@ publisher lists artifacts, each entry keyed by its **media type** (`type`).
 GET /.well-known/ai-catalog.json
 ```
 
-Served from `https://ctx.example.com` (1.6.1, this repo's own files):
+Served from `https://ctx.example.com` (1.7.1, this repo's own files):
 
 ```jsonc
 {

package/docs/card-dark.html

@@ -205,7 +205,7 @@ details.ctx-section>.md{padding:0 0 16px}
         </details>
         <div class="id">
           <h1>mcp-context-card</h1>
-          <p class="title">MCP server · v1.6.1</p>
+          <p class="title">MCP server · v1.7.1</p>
           <p class="oneliner">The essential MCP components for a project's context (AGENTS.md), cross-session memory, and identity</p>
         </div>
         <div class="foot-front"><span class="domain">faf.one</span><div class="pills"><span class="pill">io.github.Wolfe-Jam</span><span class="pill accent">published</span><span class="pill">MIT</span></div></div>
@@ -223,11 +223,11 @@ details.ctx-section>.md{padding:0 0 16px}
           </div>
         </details>
         <div class="tabbar"><label for="t-about">About</label><label for="t-context">Context</label><label for="t-memory">Memory</label><label for="t-discovery">Discovery</label></div>
-        <div class="panes"><div class="pane p-about"><p class="label">About</p><p class="lead">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 a self-published ai-catalog.json.</p><table class="kv"><tbody><tr><th>Agent ID</th><td><code>urn:air:faf.one:agent:mcp-context-card</code></td></tr><tr><th>Publisher</th><td>io.github.Wolfe-Jam</td></tr><tr><th>Version</th><td>v1.6.1</td></tr><tr><th>Status</th><td>published</td></tr><tr><th>License</th><td>MIT</td></tr><tr><th>Package (npm)</th><td><code>mcp-context-card</code></td></tr></tbody></table></div><div class="pane p-context"><p class="label">Context — AGENTS.md</p><div class="ctx-nav"><ul class="toc"><li><a href="#setup">Setup</a></li><li><a href="#build">Build</a></li><li><a href="#test">Test</a></li><li><a href="#layout">Layout</a></li><li><a href="#conventions">Conventions</a></li><li><a href="#the-invariant">The invariant</a></li><li><a href="#safety">Safety</a></li><li><a href="#definition-of-done">Definition of done</a></li><li><a href="#authoring-this-file">Authoring this file</a></li></ul><button type="button" class="xall" hidden>Expand all</button></div>
+        <div class="panes"><div class="pane p-about"><p class="label">About</p><p class="lead">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 a self-published ai-catalog.json.</p><table class="kv"><tbody><tr><th>Agent ID</th><td><code>urn:air:faf.one:agent:mcp-context-card</code></td></tr><tr><th>Publisher</th><td>io.github.Wolfe-Jam</td></tr><tr><th>Version</th><td>v1.7.1</td></tr><tr><th>Status</th><td>published</td></tr><tr><th>License</th><td>MIT</td></tr><tr><th>Package (npm)</th><td><code>mcp-context-card</code></td></tr></tbody></table></div><div class="pane p-context"><p class="label">Context — AGENTS.md</p><div class="ctx-nav"><ul class="toc"><li><a href="#setup">Setup</a></li><li><a href="#build">Build</a></li><li><a href="#test">Test</a></li><li><a href="#layout">Layout</a></li><li><a href="#conventions">Conventions</a></li><li><a href="#the-invariant">The invariant</a></li><li><a href="#safety">Safety</a></li><li><a href="#definition-of-done">Definition of done</a></li><li><a href="#authoring-this-file">Authoring this file</a></li></ul><button type="button" class="xall" hidden>Expand all</button></div>
     <div class="ctx-preamble md"><p><code>mcp-context-card</code> is the essential MCP server for a project's <strong>context</strong> (this file), <strong>memory</strong>, and <strong>identity</strong> — usable as your base MCP, or dropped into any existing MCP server as an extension. Discoverable to any MCP client through the two surfaces already in the ecosystem: the Server Card <code>_meta</code> block and <code>ai-catalog.json</code> sibling entries.</p>
 <p><code>read_agents_md</code> serves this file, section by section, over the same MCP connection.</p></div>
     <div class="ctx-body"><details class="ctx-section" id="setup"><summary>Setup</summary><div class="md"><pre><code class="language-bash">npm ci</code></pre>
-<p>Node 20 or newer. No other system dependencies.</p></div></details><details class="ctx-section" id="build"><summary>Build</summary><div class="md"><pre><code class="language-bash">npm run build       # tsc -p tsconfig.build.json  →  dist/
+<p>Node 22 or newer. No other system dependencies.</p></div></details><details class="ctx-section" id="build"><summary>Build</summary><div class="md"><pre><code class="language-bash">npm run build       # tsc -p tsconfig.build.json  →  dist/
 npm run typecheck   # tsc --noEmit over src/ + test/</code></pre></div></details><details class="ctx-section" id="test"><summary>Test</summary><div class="md"><pre><code class="language-bash">npm test              # node:test — every test/*.test.ts
 npm run test:coverage # + the coverage gate (lines 90 / funcs 85 / branches 80, src/ only)
 npm run demo          # end to end: all tools over stdio, then over stateless HTTP

package/docs/card-light.html

@@ -205,7 +205,7 @@ details.ctx-section>.md{padding:0 0 16px}
         </details>
         <div class="id">
           <h1>mcp-context-card</h1>
-          <p class="title">MCP server · v1.6.1</p>
+          <p class="title">MCP server · v1.7.1</p>
           <p class="oneliner">The essential MCP components for a project's context (AGENTS.md), cross-session memory, and identity</p>
         </div>
         <div class="foot-front"><span class="domain">faf.one</span><div class="pills"><span class="pill">io.github.Wolfe-Jam</span><span class="pill accent">published</span><span class="pill">MIT</span></div></div>
@@ -223,11 +223,11 @@ details.ctx-section>.md{padding:0 0 16px}
           </div>
         </details>
         <div class="tabbar"><label for="t-about">About</label><label for="t-context">Context</label><label for="t-memory">Memory</label><label for="t-discovery">Discovery</label></div>
-        <div class="panes"><div class="pane p-about"><p class="label">About</p><p class="lead">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 a self-published ai-catalog.json.</p><table class="kv"><tbody><tr><th>Agent ID</th><td><code>urn:air:faf.one:agent:mcp-context-card</code></td></tr><tr><th>Publisher</th><td>io.github.Wolfe-Jam</td></tr><tr><th>Version</th><td>v1.6.1</td></tr><tr><th>Status</th><td>published</td></tr><tr><th>License</th><td>MIT</td></tr><tr><th>Package (npm)</th><td><code>mcp-context-card</code></td></tr></tbody></table></div><div class="pane p-context"><p class="label">Context — AGENTS.md</p><div class="ctx-nav"><ul class="toc"><li><a href="#setup">Setup</a></li><li><a href="#build">Build</a></li><li><a href="#test">Test</a></li><li><a href="#layout">Layout</a></li><li><a href="#conventions">Conventions</a></li><li><a href="#the-invariant">The invariant</a></li><li><a href="#safety">Safety</a></li><li><a href="#definition-of-done">Definition of done</a></li><li><a href="#authoring-this-file">Authoring this file</a></li></ul><button type="button" class="xall" hidden>Expand all</button></div>
+        <div class="panes"><div class="pane p-about"><p class="label">About</p><p class="lead">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 a self-published ai-catalog.json.</p><table class="kv"><tbody><tr><th>Agent ID</th><td><code>urn:air:faf.one:agent:mcp-context-card</code></td></tr><tr><th>Publisher</th><td>io.github.Wolfe-Jam</td></tr><tr><th>Version</th><td>v1.7.1</td></tr><tr><th>Status</th><td>published</td></tr><tr><th>License</th><td>MIT</td></tr><tr><th>Package (npm)</th><td><code>mcp-context-card</code></td></tr></tbody></table></div><div class="pane p-context"><p class="label">Context — AGENTS.md</p><div class="ctx-nav"><ul class="toc"><li><a href="#setup">Setup</a></li><li><a href="#build">Build</a></li><li><a href="#test">Test</a></li><li><a href="#layout">Layout</a></li><li><a href="#conventions">Conventions</a></li><li><a href="#the-invariant">The invariant</a></li><li><a href="#safety">Safety</a></li><li><a href="#definition-of-done">Definition of done</a></li><li><a href="#authoring-this-file">Authoring this file</a></li></ul><button type="button" class="xall" hidden>Expand all</button></div>
     <div class="ctx-preamble md"><p><code>mcp-context-card</code> is the essential MCP server for a project's <strong>context</strong> (this file), <strong>memory</strong>, and <strong>identity</strong> — usable as your base MCP, or dropped into any existing MCP server as an extension. Discoverable to any MCP client through the two surfaces already in the ecosystem: the Server Card <code>_meta</code> block and <code>ai-catalog.json</code> sibling entries.</p>
 <p><code>read_agents_md</code> serves this file, section by section, over the same MCP connection.</p></div>
     <div class="ctx-body"><details class="ctx-section" id="setup"><summary>Setup</summary><div class="md"><pre><code class="language-bash">npm ci</code></pre>
-<p>Node 20 or newer. No other system dependencies.</p></div></details><details class="ctx-section" id="build"><summary>Build</summary><div class="md"><pre><code class="language-bash">npm run build       # tsc -p tsconfig.build.json  →  dist/
+<p>Node 22 or newer. No other system dependencies.</p></div></details><details class="ctx-section" id="build"><summary>Build</summary><div class="md"><pre><code class="language-bash">npm run build       # tsc -p tsconfig.build.json  →  dist/
 npm run typecheck   # tsc --noEmit over src/ + test/</code></pre></div></details><details class="ctx-section" id="test"><summary>Test</summary><div class="md"><pre><code class="language-bash">npm test              # node:test — every test/*.test.ts
 npm run test:coverage # + the coverage gate (lines 90 / funcs 85 / branches 80, src/ only)
 npm run demo          # end to end: all tools over stdio, then over stateless HTTP

package/docs/card.html

@@ -205,7 +205,7 @@ details.ctx-section>.md{padding:0 0 16px}
         </details>
         <div class="id">
           <h1>mcp-context-card</h1>
-          <p class="title">MCP server · v1.6.1</p>
+          <p class="title">MCP server · v1.7.1</p>
           <p class="oneliner">The essential MCP components for a project's context (AGENTS.md), cross-session memory, and identity</p>
         </div>
         <div class="foot-front"><span class="domain">faf.one</span><div class="pills"><span class="pill">io.github.Wolfe-Jam</span><span class="pill accent">published</span><span class="pill">MIT</span></div></div>
@@ -223,11 +223,11 @@ details.ctx-section>.md{padding:0 0 16px}
           </div>
         </details>
         <div class="tabbar"><label for="t-about">About</label><label for="t-context">Context</label><label for="t-memory">Memory</label><label for="t-discovery">Discovery</label></div>
-        <div class="panes"><div class="pane p-about"><p class="label">About</p><p class="lead">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 a self-published ai-catalog.json.</p><table class="kv"><tbody><tr><th>Agent ID</th><td><code>urn:air:faf.one:agent:mcp-context-card</code></td></tr><tr><th>Publisher</th><td>io.github.Wolfe-Jam</td></tr><tr><th>Version</th><td>v1.6.1</td></tr><tr><th>Status</th><td>published</td></tr><tr><th>License</th><td>MIT</td></tr><tr><th>Package (npm)</th><td><code>mcp-context-card</code></td></tr></tbody></table></div><div class="pane p-context"><p class="label">Context — AGENTS.md</p><div class="ctx-nav"><ul class="toc"><li><a href="#setup">Setup</a></li><li><a href="#build">Build</a></li><li><a href="#test">Test</a></li><li><a href="#layout">Layout</a></li><li><a href="#conventions">Conventions</a></li><li><a href="#the-invariant">The invariant</a></li><li><a href="#safety">Safety</a></li><li><a href="#definition-of-done">Definition of done</a></li><li><a href="#authoring-this-file">Authoring this file</a></li></ul><button type="button" class="xall" hidden>Expand all</button></div>
+        <div class="panes"><div class="pane p-about"><p class="label">About</p><p class="lead">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 a self-published ai-catalog.json.</p><table class="kv"><tbody><tr><th>Agent ID</th><td><code>urn:air:faf.one:agent:mcp-context-card</code></td></tr><tr><th>Publisher</th><td>io.github.Wolfe-Jam</td></tr><tr><th>Version</th><td>v1.7.1</td></tr><tr><th>Status</th><td>published</td></tr><tr><th>License</th><td>MIT</td></tr><tr><th>Package (npm)</th><td><code>mcp-context-card</code></td></tr></tbody></table></div><div class="pane p-context"><p class="label">Context — AGENTS.md</p><div class="ctx-nav"><ul class="toc"><li><a href="#setup">Setup</a></li><li><a href="#build">Build</a></li><li><a href="#test">Test</a></li><li><a href="#layout">Layout</a></li><li><a href="#conventions">Conventions</a></li><li><a href="#the-invariant">The invariant</a></li><li><a href="#safety">Safety</a></li><li><a href="#definition-of-done">Definition of done</a></li><li><a href="#authoring-this-file">Authoring this file</a></li></ul><button type="button" class="xall" hidden>Expand all</button></div>
     <div class="ctx-preamble md"><p><code>mcp-context-card</code> is the essential MCP server for a project's <strong>context</strong> (this file), <strong>memory</strong>, and <strong>identity</strong> — usable as your base MCP, or dropped into any existing MCP server as an extension. Discoverable to any MCP client through the two surfaces already in the ecosystem: the Server Card <code>_meta</code> block and <code>ai-catalog.json</code> sibling entries.</p>
 <p><code>read_agents_md</code> serves this file, section by section, over the same MCP connection.</p></div>
     <div class="ctx-body"><details class="ctx-section" id="setup"><summary>Setup</summary><div class="md"><pre><code class="language-bash">npm ci</code></pre>
-<p>Node 20 or newer. No other system dependencies.</p></div></details><details class="ctx-section" id="build"><summary>Build</summary><div class="md"><pre><code class="language-bash">npm run build       # tsc -p tsconfig.build.json  →  dist/
+<p>Node 22 or newer. No other system dependencies.</p></div></details><details class="ctx-section" id="build"><summary>Build</summary><div class="md"><pre><code class="language-bash">npm run build       # tsc -p tsconfig.build.json  →  dist/
 npm run typecheck   # tsc --noEmit over src/ + test/</code></pre></div></details><details class="ctx-section" id="test"><summary>Test</summary><div class="md"><pre><code class="language-bash">npm test              # node:test — every test/*.test.ts
 npm run test:coverage # + the coverage gate (lines 90 / funcs 85 / branches 80, src/ only)
 npm run demo          # end to end: all tools over stdio, then over stateless HTTP

package/docs/index.html

@@ -205,7 +205,7 @@ details.ctx-section>.md{padding:0 0 16px}
         </details>
         <div class="id">
           <h1>mcp-context-card</h1>
-          <p class="title">MCP server · v1.6.1</p>
+          <p class="title">MCP server · v1.7.1</p>
           <p class="oneliner">The essential MCP components for a project's context (AGENTS.md), cross-session memory, and identity</p>
         </div>
         <div class="foot-front"><span class="domain">faf.one</span><div class="pills"><span class="pill">io.github.Wolfe-Jam</span><span class="pill accent">published</span><span class="pill">MIT</span></div></div>
@@ -223,11 +223,11 @@ details.ctx-section>.md{padding:0 0 16px}
           </div>
         </details>
         <div class="tabbar"><label for="t-about">About</label><label for="t-context">Context</label><label for="t-memory">Memory</label><label for="t-discovery">Discovery</label></div>
-        <div class="panes"><div class="pane p-about"><p class="label">About</p><p class="lead">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 a self-published ai-catalog.json.</p><table class="kv"><tbody><tr><th>Agent ID</th><td><code>urn:air:faf.one:agent:mcp-context-card</code></td></tr><tr><th>Publisher</th><td>io.github.Wolfe-Jam</td></tr><tr><th>Version</th><td>v1.6.1</td></tr><tr><th>Status</th><td>published</td></tr><tr><th>License</th><td>MIT</td></tr><tr><th>Package (npm)</th><td><code>mcp-context-card</code></td></tr></tbody></table></div><div class="pane p-context"><p class="label">Context — AGENTS.md</p><div class="ctx-nav"><ul class="toc"><li><a href="#setup">Setup</a></li><li><a href="#build">Build</a></li><li><a href="#test">Test</a></li><li><a href="#layout">Layout</a></li><li><a href="#conventions">Conventions</a></li><li><a href="#the-invariant">The invariant</a></li><li><a href="#safety">Safety</a></li><li><a href="#definition-of-done">Definition of done</a></li><li><a href="#authoring-this-file">Authoring this file</a></li></ul><button type="button" class="xall" hidden>Expand all</button></div>
+        <div class="panes"><div class="pane p-about"><p class="label">About</p><p class="lead">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 a self-published ai-catalog.json.</p><table class="kv"><tbody><tr><th>Agent ID</th><td><code>urn:air:faf.one:agent:mcp-context-card</code></td></tr><tr><th>Publisher</th><td>io.github.Wolfe-Jam</td></tr><tr><th>Version</th><td>v1.7.1</td></tr><tr><th>Status</th><td>published</td></tr><tr><th>License</th><td>MIT</td></tr><tr><th>Package (npm)</th><td><code>mcp-context-card</code></td></tr></tbody></table></div><div class="pane p-context"><p class="label">Context — AGENTS.md</p><div class="ctx-nav"><ul class="toc"><li><a href="#setup">Setup</a></li><li><a href="#build">Build</a></li><li><a href="#test">Test</a></li><li><a href="#layout">Layout</a></li><li><a href="#conventions">Conventions</a></li><li><a href="#the-invariant">The invariant</a></li><li><a href="#safety">Safety</a></li><li><a href="#definition-of-done">Definition of done</a></li><li><a href="#authoring-this-file">Authoring this file</a></li></ul><button type="button" class="xall" hidden>Expand all</button></div>
     <div class="ctx-preamble md"><p><code>mcp-context-card</code> is the essential MCP server for a project's <strong>context</strong> (this file), <strong>memory</strong>, and <strong>identity</strong> — usable as your base MCP, or dropped into any existing MCP server as an extension. Discoverable to any MCP client through the two surfaces already in the ecosystem: the Server Card <code>_meta</code> block and <code>ai-catalog.json</code> sibling entries.</p>
 <p><code>read_agents_md</code> serves this file, section by section, over the same MCP connection.</p></div>
     <div class="ctx-body"><details class="ctx-section" id="setup"><summary>Setup</summary><div class="md"><pre><code class="language-bash">npm ci</code></pre>
-<p>Node 20 or newer. No other system dependencies.</p></div></details><details class="ctx-section" id="build"><summary>Build</summary><div class="md"><pre><code class="language-bash">npm run build       # tsc -p tsconfig.build.json  →  dist/
+<p>Node 22 or newer. No other system dependencies.</p></div></details><details class="ctx-section" id="build"><summary>Build</summary><div class="md"><pre><code class="language-bash">npm run build       # tsc -p tsconfig.build.json  →  dist/
 npm run typecheck   # tsc --noEmit over src/ + test/</code></pre></div></details><details class="ctx-section" id="test"><summary>Test</summary><div class="md"><pre><code class="language-bash">npm test              # node:test — every test/*.test.ts
 npm run test:coverage # + the coverage gate (lines 90 / funcs 85 / branches 80, src/ only)
 npm run demo          # end to end: all tools over stdio, then over stateless HTTP

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-context-card",
-  "version": "1.6.1",
+  "version": "1.7.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": [
@@ -66,6 +66,7 @@
   "dependencies": {
     "@hono/node-server": "^1.19.17",
     "@modelcontextprotocol/sdk": "^1.31.0",
+    "agent-business-card": "^0.1.0",
     "agents-md-facts": "^0.1.0",
     "hono": "^4.13.7",
     "yaml": "^2.9.0"

package/project.faf

@@ -24,7 +24,7 @@ stack:
   cache: slotignored
   search: slotignored
   storage: slotignored
-tech_stack: [TypeScript, "@modelcontextprotocol/sdk", "agents-md-facts", hono, "@hono/node-server", yaml]
+tech_stack: [TypeScript, "@modelcontextprotocol/sdk", "agents-md-facts", "agent-business-card", 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.
   what: The essential context, memory, and identity components for MCP — usable as a base MCP on its own, or dropped into any existing MCP server as an extension. Ten tools — read_agents_md / list_agents_md_sections / author_agents_md (context), remember / recall / forget (memory), whoami (identity), list_context_sources / render_context_card / save_context_card (discovery) — exposed through the Server Card _meta block and a self-published ai-catalog.json. Dual transport (stdio + stateless Streamable HTTP).

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.Wolfe-Jam/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.6.1",
+  "version": "1.7.1",
   "repository": {
     "url": "https://github.com/Wolfe-Jam/mcp-context-card",
     "source": "github"
@@ -14,7 +14,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "mcp-context-card",
-      "version": "1.6.1",
+      "version": "1.7.1",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"