Skip to main content
Glama
Stability MCP Server

Stability MCP Server

by nuljui

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

stability-mcp/
β”œβ”€ contracts/          # Solidity smart contracts + Foundry setup
β”œβ”€ host/               # Node.js orchestrator for MCP hosts
β”œβ”€ servers/            # MCP server implementations & Docker images
β”œβ”€ sdk/                # @stbl/mcp - JavaScript/TypeScript SDK
β”œβ”€ dashboard/          # React SPA for monitoring & management
└─ docs/               # Specifications, ADRs, tutorials

Related MCP server: AMOCA Solana 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 blockchain

    • read_contract - Read from smart contracts

    • write_contract - Write to smart contracts

    • deploy_contract - Deploy new contracts

SDK (sdk/)

  • @stbl/mcp - TypeScript/JavaScript package

  • Easy 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

npm install @stbl/mcp

2. Run the MCP Server

docker run -e STABILITY_API_KEY=your-key stbl/mcp-server

3. Use with Claude Desktop

{
  "mcpServers": {
    "stability": {
      "command": "docker",
      "args": ["run", "-e", "STABILITY_API_KEY=your-key", "stbl/mcp-server"]
    }
  }
}

πŸ“¦ Components

Component

Purpose

Language

Status

servers/

MCP Server implementation

Python

πŸ”§ In Progress

sdk/

TypeScript SDK

TypeScript

πŸ“‹ Planned

host/

Node.js orchestrator

Node.js

πŸ“‹ Planned

contracts/

Smart contracts

Solidity

πŸ“‹ Planned

dashboard/

Management UI

React

πŸ“‹ Planned

docs/

Documentation

Markdown

πŸ“‹ Planned

πŸ”§ Development

Prerequisites

  • Python 3.8+

  • Node.js 18+

  • Docker

  • Foundry (for contracts)

Setup

# Install dependencies
pip install -r servers/requirements.txt
npm install

# Run tests
python -m pytest servers/tests/
npm test
# Build Docker images
docker build -t stbl/mcp-server servers/

# Start Node.js MCP server (experimental)
cd servers/node
npm install
npm run start:mcp
cd ../..

🎯 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

πŸ“„ License

MIT License - see LICENSE for details.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI models to interact with the Solana blockchain, providing RPC methods, wallet management, DeFi trading capabilities, and Helius API integration for enhanced Solana development.
      5
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI agents to interact with 30+ Ethereum-compatible blockchain networks, providing services like token transfers, contract interactions, and ENS resolution through a unified interface.
      28
      96 npm
      380
      MIT
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Comprehensive Model Context Protocol server that enables AI agents to interact with 30+ Ethereum-compatible blockchain networks, supporting token transfers, smart contract interactions, and ENS name resolution through a unified interface.
      1
      -