Contracts Wizard logo

Contracts Wizard

by OpenZeppelin

Generate OpenZeppelin-based smart contract source for Solidity, Cairo, Stellar, Stylus, TRON, and confidential token standards.

Install Contracts Wizard

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "openzeppelin-contracts-wizard": {
      "command": "npx",
      "args": [
        "-y",
        "@openzeppelin/contracts-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

OpenZeppelin/contracts-wizard MCP server exposes OpenZeppelin Wizard contract generators to AI agents through MCP. It produces source code for token, account, governance, vesting, vault, multisig, custom, and other contract templates across several languages and standards. Results are returned as Markdown code and are not written to disk. Use it when an agent needs a contract starting point based on OpenZeppelin Contracts libraries, while reviewing generated code before use.

Use cases

  • Generate ERC-20, ERC-721, or ERC-1155 contract starting points
  • Create Cairo, Stellar, Stylus, or TRON token contracts
  • Prototype account, governance, multisig, vesting, or vault contracts
  • Produce confidential ERC-7984 token source
  • Preview contract variants through an MCP Apps-compatible client

Key features

  • Generates source from OpenZeppelin Contracts libraries
  • Supports Solidity, Cairo, confidential Solidity, Stellar, Stylus, and TRON
  • Returns generated code as Markdown without writing files
  • Provides token, account, governance, vesting, vault, multisig, and custom templates
  • Offers interactive Wizard UIs in supported MCP Apps clients

Tools33

What Contracts Wizard lets your agent do. Expand a tool for its parameters.

Verified live~27.8k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

17/18 checks healthy over the last 77d

What it can do

From the 33 tools this server returned when we ran it.

Runs commands · 2Writes files · 33Handles credentials · 22
Network at startup3 connections
Files written at startupNone
Install scriptsprepare
npm provenanceSigned build
Package age454 days
Maintainers3

Observed 2026-10-23 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 4d ago via OSV.dev · @openzeppelin/contracts-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars295Stargazers on the source repository.
npm downloads491Package downloads in the last 30 days.
Last commit2d agoMost recent push to the default branch.
Tools exposed33Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Contracts Wizard works

What OpenZeppelin/contracts-wizard does

OpenZeppelin/contracts-wizard connects an MCP-compatible AI client to contract generators based on OpenZeppelin Contracts libraries. Its tools create source code for common token and smart-contract patterns rather than editing a project or writing files to disk. Each result is returned as source inside a Markdown code block.

The available families cover Solidity, Cairo, confidential Solidity, Stellar, Stylus, and TRON. Solidity generators include ERC-20, ERC-721, ERC-1155, stablecoin, real-world asset, account, governor, and custom contracts. Cairo adds ERC-6909, multisig, and vesting generators. Other supported patterns include confidential ERC-7984, Stellar fungible and non-fungible tokens, Stellar vaults and accounts, Stylus token standards, and TRON TRC-20, TRC-721, and TRC-1155 contracts.

How it works

The server runs locally and communicates with an MCP client over a standard process configuration. Tool names identify the language and contract kind, such as solidity-erc20 or cairo-account. An AI agent can select and call an appropriate generator while helping write or modify a smart contract. The generated source is sent back in the tool response for the agent or developer to inspect and use.

Clients that support MCP Apps can also display an interactive Wizard interface for each tool. The interface provides the options for the selected contract type, a live code preview, and a way to return the current source to the agent. Cursor and Claude are examples of clients identified as supporting this extension. Clients without MCP Apps support still receive the generated source as Markdown text.

Setup and configuration

Node.js is required because the package runs locally. The documented installation uses the npm package through npx:

config.json
{
  "mcpServers": {
    "OpenZeppelinContracts": {
      "command": "npx",
      "args": ["-y", "@openzeppelin/contracts-mcp"]
    }
  }
}

Cursor, Windsurf, Claude Desktop, and VS Code can use this stdio configuration in their MCP settings. Claude Code can add the server with:

Terminal
claude mcp add OpenZeppelinContracts -- npx -y @openzeppelin/contracts-mcp

When running from a local checkout or a file: dependency, the MCP Apps HTML must be built with yarn --cwd packages/mcp build:apps. Published npm packages include those generated app files.

Tools and capabilities

The generator set includes:

  • Solidity ERC-20, ERC-721, ERC-1155, stablecoin, RWA, account, governor, and custom contracts.
  • Cairo ERC-20, ERC-721, ERC-1155, ERC-6909, account, multisig, governor, vesting, and custom contracts.
  • Confidential ERC-7984 fungible tokens.
  • Stellar fungible, stablecoin, non-fungible, governor, vault, and account contracts.
  • Stylus ERC-20, ERC-721, and ERC-1155 contracts.
  • TRON TRC-20, TRC-721, and TRC-1155 contracts.

The source output is intended as a starting point for development. Stablecoin and real-world asset Solidity generators are marked experimental, do not support upgradeability, and include features that may be unaudited or subject to change.

Limitations and notes

The server does not save generated contracts to disk. Developers must copy or integrate the returned source into their own project. AI agents decide when and how to call the tools, so generated code and recommendations require technical review for correctness and suitability. The hosted alternative is separate from this local package.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Contracts Wizard

OpenZeppelin/contracts-wizard is an MCP server that connects AI agents to OpenZeppelin Wizard contract generators. Its main tools create Solidity, Cairo, Stellar, Stylus, TRON, and confidential-token source for standards such as ERC-20, ERC-721, ERC-1155, ERC-7984, and related account, governance, vault, and custom contract types.

Install it by adding `npx -y @openzeppelin/contracts-mcp` as an MCP stdio server command. Cursor, Windsurf, and Claude Desktop use the documented JSON configuration; Claude Code can use `claude mcp add`, and VS Code accepts the same command and arguments in its MCP settings.

Yes, it works with Cursor through a local MCP configuration using `npx -y @openzeppelin/contracts-mcp`. Cursor is also identified as an MCP Apps host, so supported tools can provide an interactive Wizard UI, live source preview, and a copy action when the host capabilities require it.

It supports Solidity, Cairo, confidential Solidity, Stellar, Stylus, and TRON generators. Available templates cover token standards and additional patterns such as accounts, governors, multisig contracts, vesting, vaults, stablecoins, real-world assets, and custom contracts.

No, generated contracts are returned as source code in a Markdown code block and are not written to disk. The developer or agent must copy the result into a project and review it before using it.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewContracts Wizard AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/openzeppelin-contracts-wizard?style=directory)](https://allmcps.com/mcp/openzeppelin-contracts-wizard)
HTML Embed
<a href="https://allmcps.com/mcp/openzeppelin-contracts-wizard"><img src="https://allmcps.com/api/badge/openzeppelin-contracts-wizard?style=directory" alt="Contracts Wizard on AllMCPs" /></a>