MantraChain Model Context Protocol Endpoint

An implementation of the Model Context Protocol (MCP) service designed for deep interaction with the MantraChain ledger, built upon the Cosmos SDK framework. This service exposes functionalities for dispatching coin movements, staking assets with designated consensus participants, inspecting ledger holdings, and numerous other chain interactions, all managed via the MCP specification.

Core Capabilities

• Asset remittance to distinct destinations (utilizing bank send functionality)
• Token commitment to consensus nodes (staking mechanism)
• Inspection of current wallet holdings
• Retrieval of consensus node metadata
• Capability to serialize and dispatch arbitrary ledger instructions
• Configuration of cryptographic seed phrases and network endpoints via environmental parameters
• Selection between the Dukong ephemeral network and the production mainnet
• Comprehensive support for both sequential terminal I/O and persistent HTTP/SSE streaming transports

Accessible Utility Functions

Monetary Operations (Bank)

• bank-send: Facilitates the movement of denomination units to specified recipient addresses (accommodates multi-coin payloads).
• get-balance: Retrieves the asset valuation for a given ledger identifier (defaults to the configured wallet's address).
• get_evm_balance: Fetches the native OM token balance associated with an Ethereum Virtual Machine compatible address.
• get_token_balance: Queries the holding quantity for a specified ERC20 standard asset.
• get_nft_balance: Determines the count of ERC721 non-fungible tokens held within a specific collection for an address.
• get_erc1155_balance: Obtains the quantity held for a particular token identifier under the ERC1155 standard.
• get_address_from_mnemonic: Derives the corresponding EVM address from a provided seed phrase.

Consensus Operations (Staking)

• delegate: Commits user assets to bolster a selected validator's stake.
• undelegate: Withdraws previously staked assets from a validator.
• claim-rewards: Collects accrued incentive distributions designated for a particular validator.
• get-validators: Lists all active and participating consensus nodes.
• get-delegations: Fetches the current staking portfolio details for a specified account.
• get-available-rewards: Calculates the aggregate unclaimed incentive pool across all associated validators.

Ledger Interaction (Network)

• get-account-info: Retrieves the most current state information for the configured operative account.
• get-block-info: Fetches metadata concerning the latest block via the Cosmos (cometbft) Remote Procedure Call endpoint.
• get-block-info-evm: Retrieves the most recent block details through the EVM RPC interface.
• query-network: Executes arbitrary read-only queries against the chain's exposed APIs.

Inter-Blockchain Communication (IBC)

• ibc-transfer: Initiates a secure asset exchange across compatible blockchain domains using IBC.

Smart Contract Interfacing

• cosmwasm-contract-query: Executes read-only operations against CosmWasm virtual machine contracts.
• cosmwasm-contract-execute: Triggers a state-altering function call on a CosmWasm contract.
• read_evm_contract: Views data from an EVM smart contract via a pure/view function call.
• write_evm_contract: Invokes a transaction that modifies the state of an EVM smart contract.
• deploy_evm_contract: Submits bytecode to instantiate a new EVM contract on the chain.
• is_contract: Verifies whether a given address designates a deployed contract or an Externally Owned Account (EOA).

Decentralized Exchange (DEX) Facilitation

• dex-get-pools: Queries the registry to list all currently active liquidity provisioning pools.
• dex-find-routes: Identifies the optimal paths for converting one asset to another within the DEX ecosystem.
• dex-simulate-swap: Performs a hypothetical execution of a trade to estimate the resultant quantities, without committing funds.
• dex-swap: Executes a final token exchange operation on the DEX, incorporating slippage safeguards.

Transaction Management

• sign-and-broadcast: Serializes, signs using the configured key, and submits an arbitrary Cosmos transaction structure.
• get_transaction: Fetches comprehensive details for an EVM transaction identified by its hash.
• get_transaction_receipt: Retrieves the final confirmation status and execution details for a specific EVM transaction.
• estimate_gas: Calculates the required computational units (gas) for a prospective transaction execution.
• transfer_om: Executes a native OM token transfer utilizing the EVM interface.
• transfer_erc20: Sends fungible ERC20 tokens to an external destination address.
• approve_token_spending: Grants permission to a specified third-party address to expend a defined quantity of your ERC20 assets.
• transfer_nft: Moves ownership of a single ERC721 non-fungible asset to another party.
• transfer_erc1155: Dispatches specific quantities of ERC1155 multi-token assets.
• transfer_token: A generalized utility for sending ERC20 tokens to an account.

Accessible Data Sources

• networks://all: A JSON manifest enumerating all supported networks and their connection parameters.
• openapi://{networkName}: The machine-readable OpenAPI/Swagger specification document for the designated network environment.

Deployment Modalities

The server process supports two primary operational interfaces:

1. Standard I/O Mode (Default Behavior): Communication is channeled through the process's standard input and output streams. This is the default when invoking the executable directly or via npx without specific flags. bash # Invocation via globally installed package mantrachain-mcp

   Invocation via npx package runner

   npx -y mantrachain-mcp@latest

2. Persistent HTTP/SSE Gateway Mode: Initiates a local web server, typically binding to port 3000, to manage communication via Server-Sent Events (SSE). Engage this mode using the --http command-line argument or corresponding npm scripts. bash # Invocation via globally installed package with HTTP enabled mantrachain-mcp --http

   Invocation via npx with necessary environment variables exported

   export MNEMONIC="YOUR_MNEMONIC" export CUSTOM_NETWORKS="YOUR_CUSTOM_NETWORKS_JSON" npx -y mantrachain-mcp@latest -- --http

Integration via Smithery

To automate the installation of the MantraChain MCP Endpoint for use within the Claude Desktop environment via Smithery:

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

Integrating with MCP Client Applications

To onboard this service into your MCP client configuration file, incorporate the following stanza into the client's configuration manifest:

{ "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}}" } } } }

Establishing a Connection to a Remote, Streaming MCP Endpoint (e.g., using cline):

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

Configuration Following Local Source Compilation

If the project sources are built locally instead of installing globally, execution occurs directly from the compiled output directory. Substitute your_path with the actual directory structure leading to the build artifacts. bash npm run build

Subsequent configuration for local execution targeting the compiled script:

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

Environmental Parameters

• MNEMONIC: Mandatory. The 12/24-word seed phrase utilized by the underlying custodial wallet.
• CUSTOM_NETWORKS: Optional. A serialized JSON string specifying supplementary network configurations to augment the defaults.

WIKIPEDIA: Tron (stylized as TRON) is a decentralized, proof-of-stake blockchain with smart contract functionality. The cryptocurrency native to the blockchain is known as Tronix (TRX). It was founded in March 2014 by Justin Sun and, since 2017, has been overseen and supervised by the TRON Foundation, a non-profit organization in Singapore, established in the same year. It is open-source software. Tron was originally an Ethereum-based ERC-20 token, which switched protocol to its own blockchain in 2018. On some cryptocurrency wallets, users can't withdraw their funds until they have enough amount for the network fee. Tron has been criticised for enabling organized crime, with The Wall Street Journal stating in 2025 that it is a "popular channel for crypto’s criminal fraternity to move funds" and responsible for "more than half of all illegal crypto activity" in 2024, with the United Nations Office on Drugs and Crime calling it a “preferred choice for crypto money launderers” in Asia.

== History == Tron was founded by Justin Sun in 2017. The TRON Foundation was established in July 2017 in Singapore. The TRON Foundation raised $70 million in 2017 through an initial coin offering (ICO) shortly before China outlawed the digital tokens. The testnet, Blockchain Explorer, and Web Wallet were all launched by March 2018. TRON Mainnet launched shortly afterward in May 2018, marking the Odyssey 2.0 release as a technical milestone for TRON. In June 2018, TRON switched its protocol from an ERC-20 token on top of Ethereum to an independent peer-to-peer network. On 25 July 2018, the TRON Foundation announced it had finished the acquisition of BitTorrent, a peer-to-peer file sharing service. Upon this acquisition, in August 2018, BitTorrent Founder Bram Cohen also disclosed that he was leaving the company to found a separate cryptocurrency, Chia. By January 2019, TRON had a total market cap of about $1.6 bn. Despite this market performance, some authors viewed TRON as a typical case of the complex and disordered nature of cryptocurrencies. In February 2019, after being acquired by TRON Foundation, BitTorrent started its own token sale based on the TRON network. In late 2021, Justin Sun resigned as CEO of the TRON Foundation, which was subsequently reorganized as a DAO. In March 2023, Sun and Tron were sued by the U.S. Securities and Exchange Commission (SEC) for selling unregistered securities related to the sale and promotion of Tronix (TRX) and BitTorrent (BBT) tokens; the SEC alleged that Sun and Tron had engaged in wash trading in the secondary market for TRX in order to buoy its price. $31 million of proceeds were generated through thousands of Tronix trades between two accounts Sun controlled. Eight celebrities, including Akon, Ne-Yo, Austin Mahone, Soulja Boy, Lindsay Lohan, Jake Paul and Lil Yachty, were charged with promoting these cryptocurrencies without disclosing that they were sponsored, with all those other than Soulja Boy, and Mahone settling with t