thirdweb MCP Server

Overview

• **Nebula**: Autonomous onchain execution - real-time on-chain analysis, code generation and contract interactions

• **Insight**: Blockchain data analysis capabilities for real-time on-chain data

• **Engine**: Integration with thirdweb's backend infrastructure for contract deployments and interactions

• **Storage**: Decentralized storage capabilities for uploading and retrieving data via IPFS

Installation

Prerequisites

• Python 3.10 or higher

• uv

Run with uvx

Install and run with pipx

Install from source

Configuration

1. **thirdweb Secret Key**: Required for Nebula, Insight, and Storage services. Obtain from the [thirdweb dashboard](https://thirdweb.com/dashboard).

2. **Chain IDs**: Blockchain network IDs to connect to (e.g., 1 for Ethereum mainnet, 137 for Polygon).

3. **Engine Configuration**: If using the Engine service, you'll need the Engine URL and authentication JWT.

Usage

Command-line options

Environment variables

• `THIRDWEB_SECRET_KEY`: Your thirdweb API secret key

• `THIRDWEB_ENGINE_URL`: URL endpoint for thirdweb Engine service

• `THIRDWEB_ENGINE_AUTH_JWT`: Authentication JWT token for Engine

• `THIRDWEB_ENGINE_BACKEND_WALLET_ADDRESS`: Wallet address for Engine backend

Integration with Claude Desktop

1. Install the MCP: `pipx install thirdweb-mcp`

2. Create or edit the Claude Desktop configuration file at: - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` - Windows: `%APPDATA%\Claude\claude_desktop_config.json` - Linux: `~/.config/Claude/claude_desktop_config.json`

3. Add the following configuration: ```json { "mcpServers": { "thirdweb-mcp": { "command": "thirdweb-mcp", "args": [], // add `--chain-id` optionally "env": { "THIRDWEB_SECRET_KEY": "your thirdweb secret key from dashboard", "THIRDWEB_ENGINE_URL": "(OPTIONAL) your engine url", "THIRDWEB_ENGINE_AUTH_JWT": "(OPTIONAL) your engine auth jwt", "THIRDWEB_ENGINE_BACKEND_WALLET_ADDRESS": "(OPTIONAL) your engine backend wallet address", }, } } } ```

4. Restart Claude Desktop for the changes to take effect.

Integration with MCP clients

1. Run the MCP server with the appropriate configuration

2. Connect your MCP client to the server using the selected transport (stdio or SSE)

3. Access thirdweb services through the exposed MCP tools

Available Services

Nebula

• Analyze smart contract code

• Contract interactions and deployments

• Autonomous onchain tasks execution

Insight

• Query on-chain data across multiple networks

• Analyze transactions, blocks, and smart contract events

• Monitor wallet activities and token movements

Engine

• Deploy smart contracts

• Interact with deployed contracts

• Manage wallet connections and transactions

Storage

• Upload files, directories, and JSON data to IPFS

• Retrieve content from IPFS using thirdweb gateway

• Preserve directory structures when uploading

License

Support