thirdwebDocs
GitHub

Get Started

Learn how to get started with the thirdweb MCP server.

Prerequisites

  • Python 3.10 or higher
  • uv

Run with uvx

THIRDWEB_SECRET_KEY=... \
    uvx thirdweb-mcp

Install and run with pipx

pipx install thirdweb-mcp
 
THIRDWEB_SECRET_KEY=... \
    thirdweb-mcp

Install 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 requires configuration based on which services you want to enable:

  • thirdweb Secret Key: Required for Nebula and Insight services. Obtain from the thirdweb dashboard.
  • 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 the Engine URL and authentication JWT.

You can provide these through command-line options or environment variables.

Usage

Command-line options

# Basic usage with default settings (stdio transport with Nebula and Insight)
THIRDWEB_SECRET_KEY=... thirdweb-mcp 
 
# Using SSE transport on a custom port
THIRDWEB_SECRET_KEY=... thirdweb-mcp --transport sse --port 8080
 
# Enabling all services with specific chain IDs
THIRDWEB_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

Environment variables

You can also configure the MCP server using 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

Available Services

Nebula

Autonomous onchain execution and analysis:

  • Analyze smart contract code
  • Contract interactions and deployments
  • Autonomous onchain tasks execution

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