Stacks Clarity MCP Server (Unofficial)

A comprehensive MCP (Model Context Protocol) server for Stacks blockchain development, providing 30+ specialized tools for Clarity smart contracts, SIP compliance, security, and performance optimization.

another one brought to you by

💡 New to MCP? Check out our integration guides for step-by-step setup instructions for Cursor, Claude Code, or local development.

🚀 Overview

This comprehensive MCP server provides a complete Stacks development toolkit, implementing TIER 1 and TIER 2 priorities for professional Stacks dApp development with security-first patterns and SIP compliance.

Key Features

• 🏗️ Complete SIP Standards Access - All 30+ SIP standards with full Clarity code
• 🔐 Security-First Development - Mandatory post-conditions for all token transfers
• ⚡ SIP-012 Performance Optimization - 2x database capacity and dynamic storage
• 🎨 Token Standards - Full SIP-009 (NFT) and SIP-010 (FT) implementations
• 🧪 Comprehensive Testing - Unit, integration, and security test generation
• 🔧 Clarinet Integration - Complete project setup and management tools
• 💰 Account Management - STX balances, transaction history, and validation
• 📚 Complete Documentation - Clarity Book, SIP standards, and integration guides

📋 Prerequisites

• Node.js and npm (npm ≥ 5.2.0)
• Clarinet CLI (for contract development)
• Stacks wallet (for frontend integration)
• Cursor IDE or Claude Code (for MCP integration)

🛠️ Quick Setup for Cursor/Claude Code

Option 1: Use Published Package (When Available)

Once published to npm, create .cursor/mcp.json in your project:

{
  "mcpServers": {
    "stacks-clarity-mcp": {
      "command": "npx",
      "args": ["-y", "@stacks/stacks-clarity-mcp"],
      "env": {
        "HIRO_API_KEY": "",
        "STACKS_NETWORK": "testnet"
      }
    }
  }
}

Option 2: Local Development Setup (Current)

1. Clone and install:

git clone https://github.com/YOUR_USERNAME/stacks-clarity-mcp.git
cd stacks-clarity-mcp
npm install

2. Build the project:

npm run build

Note: This generates the dist/ folder with compiled JavaScript. The build is required before running the server.

3. Configure Cursor - Create .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "stacks-clarity-mcp": {
      "command": "npx",
      "args": ["-y", "tsx", "/absolute/path/to/stacks-clarity-mcp/src/server.ts"],
      "env": {
        "HIRO_API_KEY": "",
        "STACKS_NETWORK": "testnet"
      }
    }
  }
}

Important: Replace /absolute/path/to/stacks-clarity-mcp with your actual path!