# Privy MCP > Privy connects your AI client directly to Web3 identity infrastructure. Manage users, create wallets across Ethereum, Solana, Bitcoin, and Sui, and execute blockchain actions—all through natural conversation. Check user profiles, provision new wallets in batches up to 100, or retrieve specific transaction details without leaving your agent environment. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** web3, embedded-wallets, user-onboarding, authentication, crypto-infrastructure ## Description This MCP lets you manage the core infrastructure of any Web3 application using simple language commands. Instead of writing complex API calls for every new user or wallet status check, you talk to your AI client, and it handles the heavy lifting. You can instantly create a new user object, look up existing profiles by email address, or provision wallets in large batches. Need to confirm if a transaction succeeded? Just ask. The system retrieves specific wallet data or checks recent transactions using external IDs. This ability to manage complex identity lifecycle—from creating accounts to performing RPC actions on managed wallets—all via chat is what makes this MCP invaluable. When you connect it through Vinkius, you get access to the full spectrum of user and wallet operations in one place. ## Tools ### batch_create_wallets Creates multiple new crypto wallets in bulk, supporting up to 100 addresses at once. ### create_user Registers a brand-new user profile object and links it to one or more accounts. ### create_wallet Generates a single new wallet for the system to use with a user. ### delete_user Permanently removes a specified user record from the database. ### get_transaction_by_external_id Retrieves transaction details by providing an external tracking ID. ### get_transaction Fetches full information about a specific blockchain transaction. ### get_user_by_email Finds and returns a user's profile data using their email address. ### get_user Retrieves all available metadata for a specific user ID. ### get_wallet Gets the current details and status of a known wallet address. ### search_users Searches the entire user database using keywords or partial profile data. ### update_wallet Modifies an existing wallet's metadata, policies, or ownership settings. ### wallet_rpc Executes arbitrary blockchain Remote Procedure Calls (RPC) actions on a managed wallet. ## Prompt Examples **Prompt:** ``` Search for users with the term 'beta-tester' in Privy. ``` **Response:** ``` I found 3 users matching 'beta-tester'. The most recent is user `did:privy:cl...` linked to `tester1@example.com`. Would you like to see their full profile details? ``` **Prompt:** ``` Create a new Ethereum wallet with the display name 'Main Treasury'. ``` **Response:** ``` Successfully created a new Ethereum wallet. ID: `wa_123...`, Address: `0x71C...`. It is now ready for use in your application. ``` **Prompt:** ``` Get the user details for email 'alice@company.com'. ``` **Response:** ``` Retrieved profile for Alice. She has a linked Google account and one embedded Solana wallet (`6xY...`). Her Privy ID is `did:privy:ck...`. ``` ## Capabilities ### User Profile Lookup Find users by email address or search for profiles using keywords, retrieving detailed metadata. ### Wallet Provisioning Create new crypto wallets across multiple chains (Ethereum, Solana, Bitcoin, Sui), either one-by-one or in bulk batches of up to 100. ### Identity Management Create new user records and securely delete old ones when they are no longer needed. ### Wallet State Modification Update wallet metadata, change ownership policies, or retrieve specific details for any known wallet ID. ### Blockchain Action Execution Execute direct RPC calls through managed wallets, allowing actions like signing messages or sending transactions. ## Use Cases ### Onboarding a new client A Product Manager needs to verify if a potential client, Jane Doe, already has an account. They prompt their agent: 'Get the user details for jane@company.com.' The agent uses `get_user_by_email` and immediately returns her profile ID and linked wallet status. ### Auditing system accounts A DevOps Engineer must update the ownership policy on a critical treasury wallet for compliance. They instruct their agent to use `update_wallet`, specifying the new owner details, ensuring the change is logged and executed immediately. ### Running large-scale tests A developer needs 50 fresh test wallets for a network stress test. Instead of running 50 separate scripts, they ask their agent to `batch_create_wallets` with the desired chain type and receive all credentials instantly. ### Investigating failed transfers A support team member receives a ticket about a missing payment. They use `get_transaction_by_external_id`, providing the tracking ID, and the agent confirms if the transaction was successful or stuck. ## Benefits - Instead of manually querying APIs to check if a user exists, you simply ask your agent using the `get_user` or `get_user_by_email` tools. It handles the lookup immediately. - Need to test out a new feature? Use `batch_create_wallets` to provision up to 100 test wallets at once, eliminating slow manual setup steps. - When you need to confirm a complex blockchain action, use `get_transaction_by_external_id`. You get the transaction status without needing raw node access. - Managing identity is simpler: Use `create_user` to onboard accounts and `delete_user` when an account needs to be retired, all via conversational commands. - The flexibility of `wallet_rpc` lets you perform specialized actions—like signing a message or sending a transaction—that go beyond simple reads. ## How It Works The bottom line is you manage complex Web3 identity and wallet infrastructure using natural language commands inside your existing AI workflow. 1. Subscribe to this MCP and enter your Privy App ID and App Secret credentials. 2. Connect the MCP to any compatible AI client (Claude, Cursor, etc.) within your chosen workspace. 3. Start interacting with it by asking your agent to perform actions like 'search for users' or 'batch create wallets'. ## Frequently Asked Questions **How do I create multiple wallets using the Privy MCP?** You use the `batch_create_wallets` tool. This lets you provision up to 100 new crypto wallets in a single command, which is much faster than creating them one by one. **Can I check if a user exists with Privy MCP?** Yes, you can use `get_user` or `search_users`. If the agent returns profile data, the account exists; otherwise, it confirms that no matching records were found. **What if I need to change a wallet's owner?** You use the `update_wallet` tool. This lets you modify metadata and policies for an existing wallet ID, allowing you to safely transfer ownership or update credentials. **Does Privy MCP handle transaction history lookups?** Yes. You can fetch specific transactions using `get_transaction` or narrow down the search by providing a known external tracking identifier via `get_transaction_by_external_id`. **Is Privy MCP only for Ethereum wallets?** No, it supports multiple chains. You can provision and manage assets across several networks including Solana, Bitcoin, Sui, and Ethereum.