Web3

You run a Web3 MCP server that provides streamlined RPC-style access to multiple blockchains. By configuring environment variables, you enable or disable specific blockchain toolsets, sign transactions, query balances, and swap assets across Solana, Ethereum and other networks from a single, secure endpoint.

How to use

You interact with the MCP server through an MCP client. Start the server with the tools you need enabled by your environment settings. You can query native balances, view transaction histories, transfer funds, and request cross-chain quotes or swaps. The server uses private keys and sensitive credentials stored in your environment file, so protect that file and run with only the tools you truly need.

How to install

Prerequisites: Node.js and npm must be installed on your machine.

# 1) Clone the project repository
git clone https://github.com/strangelove-ventures/web3-mcp.git
cd web3-mcp

# 2) Install dependencies
npm install

2. Create a configuration file for environment variables and start the build process.

# 3) Create a .env file based on the example
cp .env.example .env

# 4) Build the tool
npm run build

# 5) Start or register the local MCP server (details below in the stdio config snippet)

6. Add the local MCP server entry to your MCP client configuration. Use the runtime command shown in the stdio example.

{
  "mcpServers": {
    "web3_rpc": {
      "command": "node",
      "args": [
        "/PATH/TO/web3-mcp/build/index.js"
      ]
    }
  }
}

Configuration and security notes

Enable or disable each blockchain tool group with environment variables. This minimizes startup time, reduces the security surface, and helps tailor the server to your use case.

Critical environment variables include keys and endpoints for signing transactions and querying networks. Store all private keys in your .env file and ensure it is protected and ignored by version control.

Advanced configuration

Custom RPC endpoints can be provided in your .env file to improve reliability and rate limits. If not specified, public endpoints are used. For EVM networks you can select the target network by name, and the server will route to the appropriate RPC endpoint.

Cardano interactions rely on a Blockfrost API key and a 15- or 24-word mnemonic. TON interactions require a 24-word TON mnemonic with optional TON Center API support. XRP Ledger interactions can use either a private key or mnemonic, plus an optional custom XRP Ledger node URL.

Security notes

All private keys are stored in the .env file and never exposed in conversation history. Use test wallets with small funds during initial testing. The server supports custom RPC endpoints for reliability and rate limits. The .env file is ignored by version control to prevent accidental exposure of private keys.

Additional usage tips

Tool registration controls let you tailor which chains are loaded at startup. Set ENABLE_SOLANA_TOOLS, ENABLE_ETHEREUM_TOOLS, ENABLE_CARDANO_TOOLS, ENABLE_BITCOIN_TOOLS, ENABLE_LITECOIN_TOOLS, ENABLE_DOGECOIN_TOOLS, ENABLE_BITCOINCASH_TOOLS, ENABLE_THORCHAIN_TOOLS, ENABLE_RIPPLE_TOOLS, ENABLE_TON_TOOLS to true or false in your .env file to balance capability, performance, and security.

Notes on supported networks and assets

The server provides operations across a wide range of networks, including Solana, Ethereum and other EVM-compatible chains, Cardano, XRP Ledger, TON, THORChain, and multiple UTXO-based chains such as Bitcoin, Litecoin, Dogecoin, and Bitcoin Cash. It also includes cross-chain swap and quote capabilities where supported.

Available tools

check_sol_balance

Retrieve SOL balance for a Solana address and show detailed account info.

sol_transfer

Send SOL from your wallet to another address using the private key from .env.

sol_spl_balances

View SPL token balances for your Solana wallet.

sol_swap

Swap SOL to another token using Jupiter routing for best price.

eth_balance

Check native ETH balance across supported networks.

erc20_balance

Check ERC-20 token balances for a given address.

eth_send

Send native ETH using your private key from .env.

erc20_send

Send ERC-20 tokens using your private key from .env.

erc20_approve

Approve ERC-20 spending using your private key.

cardano_info

Get Cardano network information and statistics.

cardano_balance

Check Cardano address balances and transaction history.

cardano_utxos

View UTxOs for a Cardano address.

cardano_stake

Explore stake pools and delegation information.

cardano_assets

Get details about native assets on Cardano.

cardano_tx

View detailed Cardano transaction information.

cardano_epoch

Get statistics about the current Cardano epoch.

thorchain_rune

Check RUNE balances and swap quotes across supported assets.

thorchain_pool

Get detailed pool information for THORChain pools.

thorchain_swap

Get a swap quote for cross-chain swaps via THORChain.

utxo_btc_balance

Check BTC address balances.

utxo_btc_history

View BTC transaction history.

utxo_btc_validate

Validate BTC addresses.

utxo_btc_fee

Get Bitcoin network info and fees.

utxo_ltc_balance

Check LTC address balances.

utxo_ltc_history

View LTC transaction history.

utxo_ltc_validate

Validate LTC addresses.

utxo_ltc_fee

Get LTC network fees.

utxo_bch_balance

Check BCH address balances.

utxo_bch_history

View BCH transaction history.

utxo_bch_validate

Validate BCH addresses.

xrp_balance

Check XRP account balances.

xrp_history

View XRP transaction history.

xrp_validate

Validate XRP addresses.

xrp_send

Send XRP to another address.

xrp_info

Get current XRP Ledger information.

xrp_token_balance

Check token balances on XRP Ledger.

xrp_trustline

Create a trustline for a token with a specific issuer and limit.

ton_balance

Get TON account balances.

ton_history

View TON transaction history.

ton_validate

Validate TON addresses.

ton_send

Send TON with optional memo.

ton_info

Get current TON network information.