RSK

The Rootstock MCP Server provides a Model Context Protocol interface to interact with the Rootstock blockchain. It lets you manage wallets, check balances, transfer assets, deploy and verify contracts, read on-chain data, and query history, all through a standardized MCP client workflow.

How to use

You connect to this MCP server from an MCP-compatible client (such as a Cursor or Claude desktop integration) and enable the Rootstock operations. After you authorize access, you can start with wallet management, then move on to balances, transfers, and contract interactions. The server exposes a set of operations that you can invoke via prompts or UI actions in your MCP client.

How to install

Prerequisites you need to prepare before installation:

• Node.js v18 or higher

• npm or yarn

• TypeScript (included in dev dependencies)

Step by step installation and build

Clone the repository and navigate into the project directory.

git clone https://github.com/rsksmart/rsk-mcp-server
cd rsk-mcp-server

Install dependencies.

npm install

Build the project to produce runnable artifacts in the build folder.

npm run build

Verify the installation by running the built entry point.

node build/index.js

Notes on local startup

For local running, your MCP client will point to the index.js file created in the build folder after building.

Additional configuration options

You can configure the MCP client to load the server in different ways, including local stdio usage or remote HTTP endpoints. The setup can be done directly in your MCP client’s configuration, as shown in the examples below.

Security and best practices

Handle wallets securely, keep backups of your wallet store, use strong passwords, and test against a testnet before moving to mainnet.

Troubleshooting

If you encounter issues starting the MCP, ensure the build output exists at build/index.js and that your MCP client is pointing to the correct local path.

Available tools

wallet

Manage wallets including creating, importing, listing, and switching active wallets.

check-balance

Query rBTC and ERC20 balances for a given wallet and token.

transfer

Send RBTC or ERC20 tokens to another address.

check-transaction

Check the status and details of a transaction by its hash.

deploy-contract

Deploy smart contracts to the Rootstock network using supplied ABI, bytecode, and constructor arguments.

verify-contract

Verify a deployed contract using source code and compilation metadata.

read-contract

Read data from verified contracts, including listing functions and calling view methods.

history

Query transaction history associated with a wallet or address.