Compatible with every major AI agent and IDE
What is the ThirdWeb MCP Server?
Connect your ThirdWeb account to any AI agent to build and manage Web3 applications through natural language. This server provides a comprehensive suite of tools for blockchain interaction and identity management.
What you can do
- Authentication & Identity — Handle email, SMS, social, and passkey logins. Link multiple social profiles to a single wallet address using
initiate_authandlink_profile. - Wallet Management — Retrieve authenticated user details, search for users by address or email, and pre-generate wallets for new users via
get_user_detailsandpregenerate_wallet. - Smart Contract Interaction — Execute read-only multicalls or state-changing transactions across any supported chain using
read_contractandwrite_contract. - Event Monitoring — Query historical contract events with advanced filtering for data analysis using
query_events.
How it works
- Subscribe to this server
- Provide your ThirdWeb Secret Key and API URL
- Start building Web3 workflows from your favorite MCP client
Who is this for?
- Web3 Developers — Rapidly prototype contract interactions and test auth flows directly from the IDE.
- DApp Operators — Manage user profiles and monitor contract events without custom scripts.
- Product Managers — Query on-chain data and user details to understand platform activity.
Built-in capabilities (29)
Broadcast a transaction on Solana
Verify challenge and complete login
Create a Solana wallet
Deploy a contract using bytecode and ABI
Execute a token swap on Solana Mainnet
Proxy a request to a paid API using x402
Generate payment requirements for a resource (x402)
Get Solana wallet balance
Get a token swap quote on Solana Mainnet
Get status of a transaction
Search for users in your project
Retrieve details of the authenticated user
Start authentication process for email, phone, passkey, or SIWE
Tie multiple social identities to a single wallet address
List Solana wallets
List transactions
Create a wallet for a user before they first log in
Fetch historical events for a contract
Fetch transaction history for a contract
Execute one or more read-only calls (multicall)
Broadcast encoded transactions
Send Solana tokens
Submit the payment on-chain (x402)
Sign a message on Solana
Sign a transaction on Solana
OAuth flow for social providers
Unlink a social identity from a wallet address
Validate a signed payment payload (x402)
Execute one or more state-changing calls atomically
Why Mastra AI?
Mastra's agent abstraction provides a clean separation between LLM logic and ThirdWeb tool infrastructure. Connect 29 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
- —
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add ThirdWeb without touching business code
- —
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
- —
TypeScript-native: full type inference for every ThirdWeb tool response with IDE autocomplete and compile-time checks
- —
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
ThirdWeb in Mastra AI
ThirdWeb and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect ThirdWeb to Mastra AI through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.
Raw MCP | Vinkius | |
|---|---|---|
| Server catalog | Find and host yourself | 4,000+ managed |
| Infrastructure | Self-hosted | Sandboxed V8 isolates |
| Credential handling | Plaintext in config | Vault + runtime injection |
| Data loss prevention | None | Configurable DLP policies |
| Kill switch | None | Global instant shutdown |
| Financial circuit breakers | None | Per-server limits + alerts |
| Audit trail | None | Ed25519 signed logs |
| SIEM log streaming | None | Splunk, Datadog, Webhook |
| Honeytokens | None | Canary alerts on leak |
| Custom domains | Not applicable | DNS challenge verified |
| GDPR compliance | Manual effort | Automated purge + export |
Why teams choose Vinkius for ThirdWeb in Mastra AI
The ThirdWeb MCP Server runs on Vinkius-managed infrastructure inside AWS — a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts. All 29 tools execute in hardened sandboxes optimized for native MCP execution.
Your AI agents in Mastra AI only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
How Vinkius secures
ThirdWeb for Mastra AI
Every tool call from Mastra AI to the ThirdWeb MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.
Frequently asked questions
Can I read data from a smart contract without paying gas?
Yes! Use the read_contract tool. It performs read-only calls (multicall) to the blockchain, which do not require gas or state changes.
How do I start an authentication flow for a new user?
You can use the initiate_auth tool by specifying the method (email, sms, etc.) and the user's identifier. Then, use complete_auth with the verification code to finish the login.
Can I find a user's profile if I only have their wallet address?
Absolutely. Use the get_user_details tool and provide the address parameter. The agent will return any associated user IDs, emails, or phone numbers linked to that wallet in your project.
How does Mastra AI connect to MCP servers?
Create an MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.
Can Mastra agents use tools from multiple servers?
Yes. Pass multiple MCP clients to the agent constructor. Mastra merges all tool schemas and the agent can call any tool from any server.
Does Mastra support workflow orchestration?
Yes. Mastra has a built-in workflow engine that lets you chain MCP tool calls with branching logic, error handling, and parallel execution.
createMCPClient not exported
Install: npm install @mastra/mcp
Explore More MCP Servers
View all →
Currency Math Engine
1 toolsStop financial calculation errors. Perform strict integer-based currency math for invoices, taxes, and cart totals.

BrioHR
10 toolsOrchestrate BrioHR management — retrieve employee profiles, monitor leave, and integrate claim reports directly from any AI agent.

Trimble
10 toolsEquip your AI agent with enterprise-grade truck routing, commercial geocoding, and advanced toll cost logistics algorithms.

Yousign
12 toolsSecure electronic signatures for documents and contracts with AI using Yousign V3.
