blockchain-mcp

What is blockchain-mcp?

blockchain-mcp is a lightweight MCP server that leverages thirdweb to equip LLMs with blockchain capabilities. It enables deploying, minting, and transferring tokens, as well as reading balances and supply. It comes pre-configured with a server wallet and gas sponsorship, operating on Base Sepolia by default.

How to use blockchain-mcp?

Install dependencies with bun install, create a .env file with your thirdweb secret key (TW_SECRET_KEY), and update the path in index.ts. Then add the server to your claude_desktop_config.json with the command bun /<path-to-project>/blockchain-mcp/index.ts. After starting Claude Desktop, the tools become available for blockchain queries.

Key features of blockchain-mcp

• Deploy tokens via thirdweb infrastructure
• Mint new tokens on demand
• Transfer tokens between addresses
• Read token balances and total supply
• Built-in gas sponsorship for transactions
• Operates on Base Sepolia testnet

Use cases of blockchain-mcp

• Enable an LLM to deploy an ERC-20 token automatically
• Automate token distribution for airdrops or rewards
• Query on-chain balances without manual blockchain explorers

FAQ from blockchain-mcp

What dependencies does blockchain-mcp require?

It requires bun as the runtime and a thirdweb secret key. The server uses the thirdweb SDK to interact with the blockchain.

What blockchain network does it support?

Out of the box it is configured for Base Sepolia, but the underlying thirdweb setup can be adjusted to other networks.

How is authentication handled?

Authentication uses a thirdweb secret key stored in a .env file under the variable TW_SECRET_KEY.

What data does blockchain-mcp access?

It reads token balances and supply from the blockchain via thirdweb, and writes transactions (deploy, mint, transfer) on-chain.

Are there any known limitations?

The README does not mention performance limits, but the server relies on thirdweb's infrastructure and only exposes the specific tools listed.