Thirdweb AI

What is Thirdweb AI about?

Thirdweb AI equips developers with a unified toolkit for analyzing blockchain data, managing wallets, interacting with smart contracts, storing files on IPFS, and enabling AI agents to execute on‑chain actions via natural language commands.

How to use Thirdweb AI?

1. Install the MCP server (Python):

   THIRDWEB_SECRET_KEY=... uvx thirdweb-mcp
   # or with pipx
   pipx install thirdweb-mcp
   THIRDWEB_SECRET_KEY=... thirdweb-mcp
   

2. Add the SDK:
   • Python: pip install "thirdweb-ai[all]" (or install specific adapters).
   • TypeScript SDK is forthcoming.
3. Initialize services in code:

   from thirdweb_ai import Insight, Engine, EngineCloud, Nebula, Storage
   insight = Insight(secret_key=...)
   nebula = Nebula(secret_key=...)
   engine = Engine(...)
   engine_cloud = EngineCloud(secret_key=..., vault_access_token=...)
   storage = Storage(secret_key=...)
   

4. Create tools for AI agents – either use nebula.get_tools() (recommended) or combine individual service tools.
5. Integrate with frameworks such as LangChain or OpenAI Agents via provided adapters.

Key features of Thirdweb AI

• Insight: multi‑chain data queries (chains, transactions, blocks, events, prices, tokens).
• Engine: wallet creation, transaction signing, read/write contract calls.
• EngineCloud: server‑side wallets with KMS, cloud contract interaction, balance queries.
• Storage: IPFS upload/fetch through thirdweb gateway.
• Nebula: natural‑language powered AI agent that internally leverages all other services.
• Framework adapters: ready‑made tool adapters for LangChain, OpenAI, Coinbase Agentkit, GOAT SDK, etc.

Use cases of Thirdweb AI

• Building autonomous blockchain agents that can execute trades, mint NFTs, or query on‑chain data via chat.
• Creating analytics dashboards that surface real‑time token prices, transaction volumes, and event logs.
• Developing dApps with built‑in wallet management and secure server‑side transaction signing.
• Storing and retrieving decentralized assets (metadata, images) directly from IPFS.
• Integrating AI‑driven assistants into existing SaaS platforms for blockchain‑aware support.

FAQ

Q: Do I need to import all services when using Nebula? A: No. Nebula already calls Insight, Engine, EngineCloud, and Storage internally; mixing them can cause conflicts.

Q: Which language SDKs are available? A: Currently a full Python SDK is provided; a TypeScript SDK is announced for future release.

Q: How are credentials handled? A: Set THIRDWEB_SECRET_KEY (and optionally VAULT_ACCESS_TOKEN for EngineCloud) as environment variables.

Q: Can I run the MCP server on a cloud platform? A: Yes – the server runs as a standard Python entry point, so you can containerize it or deploy on any environment that supports Python.

Q: What frameworks are supported for AI tool integration? A: OpenAI Agents, LangChain, Coinbase Agentkit, GOAT SDK, among others; install the corresponding extras (e.g., thirdweb-ai[openai]).

thirdweb AI

AI Agents with Onchain Intelligence

📖 Overview

thirdweb AI is thirdweb's comprehensive toolkit for blockchain data analysis, wallet management, and AI agent interaction with blockchains. It simplifies complex blockchain operations into five core components: Insight for data analysis, Engine for wallet and contract operations, EngineCloud for cloud-based engine operations, Storage for decentralized file management, and Nebula for natural language-powered blockchain interactions.

🌐 Features

Insight

Comprehensive blockchain data intelligence:

• Chains: Multi-chain support and network information
• Transactions: Transaction analysis and monitoring
• Blocks: Block data exploration and metrics
• Events: Smart contract event tracking and filtering
• Prices: Real-time token price feeds
• Tokens: Detailed token information and analytics

Engine

Core blockchain interaction capabilities:

• Wallet: Secure wallet management and transaction signing
• Read: Read operations for smart contracts and blockchain data
• Write: Transaction creation and contract interaction

EngineCloud

Cloud-based engine operations with advanced capabilities:

• Server Wallets: Create and manage server wallets with KMS integration
• Contract Interaction: Read from and write to smart contracts
• Transaction Management: Send transactions and query transaction history
• Balance Queries: Check native token balances on various chains

Storage

Decentralized storage capabilities:

• Upload: Upload files, directories, and JSON data to IPFS
• Fetch: Retrieve content from IPFS using thirdweb gateway

Nebula

AI agent blockchain interaction:

• Natural Language Agent Action: Completing blockchain tasks through natural language instructions

🚀 Quickstart

MCP Server

Installation

### Run using uvx
THIRDWEB_SECRET_KEY=... \
    uvx thirdweb-mcp

### Install and run using pipx (and run thirdweb-mcp)
pipx install thirdweb-mcp

THIRDWEB_SECRET_KEY=... \
    thirdweb-mcp

More information

Python SDK

Installation

# Install core package with all framework adapters
pip install "thirdweb-ai[all]"

# Or install with specific framework adapters
pip install "thirdweb-ai[openai]"    # For OpenAI Agents
pip install "thirdweb-ai[langchain]" # For LangChain
pip install "thirdweb-ai[agentkit]" # For Coinbase Agentkit
pip install "thirdweb-ai[goat]" # For GOAT SDK
# ... many more framework supported

See the list of supported framework and installation guides

Basic Usage

from thirdweb_ai import Engine, EngineCloud, Insight, Nebula, Storage, Tool

# Initialize services
insight = Insight(secret_key=...)
nebula = Nebula(secret_key=...)
engine = Engine(...)
engine_cloud = EngineCloud(secret_key=..., vault_access_token=...)  # For cloud-based operations
storage = Storage(secret_key=...)

# Example: Create tools for AI agents
# Option 1: Use Nebula alone (recommended when you need a self-sufficient blockchain agent)
# Nebula already uses most other services internally
tools = [
    *nebula.get_tools(),
]

# Option 2: Use individual services directly without Nebula
# tools = [
#     *insight.get_tools(),
#     *engine.get_tools(),
#     *engine_cloud.get_tools(),
#     *storage.get_tools(),
# ]

# Example: Framework integration (LangChain)
from thirdweb_ai.adapters.langchain import get_langchain_tools
langchain_tools = get_langchain_tools(tools)
agent = create_tool_calling_agent(tools=langchain_tools, ...)

# Example: Framework integration (OpenAI Agents)
from thirdweb_ai.adapters.openai import get_openai_tools
openai_tools = get_openai_tools(tools)
agent = Agent(name="thirdweb Assistant", tools=tools)

# see python/examples for other framework integration

More information

TypeScript SDK

Coming soon.

📜 Documentation

For comprehensive documentation, please visit:

• thirdweb Documentation

🚨 Security and Bug Reports

We take security seriously. If you discover a security vulnerability within thirdweb AI, please email security@thirdweb.com rather than using the issue tracker.

For non-security-related bugs, please use the GitHub issue tracker.

⚠️ Important Usage Notes

When using Nebula, do not combine it with other tools (Insight, Engine, EngineCloud, Storage) in the same agent implementation as Nebula already calls these tools in the background. Using them together can lead to compatibility issues and unexpected behavior.

📦 Publishing Workflow

To publish a new version of thirdweb AI packages:

1. Create a git tag for the new version: git tag -a v0.X.Y -m "Release v0.X.Y"
2. Push the tag to GitHub: git push origin v0.X.Y
3. Go to GitHub and create a release using this tag
4. The CI/CD pipeline will automatically build and publish both packages to PyPI with matching version numbers

📧 Contact

• Website: thirdweb.com
• X: @thirdweb
• Telegram: Join our community
• Discord: Join our community
• Email: support@thirdweb.com

📝 License

thirdweb AI is licensed under the Apache-2.0 License. See the LICENSE file for details.