feat(mcp): expose public MCP endpoint at /mcp for Claude connectors

Author: codercatdev

apps/site/src/pages/.well-known/mcp/server-card.json.ts

@@ -16,16 +16,24 @@ export const GET: APIRoute = async ({ locals }) => {
 			"Search and access CodingCat.dev web development guides, coding tutorials, podcast episodes, and transcripts directly from AI models.",
 		transport: {
 			type: "streamable-http",
-			endpoint: `${origin}/api/mcp`,
+			endpoint: `${origin}/mcp`,
+		},
+		mcpServers: {
+			main: {
+				url: `${origin}/mcp`,
+				name: "CodingCat.dev MCP Server",
+				description:
+					"Search and access CodingCat.dev web development guides, coding tutorials, podcast episodes, and transcripts",
+				transport: "streamable-http",
+			},
 		},
 		capabilities: {
 			tools: { listChanged: false },
 			resources: {},
 			prompts: {},
 		},
 		auth: {
-			type: "oauth2",
-			authorizationServers: [origin],
+			type: "none",
 		},
 		tools: [
 			{
@@ -54,7 +62,7 @@ export const GET: APIRoute = async ({ locals }) => {
 			"cache-control": "public, max-age=3600, s-maxage=86400",
 			"access-control-allow-origin": "*",
 			Vary: "Accept",
-			Link: `<${origin}/api/mcp>; rel="mcp-endpoint", <${origin}/llms.txt>; rel="llms-txt"`,
+			Link: `<${origin}/mcp>; rel="mcp-endpoint", <${origin}/llms.txt>; rel="llms-txt"`,
 		},
 	});
 };

apps/site/src/pages/api/mcp.ts

@@ -30,8 +30,34 @@ export const OPTIONS: APIRoute = async () => {
 	});
 };
 
-export const GET: APIRoute = async ({ locals }) => {
+export const GET: APIRoute = async ({ request, locals }) => {
 	const origin = locals.siteUrl.origin;
+	const accept = request.headers.get("accept") || "";
+
+	// If client requests SSE stream (legacy MCP HTTP+SSE transport)
+	if (accept.includes("text/event-stream")) {
+		const encoder = new TextEncoder();
+		const stream = new ReadableStream({
+			start(controller) {
+				controller.enqueue(
+					encoder.encode(`event: endpoint\ndata: ${origin}/mcp\n\n`),
+				);
+			},
+		});
+
+		return new Response(stream, {
+			headers: {
+				"content-type": "text/event-stream; charset=utf-8",
+				"cache-control": "no-cache, no-transform",
+				connection: "keep-alive",
+				"access-control-allow-origin": "*",
+				"access-control-allow-methods": "GET, POST, OPTIONS",
+				"access-control-allow-headers":
+					"Content-Type, Authorization, Mcp-Session-Id, Mcp-Protocol-Version",
+			},
+		});
+	}
+
 	return new Response(
 		JSON.stringify(
 			{
@@ -41,6 +67,7 @@ export const GET: APIRoute = async ({ locals }) => {
 				protocolVersion: "2024-11-05",
 				supportedVersions: ["2026-07-28", "2024-11-05"],
 				transport: "streamable-http",
+				endpoint: `${origin}/mcp`,
 				serverCard: `${origin}/.well-known/mcp/server-card.json`,
 				capabilities: {
 					tools: { listChanged: false },
@@ -185,7 +212,7 @@ export const POST: APIRoute = async ({ request, locals }) => {
 									},
 									type: {
 										type: "string",
-										enum: ["all", "post", "podcast"],
+										enum: ["all", "post", "podcast", "author", "guest"],
 										description:
 											"Optional filter for content type (default: all)",
 									},
@@ -214,6 +241,20 @@ export const POST: APIRoute = async ({ request, locals }) => {
 		);
 	}
 
+	// 6b. Resource templates list
+	if (method === "resources/templates/list") {
+		return new Response(
+			JSON.stringify({
+				jsonrpc: "2.0",
+				id,
+				result: {
+					resourceTemplates: [],
+				},
+			}),
+			{ headers: MCP_HEADERS },
+		);
+	}
+
 	// 7. Prompts list
 	if (method === "prompts/list") {
 		return new Response(

apps/site/src/pages/mcp.ts

@@ -0,0 +1 @@
+export { GET, OPTIONS, POST, prerender } from "./api/mcp";