1"@effect/ai/McpServer#layer":
2 replacement: "McpServer.layer"
3 note: "Moved to effect/ai/McpServer. Pass a non-empty protocols array of adapters, such as [McpProtocol.v2025_06_18], imported with McpProtocol from effect/ai; it still runs over a caller-provided RpcServer.Protocol."
4"@effect/ai/McpServer#layerHttp":
5 replacement: "McpServer.layerHttp"
6 note: "Moved to effect/ai/McpServer and the unified HttpRouter. Pass a non-empty protocols array of adapters, such as [McpProtocol.v2025_06_18], imported with McpProtocol from effect/ai."
7"@effect/ai/McpServer#layerHttpRouter":
8 replacement: "McpServer.layerHttp"
9 note: "Renamed and consolidated. V4 layerHttp registers the Streamable HTTP endpoint in the unified HttpRouter; pass a non-empty protocols array of adapters, such as [McpProtocol.v2025_06_18], imported with McpProtocol from effect/ai."
10"@effect/ai/McpServer#layerStdio":
11 replacement: "McpServer.layerStdio"
12 note: "Moved to effect/ai/McpServer. Pass a non-empty protocols array of adapters, such as [McpProtocol.v2025_06_18], imported with McpProtocol from effect/ai."
13"@effect/ai/McpServer#run":
14 replacement: "McpServer.run"
15 note: "Moved to effect/ai/McpServer. Pass a non-empty protocols array of adapters, such as [McpProtocol.v2025_06_18], imported with McpProtocol from effect/ai; it remains the Effect-level runner over RpcServer.Protocol."
16"@effect/ai/McpServer#McpServer":
17 replacement: "McpServer.McpServer"
18 note: "The service is now a Context.Service. initializedClients and notificationsMailbox are no longer exposed. Registration callbacks use McpSchema.McpRequestContext; McpServerClient is only supplied for initialized stateful requests. Prefer registerToolkit, registerResource, and registerPrompt over implementing the registry shape directly."
19"@effect/ai/McpServer#registerToolkit":
20 replacement: "McpServer.registerToolkit"
21 note: "Moved to effect/ai/McpServer. Handler requirements now exclude McpSchema.McpRequestContext instead of McpServerClient. Strict tools reject excess input properties; raw JSON Schema dynamic tools cannot use strict mode. Declared handler failures produce isError results, while parameter validation fails with InvalidParams."
22"@effect/ai/McpServer#toolkit":
23 replacement: "McpServer.toolkit"
24 note: "Moved to effect/ai/McpServer. The registration layer supplies McpSchema.McpRequestContext to handlers instead of excluding McpServerClient from requirements. Strict tools reject excess properties and require an Effect Schema rather than raw dynamic JSON Schema."
25"@effect/ai/McpServer#registerResource":
26 replacement: "McpServer.registerResource"
27 note: "Moved to effect/ai/McpServer. Resource and completion handler requirements now exclude McpSchema.McpRequestContext instead of McpServerClient; use the request context for protocol-neutral client metadata."
28"@effect/ai/McpServer#resource":
29 replacement: "McpServer.resource"
30 note: "Moved to effect/ai/McpServer. The registration layer excludes McpSchema.McpRequestContext from resource and completion handler requirements instead of McpServerClient."
31"@effect/ai/McpServer#registerPrompt":
32 replacement: "McpServer.registerPrompt"
33 note: "Moved to effect/ai/McpServer. Prompt decoding and handler requirements now exclude McpSchema.McpRequestContext instead of McpServerClient; use the request context for protocol-neutral client metadata."
34"@effect/ai/McpServer#prompt":
35 replacement: "McpServer.prompt"
36 note: "Moved to effect/ai/McpServer. The registration layer excludes McpSchema.McpRequestContext from prompt decoding and handler requirements instead of McpServerClient."