Agoric Dev

This MCP server provides AI assistants with built-in tooling to help you explore, develop, test, and deploy Agoric smart contracts. By exposing a structured set of capabilities through an MCP client, you can accelerate contract development, enforce best practices, and troubleshoot with guided tooling.

How to use

You connect an MCP client to the Agoric Dev MCP Server to access a suite of AI-assisted development tools. Start locally to experiment on your machine, or deploy to the cloud to enable remote access from an MCP client. The server exposes a range of tool categories that cover project setup, core patterns, contract structure, Zoe & ERTP workflows, orchestration, durability, testing, debugging, security, and discovery.

How to install

# Prerequisites
Node.js (LTS) and Yarn installed on your system

# Install dependencies for the server
yarn install

# Run the server locally
yarn start

# Open in your browser
# http://localhost:8787/

Additional sections

Configuration and usage notes help you connect to the MCP server from clients, either locally or remotely. The server can be accessed over HTTP/SSE when deployed or run on your local machine, and you can inspect or proxy the MCP API from an inspector tool to explore available tools.

Useful local and remote connection examples include starting a local proxy to Claude and connecting through a remote Worker URL. The local proxy ensures Claude communicates with the MCP server over HTTP. You can also deploy the server to a cloud environment and connect from remote MCP clients.

If you need to debug, you can restart the client, or connect directly via a command-line helper to verify the server responds as expected.

Configuration blocks you may encounter include local development settings and cloud deployment steps. The following examples show how to integrate with Claude Desktop and how to connect programming agents to the server.

Available tools

Project Setup

Guides to initialize and configure Agoric projects, including scaffolding, dependency management, and project structure.

Core Patterns

Best practices and reusable patterns for building resilient, upgrade-safe contracts and efficient workflows.

Contract Structure

Templates and conventions for organizing smart contracts, modules, and interfaces.

Zoe & ERTP

Guidance on using Zoe for safe contract execution and ERTP for asset handling within Agoric.

Orchestration

Cross-chain orchestration approaches to coordinate actions across multiple domains.

Durability

Durable object patterns and upgrade-safe design principles to sustain long-running contracts.

Testing

Utilities and patterns for contract testing, property checks, and automated verification.

Debugging & Tracing

Tools to trace contract execution, reproduce issues, and diagnose failures.

Security

Security best practices and vulnerability checks to harden contracts and workflows.

Discovery & Help

Documentation access and API discovery helpers to explore available capabilities.