Implement MCP agent registration model

AGENTS.md

@@ -13,6 +13,7 @@ Decision docs:
 
 - [deployment shape](docs/deployment.md)
 - [ACP alias bridge](docs/acp-alias-bridge.md)
+- [MCP agent registration](docs/mcp-agent-registration.md)
 
 Working rules:
 

apps/server/drizzle/0003_mcp_agents.sql

@@ -0,0 +1,13 @@
+ALTER TABLE `agents` ADD `host_kind` text NOT NULL DEFAULT 'custom';
+--> statement-breakpoint
+ALTER TABLE `agents` ADD `execution_name` text;
+--> statement-breakpoint
+ALTER TABLE `agents` ADD `fingerprint` text;
+--> statement-breakpoint
+ALTER TABLE `agents` ADD `orchestrator` integer NOT NULL DEFAULT false;
+--> statement-breakpoint
+ALTER TABLE `agents` ADD `controlled` integer NOT NULL DEFAULT false;
+--> statement-breakpoint
+ALTER TABLE `agents` ADD `endpoints` text NOT NULL DEFAULT '[]';
+--> statement-breakpoint
+CREATE INDEX `agents_node_execution_idx` ON `agents` (`node_id`,`host_kind`,`execution_name`);

apps/server/drizzle/meta/_journal.json

@@ -22,6 +22,13 @@
       "when": 1778675200000,
       "tag": "0002_session_cwd",
       "breakpoints": true
+    },
+    {
+      "idx": 3,
+      "version": "7",
+      "when": 1778761600000,
+      "tag": "0003_mcp_agents",
+      "breakpoints": true
     }
   ]
 }

apps/server/scripts/smoke.ts

@@ -41,6 +41,18 @@ async function main() {
     );
 
     await idle();
+    await registerMcpSelf(app, {
+      name: "Claude",
+      hostKind: "claude",
+      executionName: "claude",
+      transport: "npx",
+      node: {
+        id: "node-source",
+        name: "node-source",
+        host: "source-host",
+        labels: ["demo"]
+      }
+    });
 
     const direct = await injectAuthed(app, authCookie, {
       method: "POST",
@@ -280,6 +292,32 @@ async function loginCookie(app: ReturnType<typeof buildApp>) {
   return String(cookie).split(";")[0];
 }
 
+async function registerMcpSelf(
+  app: ReturnType<typeof buildApp>,
+  payload: {
+    name: string;
+    hostKind: string;
+    executionName: string;
+    transport: "url" | "npx";
+    node?: {
+      id: string;
+      name: string;
+      host: string;
+      labels: string[];
+    };
+  }
+) {
+  const response = await app.inject({
+    method: "POST",
+    url: "/api/mcp/register-self",
+    headers: {
+      authorization: "Bearer demo-token"
+    },
+    payload
+  });
+  assert(response.statusCode === 200, "expected MCP self registration to succeed");
+}
+
 async function injectAuthed(
   app: ReturnType<typeof buildApp>,
   cookie: string,