Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Agoric Dev MCP ServerShow me how to create a mint and issuer for a new token using ERTP"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Agoric Dev MCP Server
An MCP (Model Context Protocol) server that provides AI assistants with tools for Agoric smart contract development. This server enables Claude and other MCP-compatible AI assistants to help developers build, test, debug, and deploy smart contracts on the Agoric blockchain.
Features
The server provides tools across 10 categories:
Project Setup - Initialize and configure Agoric projects
Core Patterns - Agoric development patterns and best practices
Contract Structure - Smart contract scaffolding and structure
Zoe & ERTP - Zoe contract framework and ERTP asset handling
Orchestration - Cross-chain orchestration capabilities
Durability - Durable object patterns for upgrade-safe contracts
Testing - Contract testing utilities and patterns
Debugging & Tracing - Debug and trace contract execution
Security - Security best practices and vulnerability checks
Discovery & Help - Documentation and API discovery
Quick Start (Claude Code)
For local development, use http://localhost:8787/sse instead.
Develop locally
You should be able to open http://localhost:8787/ in your browser
Connect the MCP inspector to your server
To explore your new MCP api, you can use the MCP Inspector.
Start it with
npx @modelcontextprotocol/inspectorWithin the inspector, switch the Transport Type to
SSEand enterhttp://localhost:8787/sseas the URL of the MCP server to connect to, and click "Connect"You will navigate to a (mock) user/password login screen. Input any email and pass to login.
You should be redirected back to the MCP Inspector and you can now list and call any defined tools!
Connect Claude Desktop to your local MCP server
The MCP inspector is great, but we really want to connect this to Claude! Follow Anthropic's Quickstart and within Claude Desktop go to Settings > Developer > Edit Config to find your configuration file.
Open the file in your text editor and replace it with this configuration:
This will run a local proxy and let Claude talk to your MCP server over HTTP
When you open Claude a browser window should open and allow you to login. You should see the tools available in the bottom right. Given the right prompt Claude should ask to call the tool.
Deploy to Cloudflare
npx wrangler kv namespace create OAUTH_KVFollow the guidance to add the kv namespace ID to
wrangler.jsoncnpm run deploy
Call your newly deployed remote MCP server from a remote MCP client
Just like you did above in "Develop locally", run the MCP inspector:
npx @modelcontextprotocol/inspector@latest
Then enter the workers.dev URL (ex: worker-name.account-name.workers.dev/sse) of your Worker in the inspector as the URL of the MCP server to connect to, and click "Connect".
You've now connected to your MCP server from a remote MCP client.
Connect Claude Desktop to your remote MCP server
Update the Claude configuration file to point to your workers.dev URL (ex: worker-name.account-name.workers.dev/sse) and restart Claude
Debugging
Should anything go wrong it can be helpful to restart Claude, or to try connecting directly to your MCP server on the command line with the following command.
In some rare cases it may help to clear the files added to ~/.mcp-auth