@openzeppelin/contracts-mcp 0.5.10 → 0.6.0

package/src/cairo/tools/erc20.ts

@@ -1,15 +1,20 @@
 import type { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { ERC20Options } from '@openzeppelin/wizard-cairo';
 import { erc20 } from '@openzeppelin/wizard-cairo';
-import { safePrintCairoCodeBlock, makeDetailedPrompt } from '../../utils';
+import { makeDetailedPrompt } from '../../utils';
 import { cairoERC20Schema } from '@openzeppelin/wizard-common/schemas';
 import { cairoPrompts } from '@openzeppelin/wizard-common';
+import { registerWizardAppTool, wizardAppPrintResult } from '../../apps/register';
 
 export function registerCairoERC20(server: McpServer): RegisteredTool {
-  return server.tool(
+  return registerWizardAppTool(
+    server,
     'cairo-erc20',
-    makeDetailedPrompt(cairoPrompts.ERC20),
-    cairoERC20Schema,
+    {
+      description: makeDetailedPrompt(cairoPrompts.ERC20),
+      inputSchema: cairoERC20Schema,
+      title: 'Cairo ERC20',
+    },
     async ({
       name,
       symbol,
@@ -42,14 +47,7 @@ export function registerCairoERC20(server: McpServer): RegisteredTool {
         info,
         macros,
       };
-      return {
-        content: [
-          {
-            type: 'text',
-            text: safePrintCairoCodeBlock(() => erc20.print(opts)),
-          },
-        ],
-      };
+      return wizardAppPrintResult(opts, () => erc20.print(opts), 'cairo');
     },
   );
 }

package/src/cairo/tools/erc721.ts

@@ -1,15 +1,20 @@
 import type { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { ERC721Options } from '@openzeppelin/wizard-cairo';
 import { erc721 } from '@openzeppelin/wizard-cairo';
-import { safePrintCairoCodeBlock, makeDetailedPrompt } from '../../utils';
+import { makeDetailedPrompt } from '../../utils';
 import { cairoERC721Schema } from '@openzeppelin/wizard-common/schemas';
 import { cairoPrompts } from '@openzeppelin/wizard-common';
+import { registerWizardAppTool, wizardAppPrintResult } from '../../apps/register';
 
 export function registerCairoERC721(server: McpServer): RegisteredTool {
-  return server.tool(
+  return registerWizardAppTool(
+    server,
     'cairo-erc721',
-    makeDetailedPrompt(cairoPrompts.ERC721),
-    cairoERC721Schema,
+    {
+      description: makeDetailedPrompt(cairoPrompts.ERC721),
+      inputSchema: cairoERC721Schema,
+      title: 'Cairo ERC721',
+    },
     async ({
       name,
       symbol,
@@ -44,14 +49,7 @@ export function registerCairoERC721(server: McpServer): RegisteredTool {
         info,
         macros,
       };
-      return {
-        content: [
-          {
-            type: 'text',
-            text: safePrintCairoCodeBlock(() => erc721.print(opts)),
-          },
-        ],
-      };
+      return wizardAppPrintResult(opts, () => erc721.print(opts), 'cairo');
     },
   );
 }

package/src/cairo/tools/governor.ts

@@ -1,15 +1,20 @@
 import type { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { GovernorOptions } from '@openzeppelin/wizard-cairo';
 import { governor } from '@openzeppelin/wizard-cairo';
-import { safePrintCairoCodeBlock, makeDetailedPrompt } from '../../utils';
+import { makeDetailedPrompt } from '../../utils';
 import { cairoGovernorSchema } from '@openzeppelin/wizard-common/schemas';
 import { cairoPrompts } from '@openzeppelin/wizard-common';
+import { registerWizardAppTool, wizardAppPrintResult } from '../../apps/register';
 
 export function registerCairoGovernor(server: McpServer): RegisteredTool {
-  return server.tool(
+  return registerWizardAppTool(
+    server,
     'cairo-governor',
-    makeDetailedPrompt(cairoPrompts.Governor),
-    cairoGovernorSchema,
+    {
+      description: makeDetailedPrompt(cairoPrompts.Governor),
+      inputSchema: cairoGovernorSchema,
+      title: 'Cairo Governor',
+    },
     async ({
       name,
       delay,
@@ -48,14 +53,7 @@ export function registerCairoGovernor(server: McpServer): RegisteredTool {
         info,
         macros,
       };
-      return {
-        content: [
-          {
-            type: 'text',
-            text: safePrintCairoCodeBlock(() => governor.print(opts)),
-          },
-        ],
-      };
+      return wizardAppPrintResult(opts, () => governor.print(opts), 'cairo');
     },
   );
 }

package/src/cairo/tools/multisig.ts

@@ -1,15 +1,20 @@
 import type { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { MultisigOptions } from '@openzeppelin/wizard-cairo';
 import { multisig } from '@openzeppelin/wizard-cairo';
-import { safePrintCairoCodeBlock, makeDetailedPrompt } from '../../utils';
+import { makeDetailedPrompt } from '../../utils';
 import { cairoMultisigSchema } from '@openzeppelin/wizard-common/schemas';
 import { cairoPrompts } from '@openzeppelin/wizard-common';
+import { registerWizardAppTool, wizardAppPrintResult } from '../../apps/register';
 
 export function registerCairoMultisig(server: McpServer): RegisteredTool {
-  return server.tool(
+  return registerWizardAppTool(
+    server,
     'cairo-multisig',
-    makeDetailedPrompt(cairoPrompts.Multisig),
-    cairoMultisigSchema,
+    {
+      description: makeDetailedPrompt(cairoPrompts.Multisig),
+      inputSchema: cairoMultisigSchema,
+      title: 'Cairo Multisig',
+    },
     async ({ name, quorum, upgradeable, info, macros }) => {
       const opts: MultisigOptions = {
         name,
@@ -18,14 +23,7 @@ export function registerCairoMultisig(server: McpServer): RegisteredTool {
         info,
         macros,
       };
-      return {
-        content: [
-          {
-            type: 'text',
-            text: safePrintCairoCodeBlock(() => multisig.print(opts)),
-          },
-        ],
-      };
+      return wizardAppPrintResult(opts, () => multisig.print(opts), 'cairo');
     },
   );
 }

package/src/cairo/tools/vesting.ts

@@ -1,15 +1,20 @@
 import type { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { VestingOptions } from '@openzeppelin/wizard-cairo';
 import { vesting } from '@openzeppelin/wizard-cairo';
-import { safePrintCairoCodeBlock, makeDetailedPrompt } from '../../utils';
+import { makeDetailedPrompt } from '../../utils';
 import { cairoVestingSchema } from '@openzeppelin/wizard-common/schemas';
 import { cairoPrompts } from '@openzeppelin/wizard-common';
+import { registerWizardAppTool, wizardAppPrintResult } from '../../apps/register';
 
 export function registerCairoVesting(server: McpServer): RegisteredTool {
-  return server.tool(
+  return registerWizardAppTool(
+    server,
     'cairo-vesting',
-    makeDetailedPrompt(cairoPrompts.Vesting),
-    cairoVestingSchema,
+    {
+      description: makeDetailedPrompt(cairoPrompts.Vesting),
+      inputSchema: cairoVestingSchema,
+      title: 'Cairo Vesting',
+    },
     async ({ name, startDate, duration, cliffDuration, schedule, info, macros }) => {
       const opts: VestingOptions = {
         name,
@@ -20,14 +25,7 @@ export function registerCairoVesting(server: McpServer): RegisteredTool {
         info,
         macros,
       };
-      return {
-        content: [
-          {
-            type: 'text',
-            text: safePrintCairoCodeBlock(() => vesting.print(opts)),
-          },
-        ],
-      };
+      return wizardAppPrintResult(opts, () => vesting.print(opts), 'cairo');
     },
   );
 }

package/src/confidential/tools/erc7984.ts

@@ -1,15 +1,20 @@
 import type { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { ERC7984Options } from '@openzeppelin/wizard-confidential';
 import { erc7984 } from '@openzeppelin/wizard-confidential';
-import { safePrintSolidityCodeBlock, makeDetailedPrompt } from '../../utils';
+import { makeDetailedPrompt } from '../../utils';
 import { confidentialERC7984Schema } from '@openzeppelin/wizard-common/schemas';
 import { confidentialPrompts } from '@openzeppelin/wizard-common';
+import { registerWizardAppTool, wizardAppPrintResult } from '../../apps/register';
 
 export function registerConfidentialERC7984(server: McpServer): RegisteredTool {
-  return server.tool(
-    'erc7984',
-    makeDetailedPrompt(confidentialPrompts.ERC7984),
-    confidentialERC7984Schema,
+  return registerWizardAppTool(
+    server,
+    'confidential-erc7984',
+    {
+      description: makeDetailedPrompt(confidentialPrompts.ERC7984),
+      inputSchema: confidentialERC7984Schema,
+      title: 'Confidential ERC7984',
+    },
     async ({ name, symbol, contractURI, decimals, premint, networkConfig, wrappable, votes, info }) => {
       const opts: ERC7984Options = {
         name,
@@ -22,14 +27,7 @@ export function registerConfidentialERC7984(server: McpServer): RegisteredTool {
         votes,
         info,
       };
-      return {
-        content: [
-          {
-            type: 'text',
-            text: safePrintSolidityCodeBlock(() => erc7984.print(opts)),
-          },
-        ],
-      };
+      return wizardAppPrintResult(opts, () => erc7984.print(opts), 'solidity');
     },
   );
 }

package/src/server.ts

@@ -14,11 +14,16 @@ export function createServer() {
       version,
     },
     {
+      capabilities: {
+        tools: {},
+        resources: {},
+      },
       instructions: `\
 Tools are provided for different smart contract languages and blockchain ecosystems.
 Each tool generates a smart contract using recommended best practices with OpenZeppelin Contracts libraries, and returns the source code. The tools do not write to disk.
 If the user requests to create a new smart contract, use the appropriate tool to generate the contract.
 If the user asks to modify an existing smart contract, use these tools to determine the recommended patterns. Toggle the options in a tool to determine how different features affect the code, then apply the same types of changes to the user's contract.
+Hosts that support MCP Apps may also show an interactive Wizard UI for each tool (same options and live code preview). Non-Apps clients still receive the source as Markdown text.
 `,
     },
   );

package/src/solidity/tools/account.ts

@@ -1,15 +1,20 @@
 import type { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { AccountOptions } from '@openzeppelin/wizard';
 import { account } from '@openzeppelin/wizard';
-import { safePrintSolidityCodeBlock, makeDetailedPrompt } from '../../utils';
+import { makeDetailedPrompt } from '../../utils';
 import { solidityAccountSchema } from '@openzeppelin/wizard-common/schemas';
 import { solidityPrompts } from '@openzeppelin/wizard-common';
+import { registerWizardAppTool, wizardAppPrintResult } from '../../apps/register';
 
 export function registerSolidityAccount(server: McpServer): RegisteredTool {
-  return server.tool(
+  return registerWizardAppTool(
+    server,
     'solidity-account',
-    makeDetailedPrompt(solidityPrompts.Account),
-    solidityAccountSchema,
+    {
+      description: makeDetailedPrompt(solidityPrompts.Account),
+      inputSchema: solidityAccountSchema,
+      title: 'Solidity Account',
+    },
     async ({
       name,
       signatureValidation,
@@ -32,14 +37,7 @@ export function registerSolidityAccount(server: McpServer): RegisteredTool {
         info,
         upgradeable,
       };
-      return {
-        content: [
-          {
-            type: 'text',
-            text: safePrintSolidityCodeBlock(() => account.print(opts)),
-          },
-        ],
-      };
+      return wizardAppPrintResult(opts, () => account.print(opts), 'solidity');
     },
   );
 }

package/src/solidity/tools/custom.ts

@@ -1,15 +1,20 @@
 import type { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { CustomOptions } from '@openzeppelin/wizard';
 import { custom } from '@openzeppelin/wizard';
-import { safePrintSolidityCodeBlock, makeDetailedPrompt } from '../../utils';
+import { makeDetailedPrompt } from '../../utils';
 import { solidityCustomSchema } from '@openzeppelin/wizard-common/schemas';
 import { solidityPrompts } from '@openzeppelin/wizard-common';
+import { registerWizardAppTool, wizardAppPrintResult } from '../../apps/register';
 
 export function registerSolidityCustom(server: McpServer): RegisteredTool {
-  return server.tool(
+  return registerWizardAppTool(
+    server,
     'solidity-custom',
-    makeDetailedPrompt(solidityPrompts.Custom),
-    solidityCustomSchema,
+    {
+      description: makeDetailedPrompt(solidityPrompts.Custom),
+      inputSchema: solidityCustomSchema,
+      title: 'Solidity Custom',
+    },
     async ({ name, pausable, access, upgradeable, info }) => {
       const opts: CustomOptions = {
         name,
@@ -18,14 +23,7 @@ export function registerSolidityCustom(server: McpServer): RegisteredTool {
         upgradeable,
         info,
       };
-      return {
-        content: [
-          {
-            type: 'text',
-            text: safePrintSolidityCodeBlock(() => custom.print(opts)),
-          },
-        ],
-      };
+      return wizardAppPrintResult(opts, () => custom.print(opts), 'solidity');
     },
   );
 }

package/src/solidity/tools/erc1155.ts

@@ -1,16 +1,34 @@
 import type { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { ERC1155Options } from '@openzeppelin/wizard';
 import { erc1155 } from '@openzeppelin/wizard';
-import { safePrintSolidityCodeBlock, makeDetailedPrompt } from '../../utils';
+import { makeDetailedPrompt } from '../../utils';
 import { solidityERC1155Schema } from '@openzeppelin/wizard-common/schemas';
 import { solidityPrompts } from '@openzeppelin/wizard-common';
+import { registerWizardAppTool, wizardAppPrintResult } from '../../apps/register';
 
 export function registerSolidityERC1155(server: McpServer): RegisteredTool {
-  return server.tool(
+  return registerWizardAppTool(
+    server,
     'solidity-erc1155',
-    makeDetailedPrompt(solidityPrompts.ERC1155),
-    solidityERC1155Schema,
-    async ({ name, uri, burnable, pausable, mintable, supply, updatableUri, access, upgradeable, info }) => {
+    {
+      description: makeDetailedPrompt(solidityPrompts.ERC1155),
+      inputSchema: solidityERC1155Schema,
+      title: 'Solidity ERC1155',
+    },
+    async ({
+      name,
+      uri,
+      burnable,
+      pausable,
+      mintable,
+      supply,
+      updatableUri,
+      crossChainBridging,
+      crossChainLinkAllowOverride,
+      access,
+      upgradeable,
+      info,
+    }) => {
       const opts: ERC1155Options = {
         name,
         uri,
@@ -19,18 +37,13 @@ export function registerSolidityERC1155(server: McpServer): RegisteredTool {
         mintable,
         supply,
         updatableUri,
+        crossChainBridging,
+        crossChainLinkAllowOverride,
         access,
         upgradeable,
         info,
       };
-      return {
-        content: [
-          {
-            type: 'text',
-            text: safePrintSolidityCodeBlock(() => erc1155.print(opts)),
-          },
-        ],
-      };
+      return wizardAppPrintResult(opts, () => erc1155.print(opts), 'solidity');
     },
   );
 }

package/src/solidity/tools/erc20.ts

@@ -1,15 +1,20 @@
 import type { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { ERC20Options } from '@openzeppelin/wizard';
 import { erc20 } from '@openzeppelin/wizard';
-import { safePrintSolidityCodeBlock, makeDetailedPrompt } from '../../utils';
+import { makeDetailedPrompt } from '../../utils';
 import { solidityERC20Schema } from '@openzeppelin/wizard-common/schemas';
 import { solidityPrompts } from '@openzeppelin/wizard-common';
+import { registerWizardAppTool, wizardAppPrintResult } from '../../apps/register';
 
 export function registerSolidityERC20(server: McpServer): RegisteredTool {
-  return server.tool(
+  return registerWizardAppTool(
+    server,
     'solidity-erc20',
-    makeDetailedPrompt(solidityPrompts.ERC20),
-    solidityERC20Schema,
+    {
+      description: makeDetailedPrompt(solidityPrompts.ERC20),
+      inputSchema: solidityERC20Schema,
+      title: 'Solidity ERC20',
+    },
     async ({
       name,
       symbol,
@@ -48,14 +53,7 @@ export function registerSolidityERC20(server: McpServer): RegisteredTool {
         upgradeable,
         info,
       };
-      return {
-        content: [
-          {
-            type: 'text',
-            text: safePrintSolidityCodeBlock(() => erc20.print(opts)),
-          },
-        ],
-      };
+      return wizardAppPrintResult(opts, () => erc20.print(opts), 'solidity');
     },
   );
 }

package/src/solidity/tools/erc721.ts

@@ -1,15 +1,20 @@
 import type { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { ERC721Options } from '@openzeppelin/wizard';
 import { erc721 } from '@openzeppelin/wizard';
-import { safePrintSolidityCodeBlock, makeDetailedPrompt } from '../../utils';
+import { makeDetailedPrompt } from '../../utils';
 import { solidityERC721Schema } from '@openzeppelin/wizard-common/schemas';
 import { solidityPrompts } from '@openzeppelin/wizard-common';
+import { registerWizardAppTool, wizardAppPrintResult } from '../../apps/register';
 
 export function registerSolidityERC721(server: McpServer): RegisteredTool {
-  return server.tool(
+  return registerWizardAppTool(
+    server,
     'solidity-erc721',
-    makeDetailedPrompt(solidityPrompts.ERC721),
-    solidityERC721Schema,
+    {
+      description: makeDetailedPrompt(solidityPrompts.ERC721),
+      inputSchema: solidityERC721Schema,
+      title: 'Solidity ERC721',
+    },
     async ({
       name,
       symbol,
@@ -21,6 +26,8 @@ export function registerSolidityERC721(server: McpServer): RegisteredTool {
       mintable,
       incremental,
       votes,
+      crossChainBridging,
+      crossChainLinkAllowOverride,
       access,
       upgradeable,
       namespacePrefix,
@@ -37,19 +44,14 @@ export function registerSolidityERC721(server: McpServer): RegisteredTool {
         mintable,
         incremental,
         votes,
+        crossChainBridging,
+        crossChainLinkAllowOverride,
         access,
         upgradeable,
         namespacePrefix,
         info,
       };
-      return {
-        content: [
-          {
-            type: 'text',
-            text: safePrintSolidityCodeBlock(() => erc721.print(opts)),
-          },
-        ],
-      };
+      return wizardAppPrintResult(opts, () => erc721.print(opts), 'solidity');
     },
   );
 }

package/src/solidity/tools/governor.ts

@@ -1,15 +1,20 @@
 import type { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { GovernorOptions } from '@openzeppelin/wizard';
 import { governor } from '@openzeppelin/wizard';
-import { safePrintSolidityCodeBlock, makeDetailedPrompt } from '../../utils';
+import { makeDetailedPrompt } from '../../utils';
 import { solidityGovernorSchema } from '@openzeppelin/wizard-common/schemas';
 import { solidityPrompts } from '@openzeppelin/wizard-common';
+import { registerWizardAppTool, wizardAppPrintResult } from '../../apps/register';
 
 export function registerSolidityGovernor(server: McpServer): RegisteredTool {
-  return server.tool(
+  return registerWizardAppTool(
+    server,
     'solidity-governor',
-    makeDetailedPrompt(solidityPrompts.Governor),
-    solidityGovernorSchema,
+    {
+      description: makeDetailedPrompt(solidityPrompts.Governor),
+      inputSchema: solidityGovernorSchema,
+      title: 'Solidity Governor',
+    },
     async ({
       name,
       delay,
@@ -25,6 +30,7 @@ export function registerSolidityGovernor(server: McpServer): RegisteredTool {
       quorumAbsolute,
       storage,
       settings,
+      crossChainExecution,
       upgradeable,
       info,
     }) => {
@@ -43,17 +49,11 @@ export function registerSolidityGovernor(server: McpServer): RegisteredTool {
         quorumAbsolute,
         storage,
         settings,
+        crossChainExecution,
         upgradeable,
         info,
       };
-      return {
-        content: [
-          {
-            type: 'text',
-            text: safePrintSolidityCodeBlock(() => governor.print(opts)),
-          },
-        ],
-      };
+      return wizardAppPrintResult(opts, () => governor.print(opts), 'solidity');
     },
   );
 }

package/src/solidity/tools/rwa.ts

@@ -1,15 +1,20 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { StablecoinOptions } from '@openzeppelin/wizard';
 import { realWorldAsset } from '@openzeppelin/wizard';
-import { safePrintSolidityCodeBlock, makeDetailedPrompt } from '../../utils';
+import { makeDetailedPrompt } from '../../utils';
 import { solidityRWASchema } from '@openzeppelin/wizard-common/schemas';
 import { solidityPrompts } from '@openzeppelin/wizard-common';
+import { registerWizardAppTool, wizardAppPrintResult } from '../../apps/register';
 
-export function registerSolidityRWA(server: McpServer) {
-  return server.tool(
+export function registerSolidityRWA(server: McpServer): RegisteredTool {
+  return registerWizardAppTool(
+    server,
     'solidity-rwa',
-    makeDetailedPrompt(solidityPrompts.RWA),
-    solidityRWASchema,
+    {
+      description: makeDetailedPrompt(solidityPrompts.RWA),
+      inputSchema: solidityRWASchema,
+      title: 'Solidity RWA',
+    },
     async ({
       name,
       symbol,
@@ -50,14 +55,7 @@ export function registerSolidityRWA(server: McpServer) {
         restrictions,
         freezable,
       };
-      return {
-        content: [
-          {
-            type: 'text',
-            text: safePrintSolidityCodeBlock(() => realWorldAsset.print(opts)),
-          },
-        ],
-      };
+      return wizardAppPrintResult(opts, () => realWorldAsset.print(opts), 'solidity');
     },
   );
 }

package/src/solidity/tools/stablecoin.ts

@@ -1,15 +1,20 @@
 import type { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { StablecoinOptions } from '@openzeppelin/wizard';
 import { stablecoin } from '@openzeppelin/wizard';
-import { safePrintSolidityCodeBlock, makeDetailedPrompt } from '../../utils';
+import { makeDetailedPrompt } from '../../utils';
 import { solidityStablecoinSchema } from '@openzeppelin/wizard-common/schemas';
 import { solidityPrompts } from '@openzeppelin/wizard-common';
+import { registerWizardAppTool, wizardAppPrintResult } from '../../apps/register';
 
 export function registerSolidityStablecoin(server: McpServer): RegisteredTool {
-  return server.tool(
+  return registerWizardAppTool(
+    server,
     'solidity-stablecoin',
-    makeDetailedPrompt(solidityPrompts.Stablecoin),
-    solidityStablecoinSchema,
+    {
+      description: makeDetailedPrompt(solidityPrompts.Stablecoin),
+      inputSchema: solidityStablecoinSchema,
+      title: 'Solidity Stablecoin',
+    },
     async ({
       name,
       symbol,
@@ -50,14 +55,7 @@ export function registerSolidityStablecoin(server: McpServer): RegisteredTool {
         restrictions,
         freezable,
       };
-      return {
-        content: [
-          {
-            type: 'text',
-            text: safePrintSolidityCodeBlock(() => stablecoin.print(opts)),
-          },
-        ],
-      };
+      return wizardAppPrintResult(opts, () => stablecoin.print(opts), 'solidity');
     },
   );
 }