amygdala-labs/web3-mcp

A Model-Context-Protocol server for interacting with multiple blockchains including Solana, Ethereum, THORChain, XRP Ledger, TON (The Open Network), Cardano, and UTXO chains. This server provides simple RPC endpoints for common blockchain operations, allowing secure interactions with various blockchains through environment variables.
## Features
Solana Operations:
Check SOL account balances
Get detailed account information
Transfer SOL between accounts
View SPL token balances
Get your wallet address from private key
Swap tokens using Jupiter (Best price routing across all Solana DEXs)
Ethereum & EVM Chain Operations:
Check native token balances across multiple networks
Check ERC-20 token balances
Send native tokens (using private key from .env)
Send ERC-20 tokens (using private key from .env)
Approve ERC-20 token spending (using private key from .env)
Cardano Operations:
Get network information and statistics
Check address balances and transaction history
View UTxOs for an address
Explore stake pools and delegation information
Get details about native assets
View detailed transaction information
Get statistics about the current epoch
THORChain Operations:
Check RUNE balances
Get detailed pool information
Get swap quotes between any supported assets
Cross-chain swaps via THORChain protocol
UTXO Chain Operations:
Bitcoin (BTC)
Check address balances
View transaction history
Validate addresses
Get network info and fees
Litecoin (LTC)
Check address balances
View transaction history
Validate addresses
Get network info and fees
Dogecoin (DOGE)
Check address balances
View transaction history
Validate addresses
Get network info and fees
Bitcoin Cash (BCH)
Check address balances
View transaction history
Validate addresses
Get network info and fees
XRP Ledger Operations:
Check XRP account balances
View transaction history
Validate XRP addresses
Send XRP to another address
Get current XRP Ledger information
Check token balances
Create trustlines for tokens
TON (The Open Network) Operations:
Get TON account balances
View transaction history
Validate TON addresses
Send TON to another address with optional memo/comment
Get current TON network information
Supported EVM Networks:
Ethereum
Base
Arbitrum
Optimism
BSC (Binance Smart Chain)
Polygon
Avalanche
Berachain
## Setup
1. Clone and install dependencies:
bash
git clone https://github.com/strangelove-ventures/web3-mcp.git
cd web3-mcp
npm install
2. Create a .env file in the root directory:
bash
cp .env.example .env
3. Configure your environment variables in .env:
### Required Configuration
env
# Tool Registration Controls
ENABLESOLANATOOLS=true # Enable/disable Solana tools
ENABLEETHEREUMTOOLS=true # Enable/disable Ethereum and EVM chain tools
ENABLECARDANOTOOLS=true # Enable/disable Cardano tools
# UTXO Chain Tools
ENABLEBITCOINTOOLS=true # Enable/disable Bitcoin tools
ENABLELITECOINTOOLS=true # Enable/disable Litecoin tools
ENABLEDOGECOINTOOLS=true # Enable/disable Dogecoin tools
ENABLEBITCOINCASHTOOLS=true # Enable/disable Bitcoin Cash tools
ENABLETHORCHAINTOOLS=true # Enable/disable THORChain tools
ENABLERIPPLETOOLS=true # Enable/disable XRP Ledger tools
ENABLETONTOOLS=true # Enable/disable TON tools
# Private Keys (required for transactions)