thirdweb Blockchain Tools MCP Server

Finance & FintechPython

Access thirdweb's blockchain tools and services through a standardized interface

Available Tools

nebula_analyze_contract

Analyzes smart contract code to provide insights and explanations

nebula_interact_with_contract

Executes interactions with deployed smart contracts

insight_query_blockchain

Queries on-chain data across multiple blockchain networks

insight_analyze_transaction

Analyzes blockchain transactions, blocks, and smart contract events

engine_deploy_contract

Deploys smart contracts using thirdweb's backend infrastructure

engine_manage_wallet

Manages wallet connections and transactions

storage_upload

Uploads files, directories, and JSON data to IPFS

storage_retrieve

Retrieves content from IPFS using thirdweb gateway

thirdweb MCP provides a unified interface to access thirdweb's suite of blockchain tools and services through the standardized Model Context Protocol. It enables seamless integration with Nebula for autonomous onchain execution, Insight for blockchain data analysis, Engine for contract deployments and interactions, and Storage for decentralized file management via IPFS. With this MCP, you can analyze smart contracts, query on-chain data across multiple networks, deploy and interact with contracts, and manage decentralized storage—all through a consistent interface that works with any MCP-compatible client.

Installation

Prerequisites

Python 3.10 or higher
A thirdweb Secret Key (obtain from the thirdweb dashboard)

Installation Options

Using pipx (recommended):

pipx install thirdweb-mcp

Using uvx:

THIRDWEB_SECRET_KEY=your_secret_key uvx thirdweb-mcp

From source:

git clone https://github.com/thirdweb-dev/ai.git thirdweb-ai
cd thirdweb-ai/python/thirdweb-mcp
uv sync

Configuration

The thirdweb MCP server can be configured through command-line options or environment variables:

Required Configuration

thirdweb Secret Key: Required for Nebula, Insight, and Storage services

Optional Configuration

Chain IDs: Blockchain network IDs to connect to (e.g., 1 for Ethereum mainnet, 137 for Polygon)
Engine Configuration: If using the Engine service, you'll need:
- Engine URL
- Authentication JWT
- Backend wallet address

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

Usage

Basic Usage

Run the MCP server with your thirdweb secret key:

THIRDWEB_SECRET_KEY=your_secret_key thirdweb-mcp

Advanced Usage

Customize the transport and enable specific services:

# Using SSE transport on a custom port
THIRDWEB_SECRET_KEY=your_secret_key thirdweb-mcp --transport sse --port 8080

# Enabling all services with specific chain IDs
THIRDWEB_SECRET_KEY=your_secret_key thirdweb-mcp --chain-id 1 --chain-id 137 \
    --engine-url YOUR_ENGINE_URL \
    --engine-auth-jwt YOUR_ENGINE_JWT \
    --engine-backend-wallet-address YOUR_ENGINE_BACKEND_WALLET_ADDRESS

Available Services

Nebula

Provides autonomous onchain execution and analysis capabilities:

Analyze smart contract code
Execute contract interactions and deployments
Perform autonomous onchain tasks

Insight

Offers blockchain data analysis capabilities:

Query on-chain data across multiple networks
Analyze transactions, blocks, and smart contract events
Monitor wallet activities and token movements

Engine

Integrates with thirdweb's backend infrastructure:

Deploy smart contracts
Interact with deployed contracts
Manage wallet connections and transactions

Storage

Provides decentralized storage functionality:

Upload files, directories, and JSON data to IPFS
Retrieve content from IPFS using thirdweb gateway
Preserve directory structures when uploading

Support

For questions or support, please contact support@thirdweb.com or visit thirdweb.com.