Add Token to MetaMask

WHAT IT DOES

This tool helps you add any ERC-20 token to your MetaMask wallet by providing the token contract address. It automatically fetches the token's symbol and decimals from the blockchain, or you can manually specify them. Optionally, you can provide a logo URL to display the token's icon in MetaMask. The tool then sends a wallet_watchAsset request to MetaMask, which prompts the user to confirm adding the token. All processing happens locally — nothing is sent to any server.

HOW TO USE

Connect your MetaMask wallet using the Connect button. Paste the token contract address into the "Token Contract Address" field. Optionally, you can manually enter the token symbol, decimals, and a logo URL. Click "Fetch Details" to automatically retrieve the symbol and decimals from the blockchain. Click "Add Token to MetaMask" to send the request to MetaMask. MetaMask will display a prompt asking you to confirm adding the token. Approve the request to add the token to your wallet's token list.

TECHNICAL MECHANISM

This tool uses the MetaMask wallet_watchAsset RPC method, which is the standard way for dApps to request token additions. When you click "Add Token," the tool constructs a token parameters object containing the contract address, symbol, decimals, and optional logo URL. It then calls provider.send('wallet_watchAsset', { type: 'ERC20', options: tokenParams }) through the BGWallet bridge. MetaMask validates the request, displays a confirmation prompt to the user, and if approved, adds the token to the wallet's token list. The tool also supports fetching token metadata directly from the blockchain using the ethers.js library — it queries the token contract's symbol() and decimals() view functions to auto-populate these fields.

WHAT IT CANNOT SEE

This tool cannot verify if the token contract is legitimate or malicious. It cannot detect if the token has been exploited, has malicious functionality, or is a scam. The tool cannot verify the accuracy of the symbol, decimals, or other metadata — it trusts either the user input or the contract's own reported values, which could be misleading. It cannot force MetaMask to add the token if the user denies the request. The tool cannot add tokens to other wallets that do not support the wallet_watchAsset API, such as some mobile wallets or older MetaMask versions. It cannot detect whether the token is already added to the wallet. The tool does not validate if the token contract is actually an ERC-20 token or if it implements the standard correctly.

PLEASE NOTE

This tool works only with EVM-compatible wallets that support the wallet_watchAsset RPC method (MetaMask, Trust Wallet, Coinbase Wallet, and others). The wallet_watchAsset API may not be available in all wallet versions or on all networks. Always verify token contract addresses from trusted sources before adding them. Adding a malicious token can expose you to scams or phishing attempts. This tool is provided as a convenience utility; you are solely responsible for verifying the legitimacy of any token you add. This tool does not store or transmit any data — all processing occurs in your browser.