Nacre add to your ai
docs / documentation

Docs

Overview

Nacre is a remote MCP server. Your AI client connects to one endpoint and gets tools to inspect the chain, check transactions before they are signed, and prepare transactions for your wallet. Every check that runs is listed on What gets checked. Nacre never holds a key. Anything that changes the chain ends as a signing link that you open and sign yourself.

Network

Nacre is built for Zero by LayerZero. Until Zero mainnet is public, the gateway runs on the Sepolia test network so you can use every tool today with test ETH. On the day Zero opens, the same endpoint switches network; clients keep working without changes.

Now
NetworkSepolia (chain 11155111)
Endpointhttps://mcp.usenacre.xyz/zero
TransportMCP over streamable HTTP, JSON responses
Explorersepolia.etherscan.io

Quickstart

Claude Code. Run once: claude mcp add --transport http nacre https://mcp.usenacre.xyz/zero. Check with claude mcp list.

Claude. Open Customize, then Connectors, choose Add custom connector, name it Nacre and paste the endpoint.

Cursor. Add to ~/.cursor/mcp.json: {"mcpServers":{"nacre":{"url":"https://mcp.usenacre.xyz/zero"}}}

VS Code. Run MCP: Add Server, choose HTTP and paste the endpoint.

ChatGPT. Settings, Apps, Advanced settings, turn on Developer mode, Create app, paste the endpoint.

Client menus move between versions. If a step does not match, look for where your client adds a remote MCP server.

First requests

  • “Which network are you on, and what is the latest block?”
  • “What does 0xfFf9976782d46CC05630D1f6eBAb18b2324d6B14 hold, and what token is it?”
  • “Explain this transaction: 0x…”
  • “Send 0.001 ETH from my wallet 0x… to 0x…, simulate it first and give me the signing link.”

More in the prompt library.

Signing links

prepare_transaction and prepare_deploy simulate the transaction and return a signing_link. It opens the signing page, which simulates every step again, explains it, refuses to continue if anything would fail or carries an unlimited approval, and only then asks your wallet. The link carries the transaction in its fragment, so it never reaches a server.

Keys and limits

No key is needed. Without one, each address gets 60 calls a minute. With a key, 1,000, plus usage per key. Make keys on the keys page by signing a message, and send one as Authorization: Bearer nacre_…. A wallet can hold five active keys; revoked keys stop working at once.

Errors

Tool errors come back as a normal result with isError: true and a message written for the AI to pass on, for example “Rate limit reached” or “The simulation reverted, so nothing was prepared”. Protocol errors use JSON-RPC codes: -32601 unknown method, -32602 unknown tool, -32700 unreadable request.

Tool reference

Loading…

Run your own

The gateway is a Cloudflare Worker in gateway/. To run it locally: npm.cmd install then npm.cmd run dev inside gateway, and point a client at http://localhost:8799/zero. The network is four settings in wrangler.toml: CHAIN_ID, CHAIN_NAME, RPC_URL and EXPLORER.