Enables stacking STX tokens to earn Bitcoin rewards through the Proof-of-Transfer (PoX) mechanism, including checking stacking status, APY information, and delegating to stacking pools.
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., "@Stacks MCP Serverswap 100 STX for ALEX tokens on the Alex DEX"
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.
Stacks Agent
AI Skill for building Stacks blockchain applications - Bitcoin's most powerful smart contract layer
An intelligent AI assistant that provides development guidance for Clarity smart contracts, DeFi integration, and blockchain development on Stacks. Works with Claude Code, Cursor, Windsurf, Antigravity, GitHub Copilot, Kiro, and Codex.
✨ Features
🔷 61 Clarity Functions - Complete language reference with examples
📋 14 Contract Templates - SIP-010, SIP-009, DAO, Vault, Marketplace, Stacking
🔐 15 Security Patterns - Common vulnerabilities and fixes
🔄 15 DeFi Protocols - Alex, Velar, Bitflow, Zest, StackingDAO, Boost, Faktory
⚛️ 30 Stacks.js Snippets - Wallet, transactions, API integration
🌐 10 BNS Operations - Name registration and resolution
💰 15 Stacking Guides - PoX stacking and pool delegation
🚀 25 Deployment Steps - Testnet, mainnet, and devnet workflows
🎯 Use Cases
Generate Clarity smart contracts from natural language
Audit contracts for security vulnerabilities
Integrate with DeFi protocols (swaps, liquidity, lending)
Deploy to testnet/mainnet
Build dApps with Stacks.js
Implement stacking and BNS features
📦 Installation
Using CLI (Recommended)
Manual Installation
Copy the appropriate folders to your project:
AI Assistant | Folders to Copy |
Claude Code |
|
Cursor |
|
Windsurf |
|
Antigravity |
|
GitHub Copilot |
|
Kiro |
|
Codex |
|
🚀 Usage
Claude Code
The skill activates automatically when you request Stacks development work:
Cursor / Windsurf / Antigravity
Use the slash command:
GitHub Copilot
Reference in chat:
💡 Example Prompts
🔍 Knowledge Base Search
The skill includes a powerful BM25-based search engine:
Available domains:
clarity- Syntax and functionstemplates- Contract templatessecurity- Security patternsdefi- DeFi protocolsstacksjs- JavaScript snippetsbns- BNS operationsstacking- Stacking guidesdeployment- Deployment stepsauto- Auto-detect (default)
📚 Knowledge Base Contents
Clarity Language (61 entries)
Types, functions, control flow, arithmetic, comparisons, maps, tokens, STX operations
Contract Templates (14 entries)
Tokens: SIP-010 basic, mintable, burnable, capped
NFTs: SIP-009 basic, mintable, royalties
DeFi: Vault basic/timelocked, liquidity pool
DAO: Basic DAO, treasury management
Other: Marketplace, stacking pool
Security Patterns (15 entries)
Critical: Access control, unchecked transfers
High: Reentrancy, arithmetic safety
Medium: Input validation, front-running
Low: Code style, gas optimization
DeFi Protocols (15 entries)
Alex, Velar, Bitflow, Zest, StackingDAO, Boost, Faktory integration patterns
Stacks.js (30 entries)
Wallet connection, transactions, Clarity values, API calls, post-conditions
BNS (10 entries)
Name resolution, registration, transfer, updates
Stacking (15 entries)
Direct stacking, delegation, pools, rewards
Deployment (25 entries)
Testnet, mainnet, devnet workflows with Clarinet
🛡️ Security Best Practices
All generated contracts include:
✅ Access control (
tx-sendervalidation)✅ Error handling (
try!,unwrap!)✅ Input validation (
asserts!)✅ Named error constants
✅ Kebab-case naming
✅ Network compatibility checks
🌐 Networks
Mainnet: Production (SP... addresses)
Testnet: Testing (ST... addresses, free STX)
Devnet: Local development (Clarinet)
🔧 Prerequisites
Python 3.x (for search functionality)
Node.js 18+ (for CLI installation)
📖 Documentation
🔗 DeFi Resources
🤝 Contributing
Contributions are welcome! Please:
Fork the repository
Create a feature branch
Make your changes
Add knowledge entries to appropriate CSV files
Test the search functionality
Submit a pull request
📄 License
MIT License - see LICENSE file for details
🙏 Acknowledgments
Built for the Stacks community with:
Stacks.js by Hiro Systems
📞 Support
GitHub Issues: Report bugs or request features
Stacks Discord: Join the community
Twitter: @kai_builder
🎯 Roadmap
Multi-platform AI skill support
170+ knowledge base entries
BM25 search engine
CLI installer
Web-based search interface
VSCode extension
Real-time contract analysis
Community knowledge contributions
Multi-language support
Made with ❤️ for the Stacks community
Build Bitcoin-secured dApps with AI assistance