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. Pass registration layers as the registrations option to build them before the server starts."
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. Pass registration layers as the registrations option; request-level dependencies it doesn't supply become HttpRouter request requirements that HttpRouter.middleware can provide."
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, and registration layers as the registrations option."
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, and registration layers as the registrations option."
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. Services a tool declares with dependencies or Tool.addDependency are request-level: provide them per request with McpServer.middleware instead of at registration. Parameter decoding and result encoding services are still required at registration. 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 layer now requires McpServer; pass it to a transport through the registrations option. Services a tool declares with dependencies are request-level and are provided with McpServer.middleware. 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. Services read by resource and completion handlers are request-level, provided per request with McpServer.middleware; read construction-time services in the enclosing effect and close over them. McpSchema.McpRequestContext is always provided."
28"@effect/ai/McpServer#resource":
29 replacement: "McpServer.resource"
30 note: "Moved to effect/ai/McpServer. The layer now requires McpServer. Services read by resource and completion handlers are request-level, provided with McpServer.middleware; read construction-time services in Layer.unwrap and close over them instead of using Layer.provide."
31"@effect/ai/McpServer#registerPrompt":
32 replacement: "McpServer.registerPrompt"
33 note: "Moved to effect/ai/McpServer. Services read by prompt and completion handlers are request-level, provided per request with McpServer.middleware; parameter decoding services are still required at registration. McpSchema.McpRequestContext is always provided."
34"@effect/ai/McpServer#prompt":
35 replacement: "McpServer.prompt"
36 note: "Moved to effect/ai/McpServer. The layer now requires McpServer. Services read by prompt and completion handlers are request-level, provided with McpServer.middleware; read construction-time services in Layer.unwrap and close over them."