Rootstock MCP Server

🚀 Rootstock MCP Server

Model Context Protocol server for Rootstock blockchain interactions

The Rootstock MCP Server is a developer- and user-oriented backend service that enables seamless interaction with the Rootstock blockchain using the Model Context Protocol (MCP). This server provides standardized APIs for querying, transacting, and managing assets on Rootstock, making it easy for developers, users, and AI agents to build and integrate with Rootstock-based applications.

� Try It Now

Live Demo on Smithery:

🔧 Explore Tools: View all available tools
💬 Interactive Chat: Try it in the playground

�🌟 Features

Core Capabilities

Standardized MCP Interface: Expose Rootstock blockchain operations via MCP endpoints
Wallet Management: Create, import, and manage multiple wallets
Transaction Operations: Send native tokens and ERC20 tokens
ERC20 Token Deployment: Deploy standard and mintable ERC20 tokens
Token Management: Get token information and mint tokens (for mintable contracts)
Blockchain Queries: Query balances, transactions, blocks, and network information
Smart Contract Interactions: Call and transact with smart contracts
Gas Estimation: Estimate transaction costs before sending

Developer Tools

Comprehensive Documentation: Complete API reference and examples
TypeScript Support: Full type safety and IntelliSense
Error Handling: Detailed error messages nd debugging information
Flexible Configuration: Environment-based configuration system

📋 Requirements

Node.js v18 or higher
npm or yarn package manager
Rootstock blockchain RPC endpoint access

🚀 Quick Start

1. Installation

Option A: Deploy to Smithery (Recommended)

# Install Smithery CLI
npm install -g @smithery/cli

# Login to Smithery
smithery login

# Clone and deploy
git clone https://github.com/cuongpo/rootstock-mcp-server.git
cd rootstock-mcp-server
npm run build:smithery
smithery deploy

Option B: Local Installation

# Clone the repository
git clone https://github.com/cuongpo/rootstock-mcp-server.git
cd rootstock-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

2. Configuration

# Copy the example environment file
cp .env.example .env

# Edit the configuration
nano .env

Configure your environment variables:

# Rootstock Testnet Configuration
ROOTSTOCK_RPC_URL=https://public-node.testnet.rsk.co
ROOTSTOCK_CHAIN_ID=31
ROOTSTOCK_NETWORK_NAME=Rootstock Testnet
ROOTSTOCK_CURRENCY_SYMBOL=tRBTC
ROOTSTOCK_EXPLORER_URL=https://explorer.testnet.rootstock.io

# Wallet Configuration (comma-separated for multiple wallets)
ROOTSTOCK_PRIVATE_KEYS=your_private_key_here
ROOTSTOCK_ADDRESSES=0x742d35Cc6634C0532925a3b8D4C9db96590c6C87
ROOTSTOCK_CURRENT_ADDRESS=0x742d35Cc6634C0532925a3b8D4C9db96590c6C87

3. Usage

Standalone Mode

npm start

Development Mode

npm run dev

MCP Client Integration

Add to your MCP client configuration:

{
  "mcpServers": {
    "rootstock-mcp": {
      "command": "node",
      "args": ["path/to/rootstock-mcp-server/build/index.js"],
      "env": {
        "ROOTSTOCK_RPC_URL": "https://public-node.testnet.rsk.co",
        "ROOTSTOCK_CHAIN_ID": "31",
        "ROOTSTOCK_NETWORK_NAME": "Rootstock Testnet",
        "ROOTSTOCK_CURRENCY_SYMBOL": "tRBTC",
        "ROOTSTOCK_PRIVATE_KEYS": "your_private_key_here",
        "ROOTSTOCK_CURRENT_ADDRESS": "your_address_here"
      }
    }
  }
}

🛠️ Available Tools

Wallet Management

`create_wallet`

Create a new wallet with a generated mnemonic phrase.

Parameters:

name (optional): Wallet name

Example:

{
  "name": "create_wallet",
  "arguments": {
    "name": "MyWallet"
  }
}

`import_wallet`

Import an existing wallet using private key or mnemonic.

Parameters:

privateKey (optional): Private key to import
mnemonic (optional): Mnemonic phrase to import
name (optional): Wallet name

`list_wallets`

List all available wallets.

`set_current_wallet`

Set the active wallet for transactions.

Parameters:

address (required): Wallet address

`get_current_wallet`

Get current active wallet information.

Balance & Transactions

`get_balance`

Get wallet balance (native or ERC20 tokens).

Parameters:

address (required): Wallet address
tokenAddress (optional): ERC20 token contract address

`send_transaction`

Send native tokens or ERC20 tokens.

Parameters:

to (required): Recipient address
amount (required): Amount to send
tokenAddress (optional): ERC20 token contract address
gasLimit (optional): Gas limit
gasPrice (optional): Gas price

`get_transaction`

Get transaction details by hash.

Parameters:

hash (required): Transaction hash

Blockchain Queries

`get_block`

Get block information.

Parameters:

blockNumber (optional): Block number
blockHash (optional): Block hash

`get_network_info`

Get current network information and status.

`estimate_gas`

Estimate gas cost for a transaction.

Parameters:

to (required): Recipient address
value (optional): Value to send
data (optional): Transaction data

Smart Contracts

`call_contract`

Call a smart contract method (read-only).

Parameters:

contractAddress (required): Contract address
methodName (required): Method name
parameters (optional): Method parameters
abi (optional): Contract ABI

`send_contract_transaction`

Send a transaction to a smart contract.

Parameters:

contractAddress (required): Contract address
methodName (required): Method name
parameters (optional): Method parameters
abi (optional): Contract ABI
value (optional): Ether value to send
gasLimit (optional): Gas limit
gasPrice (optional): Gas price

ERC20 Token Management

`deploy_erc20_token`

Deploy a new ERC20 token contract.

Parameters:

name (required): Token name (e.g., "My Token")
symbol (required): Token symbol (e.g., "MTK")
decimals (optional): Token decimals (default: 18)
initialSupply (required): Initial token supply
mintable (optional): Whether the token should be mintable (default: false)
gasLimit (optional): Gas limit
gasPrice (optional): Gas price

Example:

{
  "name": "deploy_erc20_token",
  "arguments": {
    "name": "My Token",
    "symbol": "MTK",
    "decimals": 18,
    "initialSupply": "1000000",
    "mintable": true
  }
}

`get_token_info`

Get information about an ERC20 token.

Parameters:

tokenAddress (required): ERC20 token contract address

Example:

{
  "name": "get_token_info",
  "arguments": {
    "tokenAddress": "0x742d35Cc6634C0532925a3b8D4C9db96590c6C87"
  }
}

`mint_tokens`

Mint tokens (only for mintable tokens).

Parameters:

tokenAddress (required): ERC20 token contract address
to (required): Address to mint tokens to
amount (required): Amount of tokens to mint
gasLimit (optional): Gas limit
gasPrice (optional): Gas price

Example:

{
  "name": "mint_tokens",
  "arguments": {
    "tokenAddress": "0x742d35Cc6634C0532925a3b8D4C9db96590c6C87",
    "to": "0x1234567890123456789012345678901234567890",
    "amount": "1000"
  }
}

🏗️ Development

Project Structure

rootstock-mcp-server/
├── src/
│   ├── index.ts              # Main MCP server
│   ├── rootstock-client.ts   # Blockchain client
│   ├── wallet-manager.ts     # Wallet management
│   └── types.ts              # Type definitions
├── build/                    # Compiled JavaScript
├── docs/                     # Documentation
├── examples/                 # Example code
├── package.json
├── tsconfig.json
└── README.md

Scripts

# Development
npm run dev          # Run in development mode
npm run build        # Build TypeScript
npm run start        # Run built version

# Code Quality
npm run lint         # Run ESLint
npm run format       # Format with Prettier
npm test            # Run tests

Contributing

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Commit your changes: git commit -m 'Add amazing feature'
Push to the branch: git push origin feature/amazing-feature
Open a Pull Request

🔒 Security

Private Keys: Never commit private keys to version control
Environment Variables: Use .env files for sensitive configuration
Network Security: Use HTTPS endpoints in production
Wallet Security: Store mnemonic phrases securel

📚 Documentation

🤝 Community

Developers: Contribute to backend or frontend development, API design, or documentation
Testers: Help stress-test the gateway, identify bugs, and provide UX feedback
Content Creators: Assist with user guides, tutorials, and community outreach
Community Support: Help onboard new users and foster engagement

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Model Context Protocol for the standardized interface
Ethers.js for Ethereum interactions
The Rootstock blockchain community

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

A backend service that enables seamless interaction with the Rootstock blockchain using the Model Context Protocol, providing standardized APIs for querying, transacting, and managing assets on Rootstock.

Related MCP Servers

MCP Blockchain Query Server
pavel-bc
-
security
F
license
-
quality
A Model Context Protocol server providing tools for querying Bitcoin blockchain data via Blockchain Data and Query APIs, supporting various BTC information retrieval functions.
Last updated -
Python
RootData MCP Server
jincai
-
security
F
license
-
quality
A Model Context Protocol server that allows AI assistants like Claude to directly query cryptocurrency and blockchain project data from RootData, including project information, organization details, and search results.
Last updated -
4
Python
Blockscout MCP Serverofficial
blockscout
A
security
A
license
A
quality
A server that exposes blockchain data (balances, tokens, NFTs, contract metadata) via the Model Context Protocol, enabling AI agents and tools to access and analyze blockchain information contextually.
Last updated -
16
10
Python
MIT License
Stampchain MCP Serverofficial
stampchain-io
-
security
A
license
-
quality
A Model Context Protocol server that enables interaction with Bitcoin Stamps data via the Stampchain API, providing tools for querying stamp information, collections, and blockchain data without requiring authentication.
Last updated -
TypeScript
MIT License

View all related MCP servers