Skip to content
Back to search

web3-mcp

1 MCP to rule all them chains

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/strangelove-ventures--web3-mcp/badge.svg)](/listings/strangelove-ventures--web3-mcp)

HTML

<a href="/listings/strangelove-ventures--web3-mcp"><img src="/api/listings/strangelove-ventures--web3-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Clone and install dependencies:

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

2. Create a .env file in the root directory:

cp .env.example .env

3. Configure your environment variables in .env:

Required Configuration

# Tool Registration Controls
ENABLE_SOLANA_TOOLS=true      # Enable/disable Solana tools
ENABLE_ETHEREUM_TOOLS=true    # Enable/disable Ethereum and EVM chain tools
ENABLE_CARDANO_TOOLS=true     # Enable/disable Cardano tools

# UTXO Chain Tools
ENABLE_BITCOIN_TOOLS=true     # Enable/disable Bitcoin tools
ENABLE_LITECOIN_TOOLS=true    # Enable/disable Litecoin tools
ENABLE_DOGECOIN_TOOLS=true    # Enable/disable Dogecoin tools
ENABLE_BITCOINCASH_TOOLS=true # Enable/disable Bitcoin Cash tools
ENABLE_THORCHAIN_TOOLS=true   # Enable/disable THORChain tools
ENABLE_RIPPLE_TOOLS=true      # Enable/disable XRP Ledger tools
ENABLE_TON_TOOLS=true         # Enable/disable TON tools

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

# XRP Ledger credentials (required for XRP transactions)
# Either private key or mnemonic is required
XRP_PRIVATE_KEY=your-xrp-private-key-in-hex
# OR
XRP_MNEMONIC=your-xrp-mnemonic-recovery-phrase
# Optional - used to verify the derived address
XRP_ADDRESS=your-xrp-account-address

# TON Configuration
TON_MNEMONIC=word1 word2 word3 ... word24  # 24-word recovery phrase for TON wallet
TON_ADDRESS=your-ton-wallet-address       # Your TON wallet address
TON_API_KEY=your-toncenter-api-key        # Get from @tonapibot on Telegram (optional but recommended)
TON_RPC_URL=https://toncenter.com/api/v2/jsonRPC  # Optional - default is TON Center API

# Cardano Configuration
BLOCKFROST_API_KEY=your-blockfrost-api-key  # Get a real API key from https://blockfrost.io/
CARDANO_NETWORK=mainnet     # or 'testnet', 'preview', 'preprod'
CARDANO_MNEMONIC=your-cardano-mnemonic-phrase   # Required for transaction signing
CARDANO_ACCOUNT_INDEX=0     # Optional - defaults to 0

Optional Configuration

# Network RPC URLs (optional - will use public endpoints if not specified)
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com

# Ethereum & Layer 2s
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

# Other EVM Chains
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
BERACHAIN_RPC_URL=https://rpc.berachain.com

# XRP Ledger
XRP_RPC_URL=https://xrplcluster.com/     # Optional - will use public endpoint if not specified

# TON Network
TON_RPC_URL=https://toncenter.com/api/v2/jsonRPC  # Optional - default is TON Center API
TON_API_KEY=your-toncenter-api-key        # Get from @tonapibot on Telegram (optional but recommended)

# THORChain Configuration
THORCHAIN_NODE_URL=https://thornode.ninerealms.com  # Optional - will use public endpoint if not specified
THORCHAIN_PRIVATE_KEY=your-thorchain-private-key
THORCHAIN_MNEMONIC=your-thorchain-mnemonic

# UTXO Chain API Keys (optional)
BLOCKCYPHER_API_KEY=your-blockcypher-api-key
SOCHAIN_API_KEY=your-sochain-api-key

4. Build the tool:

npm run build

5. Add the tool to your claude_desktop_config.json:

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 354 lines · 3 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Web3 MCP
  2. 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.
  3. <a href="https://glama.ai/mcp/servers/an8x6gmzdn"><img width="380" height="200" src="https://glama.ai/mcp/servers/an8x6gmzdn/badge" alt="Web3 Server MCP server" /></a>
  4. ## Features
  5. Solana Operations:
  6. - Check SOL account balances
  7. - Get detailed account information
  8. - Transfer SOL between accounts
  9. - View SPL token balances
  10. - Get your wallet address from private key
  11. - Swap tokens using Jupiter (Best price routing across all Solana DEXs)
  12. Ethereum & EVM Chain Operations:
  13. - Check native token balances across multiple networks
  14. - Check ERC-20 token balances
  15. - Send native tokens (using private key from .env)
  16. - Send ERC-20 tokens (using private key from .env)
  17. - Approve ERC-20 token spending (using private key from .env)
  18. Cardano Operations:
  19. - Get network information and statistics
  20. - Check address balances and transaction history
  21. - View UTxOs for an address
  22. - Explore stake pools and delegation information
  23. - Get details about native assets
  24. - View detailed transaction information
  25. - Get statistics about the current epoch
  26. THORChain Operations:
  27. - Check RUNE balances
  28. - Get detailed pool information
  29. - Get swap quotes between any supported assets
  30. - Cross-chain swaps via THORChain protocol
  31. UTXO Chain Operations:
  32. - Bitcoin (BTC)
  33. - Check address balances
  34. - View transaction history
  35. - Validate addresses
  36. - Get network info and fees
  37. - Litecoin (LTC)
  38. - Check address balances
  39. - View transaction history
  40. - Validate addresses
  41. - Get network info and fees
  42. - Dogecoin (DOGE)
  43. - Check address balances
  44. - View transaction history
  45. - Validate addresses
  46. - Get network info and fees
  47. - Bitcoin Cash (BCH)
  48. - Check address balances
  49. - View transaction history
  50. - Validate addresses
  51. - Get network info and fees
  52. XRP Ledger Operations:
  53. - Check XRP account balances
  54. - View transaction history
  55. - Validate XRP addresses
  56. - Send XRP to another address
  57. - Get current XRP Ledger information
  58. - Check token balances
  59. - Create trustlines for tokens
  60. TON (The Open Network) Operations:
  61. - Get TON account balances
  62. - View transaction history
  63. - Validate TON addresses
  64. - Send TON to another address with optional memo/comment
  65. - Get current TON network information
  66. Supported EVM Networks:
  67. - Ethereum
  68. - Base
  69. - Arbitrum
  70. - Optimism
  71. - BSC (Binance Smart Chain)
  72. - Polygon
  73. - Avalanche
  74. - Berachain
  75. ## Setup
  76. 1. Clone and install dependencies:
  77. ```bash
  78. git clone https://github.com/strangelove-ventures/web3-mcp.git
  79. cd web3-mcp
  80. npm install
  81. ```
  82. 2. Create a .env file in the root directory:
  83. ```bash
  84. cp .env.example .env
  85. ```
  86. 3. Configure your environment variables in .env:
  87. ### Required Configuration
  88. ```env
  89. # Tool Registration Controls
  90. ENABLE_SOLANA_TOOLS=true # Enable/disable Solana tools
  91. ENABLE_ETHEREUM_TOOLS=true # Enable/disable Ethereum and EVM chain tools
  92. ENABLE_CARDANO_TOOLS=true # Enable/disable Cardano tools
  93. # UTXO Chain Tools
  94. ENABLE_BITCOIN_TOOLS=true # Enable/disable Bitcoin tools
  95. ENABLE_LITECOIN_TOOLS=true # Enable/disable Litecoin tools
  96. ENABLE_DOGECOIN_TOOLS=true # Enable/disable Dogecoin tools
  97. ENABLE_BITCOINCASH_TOOLS=true # Enable/disable Bitcoin Cash tools
  98. ENABLE_THORCHAIN_TOOLS=true # Enable/disable THORChain tools
  99. ENABLE_RIPPLE_TOOLS=true # Enable/disable XRP Ledger tools
  100. ENABLE_TON_TOOLS=true # Enable/disable TON tools
  101. # Private Keys (required for transactions)
  102. ETH_PRIVATE_KEY=your-ethereum-private-key
  103. SOLANA_PRIVATE_KEY=your-base58-encoded-solana-private-key
  104. # XRP Ledger credentials (required for XRP transactions)
  105. # Either private key or mnemonic is required
  106. XRP_PRIVATE_KEY=your-xrp-private-key-in-hex
  107. # OR
  108. XRP_MNEMONIC=your-xrp-mnemonic-recovery-phrase
  109. # Optional - used to verify the derived address
  110. XRP_ADDRESS=your-xrp-account-address
  111. # TON Configuration
  112. TON_MNEMONIC=word1 word2 word3 ... word24 # 24-word recovery phrase for TON wallet
  113. TON_ADDRESS=your-ton-wallet-address # Your TON wallet address
  114. TON_API_KEY=your-toncenter-api-key # Get from @tonapibot on Telegram (optional but recommended)
  115. TON_RPC_URL=https://toncenter.com/api/v2/jsonRPC # Optional - default is TON Center API
  116. # Cardano Configuration
  117. BLOCKFROST_API_KEY=your-blockfrost-api-key # Get a real API key from https://blockfrost.io/
  118. CARDANO_NETWORK=mainnet # or 'testnet', 'preview', 'preprod'
  119. CARDANO_MNEMONIC=your-cardano-mnemonic-phrase # Required for transaction signing
  120. CARDANO_ACCOUNT_INDEX=0 # Optional - defaults to 0
  121. ```
  122. ### Optional Configuration
  123. ```env
  124. # Network RPC URLs (optional - will use public endpoints if not specified)
  125. SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
  126. # Ethereum & Layer 2s
  127. ETH_RPC_URL=https://eth-mainnet.g.alchemy.com/v2/your-api-key
  128. ARBITRUM_RPC_URL=https://arb1.arbitrum.io/rpc
  129. BASE_RPC_URL=https://mainnet.base.org
  130. OPTIMISM_RPC_URL=https://mainnet.optimism.io
  131. # Other EVM Chains
  132. BSC_RPC_URL=https://bsc-dataseed.binance.org
  133. POLYGON_RPC_URL=https://polygon-rpc.com
  134. AVALANCHE_RPC_URL=https://api.avax.network/ext/bc/C/rpc
  135. BERACHAIN_RPC_URL=https://rpc.berachain.com
  136. # XRP Ledger
  137. XRP_RPC_URL=https://xrplcluster.com/ # Optional - will use public endpoint if not specified
  138. # TON Network
  139. TON_RPC_URL=https://toncenter.com/api/v2/jsonRPC # Optional - default is TON Center API
  140. TON_API_KEY=your-toncenter-api-key # Get from @tonapibot on Telegram (optional but recommended)
  141. # THORChain Configuration
  142. THORCHAIN_NODE_URL=https://thornode.ninerealms.com # Optional - will use public endpoint if not specified
  143. THORCHAIN_PRIVATE_KEY=your-thorchain-private-key
  144. THORCHAIN_MNEMONIC=your-thorchain-mnemonic
  145. # UTXO Chain API Keys (optional)
  146. BLOCKCYPHER_API_KEY=your-blockcypher-api-key
  147. SOCHAIN_API_KEY=your-sochain-api-key
  148. ```
  149. 4. Build the tool:
  150. ```bash
  151. npm run build
  152. ```
  153. 5. Add the tool to your claude_desktop_config.json:
  154. ```json
  155. {
  156. "mcpServers": {
  157. "web3-rpc": {
  158. "command": "node",
  159. "args": [
  160. "/PATH/TO/web3-mcp/build/index.js"
  161. ]
  162. }
  163. }
  164. }
  165. ```
  166. ## Tool Registration
  167. The Web3 MCP server allows you to control which blockchain tools are registered through environment variables:
  168. - `ENABLE_SOLANA_TOOLS`: Enable/disable Solana tools
  169. - `ENABLE_ETHEREUM_TOOLS`: Enable/disable Ethereum and EVM chain tools
  170. - `ENABLE_BITCOIN_TOOLS`: Enable/disable Bitcoin tools
  171. - `ENABLE_LITECOIN_TOOLS`: Enable/disable Litecoin tools
  172. - `ENABLE_DOGECOIN_TOOLS`: Enable/disable Dogecoin tools
  173. - `ENABLE_BITCOINCASH_TOOLS`: Enable/disable Bitcoin Cash tools
  174. - `ENABLE_THORCHAIN_TOOLS`: Enable/disable THORChain tools
  175. - `ENABLE_RIPPLE_TOOLS`: Enable/disable XRP Ledger tools
  176. - `ENABLE_CARDANO_TOOLS`: Enable/disable Cardano tools
  177. - `ENABLE_TON_TOOLS`: Enable/disable TON tools
  178. Set these variables to `true` or `false` in your `.env` file to control which tools are available to the server. This allows you to:
  179. - Reduce startup time by only loading required tools
  180. - Minimize security surface area by disabling unused chains
  181. - Customize the server for specific use cases
  182. - Control resource usage by limiting active connections
  183. ## Usage Examples
  184. Ask Claude (or your MCP client of choice):
  185. ### Solana Operations (when ENABLE_SOLANA_TOOLS=true)
  186. - "What's my Solana address?" - Shows your address derived from private key in .env
  187. - "What's the balance of 62QXuWZ3WT6ws1ZFxJobVDVXn6bEsiYpLo5yG612U6u3?"
  188. - "Transfer 0.001 SOL to Cg6cVS4tjkxHthm3K9BHhmvqF7kSz8GnXqqYXnHBzGXd"
  189. - "Show me my SPL token balances"
  190. - "Swap 0.1 SOL to USDC" (Uses Jupiter for best price routing)
  191. ### EVM Operations (when ENABLE_ETHEREUM_TOOLS=true)
  192. - "What's the ETH balance of 0x556437c4d22ceaeeebf82006b85bdcc0ae67d933?"
  193. - "Check the USDC balance for 0x556437c4d22ceaeeebf82006b85bdcc0ae67d933 on Ethereum"
  194. - "Send 0.1 ETH to 0x556437c4d22ceaeeebf82006b85bdcc0ae67d933"
  195. - "What's the current gas price on Arbitrum?"
  196. - "Send 100 USDC to 0x556437c4d22ceaeeebf82006b85bdcc0ae67d933 on Polygon"
  197. ### Cardano Operations (when ENABLE_CARDANO_TOOLS=true)
  198. - Get the balance of any Cardano
  199. - View your wallet information
  200. - Send ADA to another address
  201. - Send native tokens to another address
  202. ### Bitcoin Operations (when ENABLE_BITCOIN_TOOLS=true)
  203. - "What's the BTC balance of 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa?"
  204. - "Show me the transaction history for bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"
  205. - "Validate this Bitcoin address: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"
  206. ### Litecoin Operations (when ENABLE_LITECOIN_TOOLS=true)
  207. - "What's the LTC balance of LM2WMpR1Rp6j3Sa59cMXMs1SPzj9eXpGc1?"
  208. - "Show me the transaction history for this Litecoin address"
  209. - "What's the current Litecoin network fee?"
  210. ### Dogecoin Operations (when ENABLE_DOGECOIN_TOOLS=true)
  211. - "Check this DOGE address balance: D8vFz4p1L37jdg47HXKtSHA5uYLYxbGgPD"
  212. - "Show me recent Dogecoin transactions"
  213. - "What are the current DOGE network fees?"
  214. ### Bitcoin Cash Operations (when ENABLE_BITCOINCASH_TOOLS=true)
  215. - "What's the BCH balance of this address?"
  216. - "Show me the BCH transaction history"
  217. - "Validate this Bitcoin Cash address"
  218. ### THORChain Operations (when ENABLE_THORCHAIN_TOOLS=true)
  219. - "What's the RUNE balance of thor13zpdckczd0jvyhwxmrwnpap8gmy9m5kk2gzum3?"
  220. - "Show me the pool information for BTC.BTC"
  221. - "Get a swap quote for 0.1 BTC.BTC to ETH.ETH"
  222. ### XRP Ledger Operations (when ENABLE_RIPPLE_TOOLS=true)
  223. - "What's the XRP balance of rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe?"
  224. - "Show me the transaction history for rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe"
  225. - "Is rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe a valid XRP address?"
  226. - "Send 10 XRP to rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe"
  227. - "What's the current XRP Ledger information?"
  228. - "Show me token balances for rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe"
  229. - "Create a trustline for USD with issuer rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe with a limit of 1000"
  230. ### TON Operations (when ENABLE_TON_TOOLS=true)
  231. - "What's the TON balance of EQAAFhjXzKuQ5N0c96nsdZQWATcJm909LYSaCAvWFQF8tvUZ?"
    • Dismissed after review: Contains a long base64-looking blob — not necessarily malicious, but worth inspecting what it decodes to
    • Line 280 on GitHub
  232. - "Show me the transaction history for EQAAFhjXzKuQ5N0c96nsdZQWATcJm909LYSaCAvWFQF8tvUZ"
    • Dismissed after review: Contains a long base64-looking blob — not necessarily malicious, but worth inspecting what it decodes to
    • Line 281 on GitHub
  233. - "Is UQD0BRQt-QdIEbsjuRsMqzDlBkUAEfQixShDECoKEOXRc4eR a valid TON address?"
  234. - "Send 0.1 TON to EQAAFhjXzKuQ5N0c96nsdZQWATcJm909LYSaCAvWFQF8tvUZ"
    • Dismissed after review: Contains a long base64-looking blob — not necessarily malicious, but worth inspecting what it decodes to
    • Line 283 on GitHub
  235. - "Send 0.01 TON to UQD0BRQt-QdIEbsjuRsMqzDlBkUAEfQixShDECoKEOXRc4eR with comment 'test payment'"
  236. - "What's the current TON Network information?"
  237. ## Security Notes
  238. 1. **Environment Variables**: All private keys are stored in the .env file and never exposed in the conversation history
  239. 2. **Private Keys**: Only use this with test wallets containing small amounts of funds
  240. 3. **RPC Endpoints**: Custom RPC endpoints can be configured in the .env file for better reliability and rate limits
  241. 4. **.env Security**: The .env file is automatically ignored by git to prevent accidental exposure of private keys
  242. 5. **Tool Registration**: Use the tool registration controls to minimize security surface area by only enabling required chains
  243. ## Advanced Configuration
  244. ### Custom RPC Endpoints
  245. 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.
  246. ### Network Selection
  247. For EVM operations, you can specify the network by name (ethereum, base, arbitrum, optimism, bsc, polygon, avalanche, berachain). The tool will automatically use the appropriate RPC endpoint and network configuration.
  248. ### Cardano Configuration
  249. The tool uses the Blockfrost API and Lucid library to interact with the Cardano blockchain.
  250. - `BLOCKFROST_API_KEY`: Required - Your Blockfrost API key (register at https://blockfrost.io/)
  251. - `CARDANO_NETWORK`: Optional - The Cardano network to use (mainnet, testnet, preview, preprod). Defaults to 'mainnet'
  252. - `CARDANO_MNEMONIC`: Required for transactions - Your Cardano wallet's mnemonic phrase (15 or 24 words)
  253. - `CARDANO_ACCOUNT_INDEX`: Optional - The account index to use (defaults to 0)
  254. The wallet derived from your mnemonic will be used to sign and send transactions.
  255. ### THORChain Configuration
  256. The tool uses Nine Realms public endpoints by default, but you can configure a custom THORChain node URL in the .env file for better reliability and rate limits.
  257. ### XRP Ledger Configuration
  258. The tool can use either a private key or mnemonic phrase for XRP transactions. Configure these in your .env file:
  259. - `XRP_PRIVATE_KEY`: Your XRP private key in hex format
  260. - `XRP_MNEMONIC`: Alternative to private key - your 12-word recovery phrase
  261. - `XRP_ADDRESS`: Optional - Your XRP account address (used to verify the derived address)
  262. - `XRP_RPC_URL`: Optional - Custom XRP Ledger node URL (defaults to public endpoint)
  263. ### TON Configuration
  264. The tool uses TON Center's API by default and requires a mnemonic phrase for TON transactions. Configure these in your .env file:
  265. - `TON_MNEMONIC`: Required - Your 24-word recovery phrase for TON wallet
  266. - `TON_ADDRESS`: Required - Your TON wallet address
  267. - `TON_API_KEY`: Recommended - API key from @tonapibot on Telegram (for higher rate limits)
  268. - `TON_RPC_URL`: Optional - Custom TON RPC URL (defaults to TON Center API)
  269. The implementation includes automatic retry logic with exponential backoff for rate limit handling.
  270. ### UTXO Chain Data Providers
  271. The tool uses several data providers for UTXO chains:
  272. - BlockCypher
  273. - SoChain
  274. - Haskoin (for Bitcoin Cash)
  275. You can configure API keys for these providers in the .env file for better rate limits.
  276. ## Development
  277. To modify or extend the tool:
  278. 1. Source code is in the `src` directory
  279. 2. Chain-specific code in `src/chains`
  280. 3. Run `npm run build` after making changes
  281. 4. Use TypeScript for all new code
  282. ## Contributing
  283. Contributions are welcome! Please submit pull requests with any improvements or bug fixes.
  284. ## License
  285. ISC License

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.