# ThirdWeb MCP for AI Agents AI Agent Connect > ThirdWeb gives your AI agent the keys to the blockchain. It handles everything from user authentication and wallet management to complex smart contract interactions and on-chain event monitoring. Instead of building custom scripts for every dApp feature, your agent can now manage multi-chain identities, execute transactions, and query real-time data across networks like Solana and Ethereum. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_KhWEJmIapQZBs4p23iZkkzK1vQKep4Z1V72uCf9T/ai-agent-connect - **Tags:** web3, smart-contracts, wallet-management, authentication, ethereum ## Description ThirdWeb lets you connect your AI agent to the blockchain so it can perform real-world actions rather than just talking about them. You can move past simple text responses and let your agent perform tasks like verifying a user's identity through social logins, managing wallet balances, or triggering smart contract functions. It handles the heavy lifting of multi-chain compatibility, so your agent can navigate different networks without you having to swap out different libraries or SDKs. This is how you build a dApp that actually feels functional. You can set up complex onboarding flows where a user links a social profile to a wallet, or build a tool that monitors specific contract events and summarizes them in plain English. Whether you're a developer trying to prototype a new DeFi protocol or an operator who needs to check user activity across dozens of addresses, this Connector makes the blockchain accessible. It's one of the many ways Vinkius helps bridge the gap between your local environment and the decentralized web, making it easier to move from idea to deployment. You get a reliable way to handle transactions, query data, and manage users while your agent does the communication. It removes the need to manually copy-paste hex codes or watch block explorers all day. Your agent handles the technical details so you can focus on the product features. ## Tools ### execute_solana_swap Perform a token swap on the Solana Mainnet. It lets your agent trade one asset for another automatically. ### fetch_with_payment Request data from a paid API using a 402 payment status. It handles the logic of fetching content that requires a fee. ### get_solana_swap_quote Get the current price and details for a token swap on Solana. This helps you see the best rates before executing a trade. ### get_user_details Search your project's user database by email or wallet address. This helps you identify specific people interacting with your app. ### list_transactions Show a history of transactions for a specific account or contract. This is great for auditing recent activity. ### pregenerate_wallet Create a wallet for a user before they even log in. This makes the onboarding experience feel much faster. ### query_events Pull historical events from a smart contract with specific filters. Use this to analyze past interactions on the chain. ### query_transactions Fetch the full transaction history for a specific contract. It's useful for seeing every time a contract was interacted with. ### read_contract Make one or more read-only calls to a smart contract. Use this to get current state data like token prices or balances. ### send_raw_transactions Broadcast a transaction that has already been encoded. This gives you low-level control over the data being sent to the chain. ### sign_solana_transaction Sign a transaction on the Solana blockchain. This is necessary before a transaction can be broadcast to the network. ### unlink_profile Remove a social identity from a specific wallet address. This gives users control over which accounts are connected to their wallet. ### verify_payment Check a signed payment payload to see if it's valid. This is the first step in processing paid requests. ### write_contract Execute state-changing calls on a smart contract. Use this to actually move funds, change settings, or update data on-chain. ### broadcast_solana_transaction Send a transaction to the Solana network. This helps you push data or actions onto the chain quickly. ### list_solana_wallets View a list of existing Solana wallets. Use this to audit or manage multiple accounts in one place. ### deploy_contract Put a new smart contract onto the blockchain using its bytecode and ABI. This is the primary way to launch new dApp functionality. ### get_payment_requirements Find out what's needed to pay for a specific resource. This identifies the costs before you make a request. ### get_solana_balance Check the current amount of native tokens in a Solana wallet. It's a quick way to verify a user's funds. ### get_transaction_status Check if a blockchain transaction was successful or is still pending. Use this to give users real-time feedback on their actions. ### get_wallet_me Pull the details of the user who is currently signed in. It's the quickest way to see who's using your agent right now. ### initiate_auth Start the login process for email, phone, passkeys, or social accounts. This kicks off the security handshake with the user. ### link_profile Connect different social identities to a single wallet address. It helps users stay logged in across different platforms. ### send_solana_tokens Move tokens from one Solana wallet to another. This is the standard way to handle transfers on the Solana network. ### settle_payment Finalize an on-chain payment for a resource. This completes the transaction after a payment has been verified. ### sign_solana_message Create a digital signature for a message on the Solana network. It's used for verifying off-chain actions with on-chain keys. ### social_auth Run an OAuth flow for various social media providers. It lets users log in using their existing Google, Twitter, or Discord accounts. ### complete_auth Verify a login challenge and finish the authentication process. It's the final step in a user's secure login. ### create_solana_wallet Generate a new wallet specifically for the Solana blockchain. This helps users get started on the network immediately. ## Prompt Examples **Prompt:** ``` Check the balance of 0x123... on Solana. ``` **Response:** ``` I've checked the wallet balance for you. Here is the current status: | Asset | Balance | | :--- | :--- | | SOL | 12.45 | | USDC | 1,200.00 | **Status:** ✅ Active The wallet is currently connected and has sufficient funds for standard transactions. ``` **Prompt:** ``` Who is the user with email test@example.com? ``` **Response:** ``` I found the user details associated with that email: * **User ID:** user_987 * **Wallet Address:** 0xAbc123... * **Linked Profiles:** Twitter, Discord This user is currently active on the mainnet and has completed their profile setup. ``` **Prompt:** ``` What was the last swap for this contract? ``` **Response:** ``` The most recent transaction for that contract was a token swap: * **Amount:** 50.00 Tokens * **Received:** 1.25 ETH * **Time:** 2 hours ago * **Status:** Success Would you like me to pull the full transaction history for this contract? ``` ## Capabilities ### Verify user logins via social or email Your agent can handle secure logins using familiar methods like Google, Twitter, or passkeys. ### Link multiple social profiles to one wallet Users can connect different identities to a single blockchain address for a smoother experience. ### Search for users by email or wallet address Find specific user accounts in your project database using common identifiers. ### Execute read-only and state-changing contract calls Perform complex actions like moving funds or updating settings on any supported blockchain. ### Monitor historical contract events and transactions Pull past data from the chain to analyze interactions or provide historical context to users. ### Create and pre-generate wallets for new users Have accounts ready for users before they even sign up to speed up the onboarding process. ### Perform token swaps and balance checks on Solana Trade assets and verify funds on the Solana network with simple natural language commands. ## Use Cases ### Automated Social Onboarding A new user wants to join a dApp. The agent uses initiate_auth via email, then guides them through complete_auth to link their Twitter account using link_profile. ### Real-time DeFi Dashboard A user asks for their current token price. The agent calls read_contract to get the latest data and get_solana_balance to show their current holdings. ### On-chain Audit Summary An operator wants to see recent trades. The agent uses query_transactions and query_events to pull a list and summarize the top 5 biggest swaps. ### Token Distribution A project lead wants to send 100 tokens to a partner. The agent uses send_solana_tokens to execute the transfer and then checks get_transaction_status to confirm it finished. ## Benefits - Automate user onboarding by using initiate_auth and complete_auth to handle email and social logins without manual forms. - Manage multi-chain identities easily by using link_profile to connect various social accounts to a single wallet. - Query real-time blockchain data using read_contract to show users live prices and balances directly in your app. - Monitor on-chain activity with query_events to create automated alerts or summaries of contract interactions. - Simplify Solana interactions by using execute_solana_swap and send_solana_tokens to handle trades and transfers. - Speed up the user experience by using pregenerate_wallet to have accounts ready before a user even signs up. ## How It Works The bottom line is it turns complex blockchain interactions into simple natural language commands. 1. Subscribe to the ThirdWeb MCP and add your Secret Key and API URL to your configuration. 2. Connect your preferred AI client like Claude or Cursor to the Vinkius marketplace. 3. Ask your agent to perform blockchain tasks like checking balances or querying contract data. ## Frequently Asked Questions **Can the ThirdWeb MCP help users log in with social media?** Yes, it supports social auth flows so users can sign in with familiar accounts like Google or Twitter instead of just a wallet. This makes your dApp much more accessible to non-crypto users. **Does ThirdWeb MCP work for Solana?** Yes, it has specific tools for Solana balances, swaps, and token transfers in addition to standard smart contract tools. You can manage both Ethereum and Solana assets through the same connection. **Can I use ThirdWeb MCP to manage multiple user wallets?** It allows you to search for users by email or address and pre-generate wallets to make the onboarding process much smoother. This helps you keep track of your user base without manual data entry. **Can ThirdWeb MCP help with paid API requests?** It includes tools to handle x402 payment requirements, allowing your agent to fetch data from gated services securely. This is great for pulling premium data into your agent's workflow. **Is ThirdWeb MCP good for building dApps?** It is a core tool for dApp developers because it handles the identity, wallet, and contract logic that usually requires a lot of custom code. It lets your agent act as a bridge between the user and the blockchain. **How do I use ThirdWeb MCP to check my transaction status?** Your agent can use the transaction status tool to check if a specific blockchain action was successful or is still pending. It can then report this status back to the user in plain English. **Can ThirdWeb MCP help me deploy a new smart contract?** Yes, it includes a tool to deploy contracts using bytecode and ABI. This allows your agent to help you launch new functionality on the blockchain directly through your AI client. **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.