cd36cde
@@ -310,7 +310,8 @@
Any MCP client that can send a header works the same way.
## The server card
`/.well-known/mcp.json` names the server (`name`, `version`, `endpoint`,
`transport`, `protectedResourceMetadata`, `documentation`, `tokenFreeTools`)
`transport`, `protectedResourceMetadata`, `documentation`, `openapi`,
`tokenFreeTools`)
and the build that answers: `commit`, the full commit the forge runs
(`FORGE_COMMIT`, or `FORGE_APP_COMMIT` on a preview), or `null` when nothing
says. `version` is `dev` on a preview, so `commit` is how an agent tells two
@@ -59,6 +59,7 @@
export function mcpCard(origin: string, now: Running = running()) {
    transport: "streamable-http",
    protectedResourceMetadata: oauth,
    documentation: `${origin}/llms.txt`,
    openapi: `${origin}/contract/openapi.json`,
    tokenFreeTools: ["report"],
    plugins: HARNESS_PLUGINS.map((p) => ({
      harness: p.harness,
@@ -56,6 +56,12 @@
describe("the MCP server card", () => {
    expect(prm.status).toBe(200);
    expect(((await prm.json()) as any).resource).toBe(card.endpoint);
    // The OpenAPI description is named and live.
    expect(card.openapi).toBe(`${base}/contract/openapi.json`);
    const spec = await fetch(card.openapi);
    expect(spec.status).toBe(200);
    expect(spec.headers.get("content-type")).toContain("application/json");
    // The documentation link is live.
    expect((await fetch(card.documentation)).status).toBe(200);
  });
		@@ -310,7 +310,8 @@ Any MCP client that can send a header works the same way.
310	310	## The server card
311	311
312	312	`/.well-known/mcp.json` names the server (`name`, `version`, `endpoint`,
313		`transport`, `protectedResourceMetadata`, `documentation`, `tokenFreeTools`)
	313	`transport`, `protectedResourceMetadata`, `documentation`, `openapi`,
	314	`tokenFreeTools`)
314	315	and the build that answers: `commit`, the full commit the forge runs
315	316	(`FORGE_COMMIT`, or `FORGE_APP_COMMIT` on a preview), or `null` when nothing
316	317	says. `version` is `dev` on a preview, so `commit` is how an agent tells two
		@@ -59,6 +59,7 @@ export function mcpCard(origin: string, now: Running = running()) {
59	59	transport: "streamable-http",
60	60	protectedResourceMetadata: oauth,
61	61	documentation: `${origin}/llms.txt`,
	62	openapi: `${origin}/contract/openapi.json`,
62	63	tokenFreeTools: ["report"],
63	64	plugins: HARNESS_PLUGINS.map((p) => ({
64	65	harness: p.harness,
		@@ -56,6 +56,12 @@ describe("the MCP server card", () => {
56	56	expect(prm.status).toBe(200);
57	57	expect(((await prm.json()) as any).resource).toBe(card.endpoint);
58	58
	59	// The OpenAPI description is named and live.
	60	expect(card.openapi).toBe(`${base}/contract/openapi.json`);
	61	const spec = await fetch(card.openapi);
	62	expect(spec.status).toBe(200);
	63	expect(spec.headers.get("content-type")).toContain("application/json");
	64
59	65	// The documentation link is live.
60	66	expect((await fetch(card.documentation)).status).toBe(200);
61	67	});