AI Tooling

Aztec is new, rapidly evolving, and spans novel concepts like private state, notes, and nullifiers. AI coding tools can accelerate your learning and development, but they need up-to-date context to be useful. This page shows you how to set that up.

caution

LLMs have limited training data for zero-knowledge circuit development. Noir and Aztec.nr are newer languages with smaller codebases than mainstream languages, so AI tools will make more mistakes than you might be used to. The tools on this page help by providing up-to-date context, but you should always verify generated code and test thoroughly.

MCP servers

The highest-leverage tools are the Aztec and Noir MCP servers. They clone reference repositories locally and give your AI tool code search, documentation search, and example discovery across the Aztec and Noir ecosystems. They work with any AI coding tool that supports MCP (Claude Code, Cursor, Windsurf, Codex, and others).

The MCP servers help manage the problem of focusing LLMs on the correct Aztec versions for your project. Aztec is under active development and there may be multiple versions in use at any given time (e.g. mainnet, devnet and testnet may be on different versions). They make it easy to switch between versions if needed, and to keep your context up to date as the repos evolve.

Start here if you're unsure what to set up.

Claude Code

Install the Aztec and Noir plugins from the marketplace. These include the MCP servers plus additional skills, commands, and agents:

/plugin marketplace add critesjosh/aztec-claude-plugin
/plugin install aztec@aztec-plugins

Or add the MCP servers directly:

claude mcp add aztec -- npx aztec-mcp-server@latest
claude mcp add noir -- npx noir-mcp-server@latest

Cursor / Windsurf / other MCP clients

Add the servers to your MCP configuration JSON:

{
  "mcpServers": {
    "aztec": {
      "command": "npx",
      "args": ["-y", "aztec-mcp-server@latest"]
    },
    "noir": {
      "command": "npx",
      "args": ["-y", "noir-mcp-server@latest"]
    }
  }
}

OpenAI Codex

Use the same MCP configuration format, pointing at aztec-mcp-server and noir-mcp-server.

For learning and exploration

These resources help you understand Aztec concepts, read docs, or provide additional context to your AI tool.

• API reference docs - The docs site publishes auto-generated API references that are useful to feed to AI tools:

  • Aztec.nr API reference - generated from aztec-nr source with nargo doc
  • TypeScript API reference - generated from yarn-project packages with TypeDoc

  These are especially useful as context for code generation since they reflect the current API surface.

• llms.txt - The docs site publishes llms.txt and llms-full.txt at docs.aztec.network/llms.txt for automatic LLM discovery. Many AI tools can consume these files directly to index documentation.

• Reference repositories - Point your AI tool at these repos for additional context:

  • AztecProtocol/aztec-packages - main monorepo, best general reference
  • AztecProtocol/aztec-starter - smaller starter project, easier for onboarding
  • AztecProtocol/aztec-examples - official contract examples
  • noir-lang/noir - Noir language source of truth
  • noir-lang/noir-examples - common Noir patterns
  • awesome-noir - community Noir resources
  • awesome-aztec - community Aztec resources

• Copy docs into context - Copy docs pages directly into your AI tool's context or conversation using the "Copy page" button at the top of each page.

• Context7 - Context7 is a generic MCP server with Aztec docs available at context7.com/aztecprotocol/aztec-packages. Note that it may be less current than the MCP servers above.

Aztec and Noir tool reference

Tool	Works with	Description
aztec-claude-plugin	Claude Code	Skills, commands, agents, and MCP server for Aztec contract and TypeScript development
aztec-mcp-server	Any MCP client (Claude Code, Cursor, Windsurf, Codex)	Clones Aztec repos locally, provides code search, doc search, and example discovery
noir-claude-plugin	Claude Code	Skills and commands for Noir circuit development
noir-mcp-server	Any MCP client	Clones Noir repos, stdlib, and community libraries; provides search and examples
aztec-skills	Claude Code, Codex	Installable skills for Aztec contracts, deployment, Aztec.js, and testing
noir skills	Claude Code, Codex	Skills for Noir compiler development, SSA debugging, fuzzing, and ACIR optimization