What is Mantrachain Mcp

MantraChain MCP is a Model Context Protocol (MCP) server designed for interacting with the MantraChain blockchain, which is built on the Cosmos SDK. It provides various tools for managing tokens, delegating to validators, and querying blockchain information.

Use cases

Use cases include token transfers between addresses, staking tokens to earn rewards, querying account balances, executing smart contract functions, and simulating token swaps in decentralized exchanges.

How to use

To use MantraChain MCP, you can interact with its various tools through command-line operations or API calls. Users can send tokens, delegate to validators, and query balances by executing specific commands.

Key features

Key features include sending tokens, delegating tokens to validators, querying account balances, retrieving validator information, signing and broadcasting transactions, and configuring settings through environment variables. It supports both Dukong testnet and Mainnet.

Where to use

MantraChain MCP can be used in blockchain applications, decentralized finance (DeFi) platforms, and any projects that require interaction with the MantraChain blockchain for token management and staking operations.

MantraChain MCP Server

A Model Context Protocol (MCP) server for interacting with MantraChain (Cosmos SDK) blockchain. This server provides tools for sending tokens, delegating to validators, querying balances, and more using the MCP protocol.

Features

• Send tokens to other addresses (bank send)
• Delegate tokens to validators (staking)
• Query account balances
• Get validator information
• Sign and broadcast arbitrary transactions
• Configure mnemonic and network via environment variables
• Choose between Dukong testnet and Mainnet
• Supports both stdio and HTTP+SSE transport modes

Available Tools

Bank Operations

• bank-send: Send tokens to another address
• get-balance: Get balance of an address (defaults to your own address if none provided)

Staking Operations

• delegate: Delegate/Stake tokens to a validator
• undelegate: Undelegate/Unstake tokens from a validator
• claim-rewards: Claim rewards for a specific validator
• get-validators: Get all validators
• get-delegations: Get current staking information for 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: Execute a generic network query against chain APIs

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-execute: Execute a function on a smart contract that changes state

DEX Operations

• dex-get-pools: Get all available liquidity pools from the DEX
• dex-find-routes: Find available swap routes between two tokens
• dex-simulate-swap: Simulate a token swap to get expected outcome without executing it
• dex-swap: Execute a token swap on the DEX with slippage protection

Transaction Operations

• sign-and-broadcast: Sign and broadcast a generic transaction

Available Resources

• networks://all: JSON resource showing all available networks with their configuration
• openapi://{networkName}: OpenAPI/Swagger specification for the specified network

Running the Server

The server can run in two modes:

1. Stdio Mode (Default): Communicates over standard input/output. This is the default mode when running the server directly or via npx.

   # Using installed package
   mantrachain-mcp
   
   # Using npx
   npx -y mantrachain-mcp@latest
   
   

2. HTTP+SSE Mode: Runs an HTTP server on port 3000, communicating via Server-Sent Events (SSE). Activate this mode using the -r flag or the dedicated npm scripts.

   # Using installed package
   mantrachain-mcp -r
   
   # Using npx
   export MNEMONIC="YOUR_MNEMONIC"
   export CUSTOM_NETWORKS="YOUR_CUSTOM_NETWORKS_JSON"
   npx -y mantrachain-mcp@latest -- -r
   
   

   When running in HTTP mode, the server listens on:

   • GET /sse: Establishes the SSE connection.
   • POST /messages?sessionId=<id>: Receives client requests.

MCP Configuration

Installing via Smithery

To install MantraChain MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @allthatjazzleo/mantrachain-mcp --client claude

To integrate with MCP client applications, add the server configuration to your MCP client configuration file:

{
  "mcpServers": {
    "mantrachain-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mantrachain-mcp@latest"
      ],
      "env": {
        "MNEMONIC": "YOUR_MNEMONIC",
        "CUSTOM_NETWORKS": "{\"my-custom-net\":{\"rpcEndpoint\":\"https://rpc.custom-network.io\",\"apiEndpoint\":\"https://api.custom-network.io\",\"chainId\":\"my-custom-net-1\",\"prefix\":\"custom\",\"denom\":\"ucustom\",\"gasPrice\":\"0.01\",\"isMainnet\":false}}"
      }
    }
  }
}

Connecting remote MCP server in cline:

{
  "mcpServers": {
    "mantrachain-mcp-sse": {
      "url": "http://localhost:3000/sse",
      "transportType": "sse"
    }
  }
}

If you build the package locally instead of globally

After building the package, you can run it directly from the build directory. Make sure to replace your_path with the actual path to your build directory.

npm run build

Then, you can use the following configuration:

{
  "mcpServers": {
    "mantrachain-mcp": {
      "command": "node",
      "args": [
        "your_path/mantrachain-mcp/build/index.js"
      ],
      "env": {
        "MNEMONIC": "YOUR_MNEMONIC"
      }
    }
  }
}

Environment Variables

• MNEMONIC: Required. The mnemonic seed phrase for the wallet to use.
• CUSTOM_NETWORKS: Optional. JSON string containing additional network configurations.