feat(infra): hosted MCP endpoint for Cap Infra

apps/web/__tests__/unit/agent-readiness.test.ts

@@ -397,7 +397,7 @@ describe("developer OpenAPI spec", () => {
 		] as const;
 		const implemented = new Set<string>();
 		for (const [dir, base] of routeDirs) {
-			const source = readFileSync(join(apiRoot, dir, "route.ts"), "utf8");
+			const source = readFileSync(join(apiRoot, dir, "app.ts"), "utf8");
 			const modules = new Map(
 				[...source.matchAll(/import \* as (\w+) from "\.\/([^"]+)"/g)].map(
 					([, name, file]) => [name, file],

apps/web/__tests__/unit/developer-get-started-docs.test.ts

@@ -70,10 +70,12 @@ describe("the Get Started guide", () => {
 		}
 	});
 
-	it("keeps real credentials, the CLI and the em dash out", () => {
+	it("keeps real credentials, the CLI and the em dash out, and points agents at the hosted MCP server", () => {
 		expect(content).not.toContain("—");
 		expect(content).not.toMatch(/\bcap (guide|record|upload|caps|mcp)\b/);
-		expect(content).not.toMatch(/\bMCP\b/);
+		expect(content.match(/https:\/\/[^\s"`]*\/mcp\b/g) ?? []).toEqual(
+			Array(4).fill("https://cap.so/api/developer/mcp"),
+		);
 		const keys = content.match(/\bc(?:sk|pk|ut)_[A-Za-z0-9._-]+/g) ?? [];
 		expect(keys.every((key) => key === "csk_your_secret_key")).toBe(true);
 	});

apps/web/__tests__/unit/infra-agent-prompt.test.ts

@@ -1,7 +1,10 @@
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
 import { describe, expect, it } from "vitest";
-import { CAP_INFRA_AGENT_PROMPT } from "@/data/infra-agent-prompt";
+import {
+	CAP_INFRA_AGENT_PROMPT,
+	CAP_INFRA_MCP_URL,
+} from "@/data/infra-agent-prompt";
 import { developerOpenApiSpec } from "@/lib/developer-openapi";
 
 const METHODS = ["get", "post", "put", "patch", "delete"] as const;
@@ -30,7 +33,9 @@ describe("Cap Infra agent prompt", () => {
 			);
 		}
 		const pathMentions =
-			CAP_INFRA_AGENT_PROMPT.match(/\/api\/developer\//g) ?? [];
+			CAP_INFRA_AGENT_PROMPT.replaceAll(CAP_INFRA_MCP_URL, "").match(
+				/\/api\/developer\//g,
+			) ?? [];
 		expect(pathMentions).toHaveLength(calls.length);
 	});
 
@@ -60,17 +65,22 @@ describe("Cap Infra agent prompt", () => {
 		expect(CAP_INFRA_AGENT_PROMPT).toContain("60 requests a minute");
 	});
 
-	it("links only to the API reference", () => {
+	it("links only to the API reference and the hosted MCP server", () => {
 		const links = CAP_INFRA_AGENT_PROMPT.match(/https?:\/\/[^\s)]+/g) ?? [];
 		expect([...new Set(links)].sort()).toEqual([
+			"https://cap.so/api/developer/mcp",
 			"https://cap.so/docs/api/rest-api",
 			"https://cap.so/openapi.json",
 		]);
 	});
 
-	it("never asks for the Cap CLI, an MCP server or a pasted key", () => {
+	it("never asks for the Cap CLI, a local MCP server or a pasted key", () => {
 		expect(CAP_INFRA_AGENT_PROMPT).not.toMatch(/\bcap [a-z]/);
-		expect(CAP_INFRA_AGENT_PROMPT).not.toMatch(/\bCLI\b|\bMCP\b|curl|install/i);
+		expect(CAP_INFRA_AGENT_PROMPT).not.toMatch(/\bCLI\b|curl|install|npx/i);
+		expect(CAP_INFRA_AGENT_PROMPT.match(/\bMCP\b/g)).toEqual(["MCP", "MCP"]);
+		expect(CAP_INFRA_AGENT_PROMPT).toContain(
+			"hosted MCP server at https://cap.so/api/developer/mcp",
+		);
 		expect(CAP_INFRA_AGENT_PROMPT).not.toContain("cpk_");
 		expect(CAP_INFRA_AGENT_PROMPT).toContain(
 			"Never ask me to paste the key into the chat",
@@ -85,15 +95,15 @@ describe("Cap Infra agent prompt", () => {
 		);
 	});
 
-	it("is introduced in the console without the Cap CLI or an MCP server", () => {
+	it("is introduced in the console without the Cap CLI", () => {
 		const source = readFileSync(
 			join(
 				process.cwd(),
 				"app/(infra)/dashboard/infra/_components/agent-setup.tsx",
 			),
 			"utf8",
 		);
-		expect(source).not.toMatch(/\bCLI\b|\bMCP\b/);
+		expect(source).not.toMatch(/\bCLI\b/);
 		expect(source).toContain("secret key");
 	});
 });