docs

Author: KKonstantinov

docs/migration-SKILL.md

@@ -227,6 +227,10 @@ tool.update({ paramsSchema: { name: z.string() }, callback: handler });
 tool.update({ inputSchema: { name: z.string() }, handler: handler });
 ```
 
+**Note:** In v1, `paramsSchema` inconsistently differed from `inputSchema` used in `registerTool()`. Fixed in v2.
+
+**New:** `RegisteredTool` now supports `icons` field (parity with protocol `Tool` type).
+
 New getter methods on `McpServer`:
 
 | Getter                        | Returns                                           |

docs/migration.md

@@ -268,6 +268,14 @@ tool.update({
 });
 ```
 
+**Note:** In v1, `RegisteredTool.update()` used `paramsSchema` which inconsistently differed from the `inputSchema` field used in `registerTool()`. This has been fixed in v2.
+
+**New:** `RegisteredTool` now supports the `icons` field for parity with the protocol `Tool` type:
+
+```typescript
+tool.update({ icons: [{ type: 'base64', mediaType: 'image/png', data: '...' }] });
+```
+
 New getter methods are available on `McpServer` to access all registered items:
 
 ```typescript