Provides Docker images for easy deployment of the MCP server
Provides a Node.js orchestrator for managing multiple MCP instances with health checking and monitoring
Integrates with OpenAI as an MCP host to enable AI agent interaction with Stability blockchain
Enables interaction with Solidity smart contracts through tools for reading, writing, and deploying contracts on the Stability blockchain
Stability MCP Ecosystem
A complete Model Context Protocol (MCP) implementation for Stability blockchain, enabling AI agents to interact with Stability Protocol without gas fees.
๐๏ธ Architecture
Related MCP server: Flow MCP Server
๐ฏ What This Provides
MCP Server (servers/)
Single executable that provides Stability blockchain tools
Docker images for easy deployment
Tools provided:
post_message- Post messages to blockchainread_contract- Read from smart contractswrite_contract- Write to smart contractsdeploy_contract- Deploy new contracts
SDK (sdk/)
@stbl/mcp- TypeScript/JavaScript packageEasy integration with existing MCP hosts
Type-safe interfaces for all tools
Host Orchestrator (host/)
Node.js application that can run MCP servers
Management interface for multiple MCP instances
Health checking and monitoring
Smart Contracts (contracts/)
Foundry project with Stability Protocol contracts
Test contracts for development
Deployment scripts
Dashboard (dashboard/)
React SPA for monitoring MCP servers
Real-time blockchain interaction logs
Management interface for API keys and configuration
๐ Quick Start
1. Install the SDK
2. Run the MCP Server
3. Use with Claude Desktop
๐ฆ Components
Component | Purpose | Language | Status |
| MCP Server implementation | Python | ๐ง In Progress |
| TypeScript SDK | TypeScript | ๐ Planned |
| Node.js orchestrator | Node.js | ๐ Planned |
| Smart contracts | Solidity | ๐ Planned |
| Management UI | React | ๐ Planned |
| Documentation | Markdown | ๐ Planned |
๐ง Development
Prerequisites
Python 3.8+
Node.js 18+
Docker
Foundry (for contracts)
Setup
๐ฏ Why This Architecture?
Simplified MCP Implementation
Single MCP server instead of complex client/server separation
Docker-first deployment for easy integration
SDK for developers who want to integrate directly
Complete Ecosystem
Not just a server - complete tooling and infrastructure
Production-ready with monitoring, management, and deployment
Developer-friendly with good documentation and examples
Real-world Usage
Works with Claude Desktop out of the box
Integrates with OpenAI and other MCP hosts
Scalable for enterprise deployments
๐ Related Projects
Stability Toolkit - Core Python library
๐ License
MIT License - see LICENSE for details.