Overview

The Thirdweb MCP Server connects AI agents to the thirdweb ecosystem, enabling secure, standardized interactions with EVM-compatible blockchains. Through thirdweb services like Insight, Engine/EngineCloud, and Nebula, agents can query on-chain data, manage wallets, read/write contracts, and execute transactions autonomously.

Official Server:

Developed and maintained by Thirdweb

Key Features

🌐

Multi-Chain Onchain Data

Real-time queries across many EVM networks via Insight

🔐

Wallet & Contract Tools

Create server wallets, read ABI/state, and write to contracts

🤖

Autonomous Execution

Nebula enables agents to plan and execute complex onchain tasks

☁️

Hosted & Self-Hosted

Use the hosted MCP endpoint or run locally with Python tools

Available Tools

Quick Reference

Tool	Purpose	Category
`list_server_wallets`	List server wallets	Wallet
`create_server_wallet`	Create a server wallet	Wallet
`get_wallet_balance`	Get native/token balances	Wallet
`read_contract`	Read contract state/ABI	Contract
`write_contract`	Execute contract function	Contract
`get_contract_events`	Fetch recent events	Data

Detailed Usage

get_wallet_balance▶

Retrieve the native/token balance of a wallet on a given chain.

use_mcp_tool({
  server_name: "thirdweb",
  tool_name: "get_wallet_balance",
  arguments: {
    address: "0xYourWallet",
    chainId: 1
  }
});

read_contract▶

Read contract state or metadata using ABI and method parameters.

use_mcp_tool({
  server_name: "thirdweb",
  tool_name: "read_contract",
  arguments: {
    chainId: 1,
    contractAddress: "0xContract",
    function: "balanceOf",
    params: ["0xYourWallet"]
  }
});

write_contract▶

Execute a contract function using a server wallet (Engine/EngineCloud).

use_mcp_tool({
  server_name: "thirdweb",
  tool_name: "write_contract",
  arguments: {
    chainId: 137,
    contractAddress: "0xContract",
    function: "approve",
    params: ["0xSpender", "1000000"],
    wallet: "treasury"
  }
});

Requires Engine configuration for transaction execution.

get_contract_events▶

Fetch recent events (logs) for a contract on a given chain.

use_mcp_tool({
  server_name: "thirdweb",
  tool_name: "get_contract_events",
  arguments: {
    chainId: 1,
    contractAddress: "0xContract",
    event: "Transfer",
    fromBlock: "latest-500"
  }
});

Installation

{
  "mcpServers": {
    "thirdweb": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "thirdweb-mcp"
      ],
      "env": {
        "THIRDWEB_SECRET_KEY": "your_secret_key",
        "THIRDWEB_ENGINE_URL": "(optional) engine url",
        "THIRDWEB_ENGINE_AUTH_JWT": "(optional) engine jwt",
        "THIRDWEB_ENGINE_BACKEND_WALLET_ADDRESS": "(optional) backend wallet"
      }
    }
  }
}

Sources

MCP Architecture Overview

MCP (Model Context Protocol) features a distributed architecture enabling AI applications to communicate seamlessly with multiple data sources and tools through standardized interfaces.

Txtai MCP Server

Txtai MCP servers enable AI models to interact with txtai, an AI-powered search engine that builds vector indexes (also known as embeddings) to perform similarity searches.

Linear MCP Server

Linear MCP server enables AI models to interact with Linear's project management system, providing capabilities for issue tracking, project management, team collaboration, and workflow automation.

Thirdweb MCP Server