🚀 Mantrachain MCP Server

A Model Context Protocol (MCP) server for interacting with the Mantrachain (Cosmos SDK) blockchain. This server provides functions such as sending tokens, delegating to validators, and querying balances, supporting the MCP protocol.

✨ Features

• Send tokens to other addresses (bank transfer)
• Delegate tokens to validators (staking)
• Query account balance
• Get validator information
• Sign and broadcast arbitrary transactions
• Configure mnemonic and network via environment variables
• Optional Dukong testnet and mainnet
• Support both standard input/output and HTTP+SSE transmission modes

📦 Provided Tools

Banking Operations

• bank-send: Send tokens to other addresses
• get-balance: Get the balance of an address (uses your own address by default if not specified)

Staking Operations

• delegate: Delegate/stake tokens to a validator
• undelegate: Undelegate/unstake tokens
• claim-rewards: Claim rewards for a specific validator
• get-validators: Get all validators
• get-delegations: Get the current staking information of an address
• get-available-rewards: Get all available rewards for an address

Network Operations

• get-account-info: Get current account information
• get-block-info: Get block information
• query-network: Perform general network queries on the chain API

IBC Operations

• ibc-transfer: Send tokens via IBC transfer

Smart Contract Operations

• contract-query: Query a smart contract by executing a read-only function
• contract-interact: Interact with a smart contract
• contract-deploy: Deploy a smart contract

Other Tools

• keygen: Generate mnemonic and key pair
• mnemonic-backup: Backup mnemonic
• tx-signer: Transaction signing tool

Environment Variables

Mantrachain MCP Server Documentation

🚀 Quick Start

Installation

Global Installation (Recommended)

npm install -g mantrachain-mcp-server

Local Build

git clone [repository URL]
cd mantrachain-mcp-server
npm install

Starting the Server

After installation, start the MCP server with the following command:

mantrachain-mcp-server start

By default, the server runs on localhost:3001.

Configuring Environment Variables

Before starting the server, make sure to set the necessary environment variables:

# Example configuration
export MNEMONIC="your_mnemonic_phrase"
export CUSTOM_NETWORKS='{
  "testnet": {
    "chainId": "test-chain-1",
    "rpcUrl": "http://localhost:26657"
  }
}'

💻 Usage Examples

Basic Usage

# Send tokens
mantrachain-mcp-server tx send --from my_wallet --to recipient_address --amount 1000

# Query balance
mantrachain-mcp-server query balance --address my_address

# Delegate to a validator
mantrachain-mcp-server tx delegate --from my_wallet --validator validator_address --amount 2000

Advanced Usage

# Define a custom command (in the configuration file `config/plugins.js`)
module.exports = {
  plugins: [
    {
      name: 'custom-plugin',
      description: 'Custom transaction handler',
      handlers: {
        'tx-custom': {
          method: 'handleCustomTx'
        }
      }
    }
  ]
}

Configuration Files

Core Configuration (config/core.js)

module.exports = {
  mnemonic: process.env.MNEMONIC,
  networks: {
    mainnet: {
      chainId: 'main-chain-1',
      rpcUrl: 'https://main.rpc.provider'
    },
    testnet: {
      chainId: 'test-chain-1',
      rpcUrl: 'http://localhost:26657'
    }
  }
}

Plugin Configuration (config/plugins.js)

module.exports = {
  plugins: [
    {
      name: 'eth-wallet',
      description: 'Ethereum wallet integration',
      handlers: {
        'query-balance': {
          method: 'getBalance'
        }
      }
    }
  ]
}

Tutorial

Lesson 1: Installation and Configuration

1. Install the MCP server:

npm install -g mantrachain-mcp-server

2. Set environment variables:

export MNEMONIC="your_mnemonic_phrase"

3. Start the server:

mantrachain-mcp-server start

Lesson 2: Using the Wallet

1. Generate an address:

mantrachain-mcp-server wallet generate-address --mnemonic your_mnemonic

2. Send tokens:

mantrachain-mcp-server tx send --from my_wallet --to recipient_address --amount 1000

Lesson 3: Staking and Delegation

1. Query validators:

mantrachain-mcp-server query validators

2. Delegate to a specified validator:

mantrachain-mcp-server tx delegate --from my_wallet --validator validator_address --amount 2000

📚 Documentation

Reference Documentation

• Core Configuration
• Plugin System
• Command Line Interface

Tutorials

• Quick Start
• Advanced Topics
• Custom Networks

🤝 Contribution Guidelines

Community contributions are welcome! Please refer to the Contribution Guidelines to learn how to participate in the development.

Thank you for using mantrachain-mcp-server. We look forward to your feedback and collaboration.