home / mcp / stability mcp server

Stability MCP Server

Stability Model Context Protocol (MCP) - AI agents + blockchain with zero gas fees

Installation

Add the following to your MCP client configuration file.

Configuration

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

You can run and interact with Stability MCP Server to enable AI agents to communicate with the Stability Protocol without gas fees. This server provides a self-contained runtime, tooling, and SDK to post messages, read and write contracts, and deploy new contracts in a Docker-based deployment that’s easy to integrate with existing MCP hosts and clients.

How to use

To use the Stability MCP Server, run it as a local stdio-based MCP server and connect your MCP client or Claude Desktop to the server through the defined command pattern. You will be able to post messages to the blockchain, read and write smart contracts, and deploy new contracts through the server’s exposed tooling. Use the server with the provided SDK for TypeScript/JavaScript integration to achieve type-safe, straightforward interactions with Stability’s MCP host.

How to install

Prerequisites you need to have installed on your machine before starting:

Docker
Node.js 18+
Python 3.8+
Foundry (for contracts)

Step by step you can set up and run the MCP server:

# Install the JavaScript/TypeScript SDK (optional but recommended for integration)
npm install @stbl/mcp

# Run the MCP Server using Docker with your Stability API key
# Replace your-key with your actual API key
```

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

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

Additional notes

This server version is Docker-first and designed to be integrated with MCP hosts. It includes a single executable that provides Stability blockchain tools and ships with an SDK for easy client integration. If you need to run multiple MCP instances, you can manage them through the host orchestrator and the dashboard for monitoring and configuration.

Tools and capabilities

The Stability MCP Server exposes a set of core tools to interact with the Stability Protocol:

Security and configuration

Protect your API keys by keeping them out of version control and using environment-specific configurations. Use the dashboard to manage API keys and access controls for your MCP servers.

Troubleshooting

If the server fails to start, verify that Docker is running, the API key is valid, and your environment variables are correctly passed to the container. Check the server logs for any hints about misconfigurations or missing dependencies.

Available tools

post_message

Post messages to the Stability blockchain through the MCP server.

read_contract

Read data from deployed Stability smart contracts to retrieve state and events.

write_contract

Write transactions to Stability contracts to modify state or trigger actions.

deploy_contract

Deploy new smart contracts onto the Stability Protocol via the MCP server.