OpenZeppelin Contracts MCP Server

1# OpenZeppelin Contracts MCP Server
2 
3[![NPM Package](https://img.shields.io/npm/v/@openzeppelin/contracts-mcp)](https://www.npmjs.com/package/@openzeppelin/contracts-mcp)
4 
5A Model Context Protocol (MCP) server that allows AI agents to generate smart contracts using OpenZeppelin Contracts libraries.
6 
7This server runs locally and requires Node.js to be installed. For a hosted version, see [OpenZeppelin MCP Servers](https://mcp.openzeppelin.com/).
8 
9> [!WARNING]
10> AI agents determine when and how to use the MCP server and therefore may produce inaccurate results. You should always review any information produced by the AI agent to ensure that any results are accurate and suit your purposes.
11 
12## Features
13 
14Provides tools to generate smart contract source code for the following languages and contract kinds. Resulting contracts use OpenZeppelin Contracts libraries for each language. Tools are named in the format `<language>-<contract>`.
15 
16| Language | Contracts |
17| --- | --- |
18| solidity | erc20, erc721, erc1155, stablecoin, rwa, account, governor, custom |
19| cairo | erc20, erc721, erc1155, account, multisig, governor, vesting, custom |
20| confidential | erc7984 |
21| stellar | fungible, stablecoin, non-fungible |
22| stylus | erc20, erc721, erc1155 |
23| uniswap-hooks | hooks (tool name is just `uniswap-hooks`) |
24 
25 
26## Installation
27 
28### Cursor
29 
30For quick installation, use the button below.
31 
32[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=OpenZeppelinContracts&config=ewogICJjb21tYW5kIjogIm5weCIsCiAgImFyZ3MiOiBbCiAgICAiLXkiLAogICAgIkBvcGVuemVwcGVsaW4vY29udHJhY3RzLW1jcCIKICBdCn0=)
33 
34For manual installation:
351. Go to Settings > Cursor Settings > Tools & Integrations > MCP Tools > New MCP Server.
362. Add the contents from the [Client Configuration](#client-configuration-cursorwindsurfclaude-desktop) section to your MCP configuration file and save.
373. See the MCP server in the list.
38 
39### Windsurf
40 
411. Go to Settings > Windsurf Settings > Cascade > Manage MCPs > View raw config.
422. Add the contents from the [Client Configuration](#client-configuration-cursorwindsurfclaude-desktop) section to your MCP configuration file and save.
433. Click Refresh on the Manage MCP Servers page.
444. See the MCP server in the list.
45 
46### Claude Desktop
47 
481. Go to Settings > Developer > Edit Config.
492. Add the contents from the [Client Configuration](#client-configuration-cursorwindsurfclaude-desktop) section to your MCP configuration file and save.
503. Restart Claude Desktop.
514. Click the "Search and tools" button and see the MCP server in the list.
52 
53### Client Configuration (Cursor/Windsurf/Claude Desktop)
54 
55```json
56{
57  "mcpServers": {
58    "OpenZeppelinContracts": {
59      "command": "npx",
60      "args": [
61        "-y",
62        "@openzeppelin/contracts-mcp"
63      ]
64    }
65  }
66}
67```
68 
69### Claude Code
70 
71```sh
72claude mcp add OpenZeppelinContracts -- npx -y @openzeppelin/contracts-mcp
73```
74 
75### VS Code
76 
77For quick installation, use one of the buttons below.
78 
79[![Add to VS Code](https://img.shields.io/badge/VS_Code-NPM-0098FF?style=flat-square)](https://insiders.vscode.dev/redirect/mcp/install?name=OpenZeppelinContracts&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%20%22%40openzeppelin%2Fcontracts-mcp%22%5D%7D)
80[![Add to VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-NPM-24bfa5?style=flat-square)](https://insiders.vscode.dev/redirect/mcp/install?name=OpenZeppelinContracts&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%20%22%40openzeppelin%2Fcontracts-mcp%22%5D%7D&quality=insiders)
81 
82For manual installation:
831. Follow VS Code documentation to [Add an MCP server to your workspace](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server-to-your-workspace) using the following configuration:
84```json
85{
86  "servers": {
87    "OpenZeppelinContracts": {
88      "type": "stdio",
89      "command": "npx",
90      "args": [
91        "-y",
92        "@openzeppelin/contracts-mcp"
93      ]
94    }
95  }
96}
97```
982. Start the MCP server according to [Manage MCP servers](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_manage-mcp-servers).
99 
100## Usage
101 
102When interacting with an AI agent, for example in your IDE's Write or Agent mode, ask it to write or modify smart contracts for your use case. When the AI agent determines it is appropriate to do so, it will use the MCP server to generate the contracts or determine best practices for your use case.
103