A Model-Context-Protocol server for interacting with multiple blockchains including Solana and Ethereum. 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)

Supported EVM Networks:

Ethereum
Base
Arbitrum
Optimism
BSC (Binance Smart Chain)
Polygon
Avalanche

Setup

Clone and install dependencies:

git clone https://github.com/strangelove-ventures/web3-mcp.git
cd web3-mcp
npm install

Create a .env file in the root directory:

cp .env.example .env

Configure your environment variables in .env:

# Network RPC URLs (optional - will use public endpoints if not specified)
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
ETH_RPC_URL=https://eth-mainnet.g.alchemy.com/v2/your-api-key
ARBITRUM_RPC_URL=https://arb1.arbitrum.io/rpc
BASE_RPC_URL=https://mainnet.base.org
OPTIMISM_RPC_URL=https://mainnet.optimism.io
BSC_RPC_URL=https://bsc-dataseed.binance.org
POLYGON_RPC_URL=https://polygon-rpc.com
AVALANCHE_RPC_URL=https://api.avax.network/ext/bc/C/rpc

# Private keys (required for transactions)
ETH_PRIVATE_KEY=your-ethereum-private-key
SOLANA_PRIVATE_KEY=your-base58-encoded-solana-private-key

Build the tool:

npm run build

Add the tool to your claude_desktop_config.json:

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

Usage Examples

Ask Claude:

Solana Operations

"What's my Solana address?" - Shows your address derived from private key in .env
"What's the balance of 62QXuWZ3WT6ws1ZFxJobVDVXn6bEsiYpLo5yG612U6u3?"
"Transfer 0.001 SOL to Cg6cVS4tjkxHthm3K9BHhmvqF7kSz8GnXqqYXnHBzGXd"
"Show me my SPL token balances"
"Swap 0.1 SOL to USDC" (Uses Jupiter for best price routing)

EVM Operations

"What's the ETH balance of 0x556437c4d22ceaeeebf82006b85bdcc0ae67d933?"
"Check the USDC balance for 0x556437c4d22ceaeeebf82006b85bdcc0ae67d933 on Ethereum"
"Send 0.1 ETH to 0x556437c4d22ceaeeebf82006b85bdcc0ae67d933"
"What's the current gas price on Arbitrum?"
"Send 100 USDC to 0x556437c4d22ceaeeebf82006b85bdcc0ae67d933 on Polygon"

Security Notes

Environment Variables: All private keys are stored in the .env file and never exposed in the conversation history
Private Keys: Only use this with test wallets containing small amounts of funds
RPC Endpoints: Custom RPC endpoints can be configured in the .env file for better reliability and rate limits
.env Security: The .env file is automatically ignored by git to prevent accidental exposure of private keys

Advanced Configuration

Custom RPC Endpoints

You can configure custom RPC endpoints in your .env file for better reliability and higher rate limits. If not specified, the tool will fall back to public RPC endpoints.

Network Selection

For EVM operations, you can specify the network by name (ethereum, base, arbitrum, optimism, bsc, polygon, avalanche). The tool will automatically use the appropriate RPC endpoint and network configuration.

Development

To modify or extend the tool:

Source code is in the src directory
Chain-specific code in src/chains
Run npm run build after making changes
Use TypeScript for all new code

Contributing

Contributions are welcome! Please submit pull requests with any improvements or bug fixes.

License

ISC License