thirdweb MCP Server v0.1 Beta

We're excited to announce the launch of thirdweb MCP Server, a powerful bridge between AI agents and blockchain technology. This release enables any Model Control Protocol (MCP) compatible client to interact with any EVM-compatible blockchain.

What We're Launching

The thirdweb MCP server implements the standardized Model Control Protocol, providing AI agents with direct access to thirdweb's suite of blockchain tools:

• Real-time Onchain Data Querying: Make better decisions with live blockchain data through Insight
• Smart Contract Analysis: Retrieve source code and ABIs for any contract through Insight
• Autonomous Transaction Execution: Enable AI agents to execute blockchain transactions without human intervention via Engine
• Multi-chain Support: Connect to any EVM-compatible blockchain by specifying chain IDs

Key Features

Insight Service

• Query on-chain data across multiple networks in real-time
• Analyze wallets, transactions, blocks, and smart contract events
• Access smart contract source code and ABIs

Engine Service

• Interact with any deployed contracts on any EVM chains (Read contract's storage state or slots)
• Manage backend wallet, gas, and transactions
• Execute blockchain transactions autonomously

Nebula Service

• Autonomous onchain execution capabilities for complex onchain tasks
• Smart contract code generation and contract analysis

Getting Started

Prerequisites

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

Quick Installation

# Option 1: Install and run with uvx
THIRDWEB_SECRET_KEY=... uvx thirdweb-mcp


# Option 2: Install with pipx
pipx install thirdweb-mcp

THIRDWEB_SECRET_KEY=... thirdweb-mcp

Basic Usage Workflow

1. Connect your MCP client to the server
   • If using Claude Desktop, update your configuration file.
   • For other MCP clients, make sure the client supports MCP Tools connect to the server's transport stdio or SSE, (configureable through --transport)
2. Start interacting with the LLM for all your onchain needs:
   • Query real-time blockchain data on most of the EVM chains
   • Access smart contract ABIs and source code for analysis
   • Execute transactions autonomously (requires Engine env var setup)

Integration with Claude Desktop

1. Install the MCP server: pipx install thirdweb-mcp
2. Create or edit the Claude Desktop configuration file at:
   1. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   2. Windows: %APPDATA%\Claude\claude_desktop_config.json
   3. Linux: ~/.config/Claude/claude_desktop_config.json
3. Restart Claude Desktop and start interacting with blockchain.

Update Claude Desktop configuration:

{
  "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",           
      },
    }
  }
}

Developer Resources

LLM Integration

When building applications that integrate LLMs with thirdweb's blockchain capabilities, you can enhance your results by including thirdweb context files:

• Basic context: https://portal.thirdweb.com/llms.txt
• Comprehensive context: https://portal.thirdweb.com/llms-full.txt

Documentation and Support

• thirdweb documentation: thirdweb.com/docs
• MCP protocol: modelcontextprotocol.io
• Support: support@thirdweb.com