Supports Git-based project management with Clarinet project initialization, contract versioning, and development workflow integration for Stacks blockchain projects.
Integrates with GitHub for accessing the complete repository of 30+ SIP (Stacks Improvement Proposals) standards and maintaining Stacks development project repositories.
Compiles to JavaScript for runtime execution and provides tools for JavaScript-based Stacks frontend development with wallet connectivity and transaction signing.
Built on Node.js runtime with TypeScript, providing 30+ specialized tools for Stacks blockchain development, smart contract creation, and dApp development workflow management.
Distributed as an npm package for easy installation and integration with development environments, supporting both published package installation and local development setup.
Provides frontend development tools and guidance for building React-based Stacks dApps with wallet integration using @stacks/connect library and proper transaction handling.
Implemented in TypeScript with full type safety for Stacks blockchain operations, Clarity smart contract development, and comprehensive SIP standards compliance tooling.
Stacks Clarity MCP Server
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.
π‘ 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:
Option 2: Local Development Setup (Current)
Clone and install:
Build the project:
Note: This generates the
dist/
folder with compiled JavaScript. The build is required before running the server.
Configure Cursor - Create
.cursor/mcp.json
in your project root:
Important: Replace
/absolute/path/to/stacks-clarity-mcp
with your actual path!
Restart Cursor completely (quit and reopen)
Verify Setup:
Go to
Cursor β Settings β MCP
Look for green indicator next to
stacks-clarity-mcp
Switch to Agent mode in chat
Test with: "list available stacks tools"
Network Options
mainnet
- Production Stacks networktestnet
- Test network with free tokensdevnet
- Local development with Clarinet
Get Hiro API Key (Optional)
For enhanced features and higher rate limits:
Visit platform.hiro.so
Create an account and generate an API key
Add to
HIRO_API_KEY
in your config
π Detailed guides: See integration_guides/
folder for Cursor, Claude Code, and Development setup.
π¦ What's Included in the Repository
Included (pushed to GitHub):
β
src/
- TypeScript source code (452KB)β
stacks-clarity-standards/
- All 30+ SIP standards (9.2MB)β
integration_guides/
- Setup documentationβ
package.json
,tsconfig.json
- Configuration files
Excluded (not pushed):
β
node_modules/
- Dependencies (165MB) - install withnpm install
β
dist/
- Build output (448KB) - generate withnpm run build
β
.cursor/
- Local MCP configβ
.env
- Environment variables
Setup Requirement: After cloning, you must run
npm install
andnpm run build
before using the MCP server.
π Available Tools (32 Total)
π Standards & Documentation (5 tools)
list_sips
- Discover all available SIP standardsget_sip
- Get specific SIP content (SIP-009, SIP-010, etc.)get_clarity_book
- Complete Clarity language reference (34,000+ lines)get_token_standards
- Essential SIP-009/SIP-010 standardssearch_sips
- Search SIPs by topic
πͺ Token Development (8 tools)
SIP-010 Fungible Tokens
get_sip010_info
- Token contract information and metadataget_sip010_balance
- Check FT balances for addressesgenerate_sip010_transfer
- Create transfer transactions with post-conditionsgenerate_sip010_template
- Generate complete SIP-010 compliant contracts
SIP-009 Non-Fungible Tokens
get_sip009_token_info
- NFT information and metadataget_sip009_collection_info
- Collection-level informationgenerate_sip009_transfer
- Create NFT transfers with post-conditionsgenerate_sip009_template
- Generate complete SIP-009 compliant contracts
π Security & Post-Conditions (5 tools)
generate_fungible_post_condition
- Mandatory FT post-conditionsgenerate_nonfungible_post_condition
- Mandatory NFT post-conditionsgenerate_stx_post_condition
- STX transfer post-conditionsanalyze_transaction_post_conditions
- Validate transaction securitygenerate_post_condition_template
- Security templates and patterns
β‘ Performance Optimization - SIP-012 (3 tools)
analyze_contract_performance
- Comprehensive performance analysisestimate_operation_cost
- Cost estimation for Clarity operationsgenerate_optimization_recommendations
- SIP-012 optimization strategies
π€ Account Management (4 tools)
get_stacks_account_info
- Comprehensive account informationcheck_stx_balance
- Simple STX and token balance checksget_transaction_history
- Account transaction history with paginationvalidate_stacks_address
- Address format and network validation
π§ͺ Development & Testing (4 tools)
generate_clarinet_project
- Complete Clarinet project setupgenerate_clarity_contract
- SIP-compliant contract generationgenerate_contract_tests
- Unit, integration, and security testsconfigure_clarinet_project
- Network and environment configuration
π¨ Frontend Development (3 tools)
build_clarity_smart_contract
- Smart contract development guidancebuild_stacks_frontend
- Frontend integration with @stacks/connectbuild_stacks_dapp
- Complete full-stack development guide
π Quick Start Guide
1. Explore Available Standards
2. Build a SIP-010 Token
3. Set Up Development Environment
π Security Features
Mandatory Post-Conditions
All token transfers MUST include post-conditions. The MCP server enforces this:
SIP Compliance Enforcement
Automatic SIP-009 and SIP-010 compliance checking
Native asset function usage (ft-transfer?, nft-transfer?)
Proper error handling and authorization patterns
β‘ Performance Optimization
SIP-012 Benefits
2x Database Operations: Increased read/write limits per block
Dynamic List Storage: Pay only for actual data size
Optimized Cost Functions: 100+ improved cost calculations
π Comprehensive Documentation
Access to complete Stacks development resources:
34,000+ lines of Clarity Book documentation
30+ SIP standards with full implementations
Security patterns and best practices
Performance optimization guides
Frontend integration examples
ποΈ Integration Examples
React Frontend with @stacks/connect
DeFi Protocol Development
NFT Marketplace
π§ Development Workflow
Research Standards: Use
list_sips
andget_sip
to understand requirementsGenerate Contracts: Use template tools for SIP-compliant implementations
Security Testing: Generate comprehensive security test suites
Performance Optimization: Analyze and optimize using SIP-012 tools
Frontend Integration: Build user interfaces with wallet connectivity
Deployment: Use Clarinet tools for production deployment
π Production Checklist
β SIP compliance validated
β Mandatory post-conditions implemented
β Security tests passing
β Performance optimized with SIP-012
β Frontend properly integrated
β All tests (unit, integration, security) passing
π Troubleshooting
MCP Server Not Appearing in Cursor
Check MCP Settings:
Go to
Cursor β Settings β Cursor Settings β MCP
Look for
stacks-clarity-mcp
entryCheck if indicator is green (connected) or red (error)
Click on the entry to see error details
Verify Configuration:
Ensure
.cursor/mcp.json
exists in project rootFor local development, use absolute path to
server.ts
Check that Node.js is installed:
node --version
Restart Cursor:
Completely quit Cursor (not just close window)
Reopen Cursor
Wait 10-15 seconds for MCP to initialize
Check Agent Mode:
In Cursor chat, ensure dropdown is set to Agent (not normal chat)
MCP tools only work in Agent mode
Test MCP Connection:
# Test the server directly npx tsx /path/to/server.ts # Or use MCP Inspector npx @modelcontextprotocol/inspector
Common Issues
"Command not found": Make sure you're using npx tsx
not just tsx
"Module not found": Run npm install
in the MCP server directory
Build errors: For local development, use tsx
to run from source (skips build step)
Tools not visible: Ensure you're in Agent mode and the MCP shows green indicator
Getting Help
Check integration guides for detailed setup
Review development_usage.md for local development
Use MCP Inspector to test tools:
npx @modelcontextprotocol/inspector
π€ Contributing
This MCP server implements the complete Stacks development stack. Contributions should maintain:
Security-first principles
SIP standard compliance
Performance optimization focus
Comprehensive documentation
π License
This project is licensed under the Apache-2.0 License.
π Resources
Built for professional Stacks development with security, performance, and compliance as top priorities.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
Enables comprehensive Stacks blockchain development with 30+ specialized tools for Clarity smart contracts, SIP compliance, security analysis, and performance optimization. Provides complete access to SIP standards, token development templates, security-first patterns with mandatory post-conditions, and full-stack dApp development guidance.
- π Overview
- π Prerequisites
- π οΈ Quick Setup for Cursor/Claude Code
- π¦ What's Included in the Repository
- π Available Tools (32 Total)
- π Quick Start Guide
- π Security Features
- β‘ Performance Optimization
- π Comprehensive Documentation
- ποΈ Integration Examples
- π§ Development Workflow
- π Production Checklist
- π Troubleshooting
- π€ Contributing
- π License
- π Resources