[codex] Break down MCP route registrations

[IlyaasK]

Summary

• Move MCP registration logic out of src/app/[transport]/route.ts into src/lib/mcp modules grouped by workflow.
• Add a shared Kernel SDK client helper for MCP tools and resources.
• Keep the route focused on OPTIONS/auth handling plus a single registerMcpCapabilities(server) call.

Validation

• git diff --check
• KERNEL_CLI_PROD_CLIENT_ID=dummy-prod KERNEL_CLI_STAGING_CLIENT_ID=dummy-staging KERNEL_CLI_DEV_CLIENT_ID=dummy-dev NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_Y2xlcmsuZXhhbXBsZS5jb20k bun run build
• python3 /Users/ilyaas/.codex/skills/autoreview/scripts/autoreview --mode local
• localhost MCP smoke against http://127.0.0.1:3002/mcp with API_BASE_URL=http://127.0.0.1:3001: initialized MCP, verified tools/list, resources/list, and prompts/list returned the expected registered surface (10 tools, 4 resources, 2 prompts)

---

Note

Low Risk
Large file move with intended behavior parity; main risk is subtle registration-order or copy-paste drift during the split, not auth or API contract changes.

Overview
Refactors the MCP transport route so it no longer owns thousands of lines of tool, resource, and prompt registration. The handler now calls registerMcpCapabilities(server) after auth wiring, keeping OPTIONS, Clerk/API-key auth, and withMcpAuth in the route.

New src/lib/mcp layout: a shared createKernelClient helper (kernel-client.ts), a central register.ts that wires domain modules, prompts.ts for concept/debug prompts, and tools/* files (browsers, profiles, pools, proxies, extensions, apps, docs, computer actions, shell exec, Playwright). Logic is largely moved, not rewritten—same MCP surface, easier to maintain and extend.

^{Reviewed by Cursor Bugbot for commit 629b37c. Bugbot is set up for automated code reviews on this repo. Configure here.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
mcp	Error		May 30, 2026 7:11pm

[firetiger-agent]

Firetiger deploy monitoring skipped

This PR didn't match the auto-monitor filter configured on your GitHub connection:

PRs in the kernel, infra, hypeman, and hypeship repos. kernel is a ~mono repo with many logical services underneath, ensure to focus on the implicated service for the PR

Reason: PR is in the codex repo, which is not in the operator's filter list (kernel, infra, hypeman, hypeship).

To monitor this PR anyway, reply with @firetiger monitor this.