Simplicity MCP

First AI-native development platform for Simplicity smart contracts. Deploy, compile, and interact with contracts using natural language through Cursor AI - transforming workflows into conversations.

Comment 1

Inspiration

I got frustrated juggling multiple terminals and tools just to deploy a simple Simplicity contract. I thought: "Why can't I just tell my AI assistant to do this?" When I discovered MCP, I realized I could make it happen.

What I Learned

  • How Simplicity's dual-binary architecture works (hal-simplicity branches)
  • PSET workflow for signing complex transactions
  • Making blockchain tools accessible through natural language with MCP
  • The importance of good error messages when AI is the interface

How I Built It

  1. Core Integration - Built TypeScript MCP server wrapping simc and hal-simplicity tools
  2. 49 MCP Tools - Created tools for compilation, signing, blockchain queries, and deployment
  3. Smart Examples - Wrote 5 production-ready contracts (HTLC, multisig, vault, timelock)
  4. Zero-Config Setup - One command installs everything using Esplora API (no Docker needed)
  5. Testing - 109 tests ensuring reliability

Key Decision: Direct Esplora API connection instead of Docker = instant setup for anyone.

Challenges Faced

Binary Compatibility - hal-simplicity has multiple branches with different features. Fixed by implementing intelligent binary selection.

npm Link Failures - Global command wouldn't install reliably. Switched to direct absolute paths in MCP config.

PSET Complexity - Limited docs on signing workflow. Studied source code and built step-by-step implementation.

AI-Friendly Outputs - Blockchain tools output raw hex. Added parsing and formatting layers for readable responses.

Result: Simplicity contracts deployable through conversation in 30 seconds instead of 30 minutes.

Built With

Share this project:

Updates