MetaMask MCP

A Model Context Protocol (MCP) server that allows LLM to interact with the blockchain through MetaMask.

With these tools, your private keys remain securely stored in your crypto wallet and are never shared with the AI agent when signing messages or sending transactions.

Preview

https://github.com/user-attachments/assets/3fe8f20b-4666-4c36-8030-04d3e5d587c7

Requirements

Node.js (v20 or higher)
pnpm

Setup

Clone the repository

git clone https://github.com/Xiawpohr/metamask-mcp.git
cd metamask-mcp

Install dependencies

pnpm install

Build the project

pnpm build

Using with Claude Desktop

Follow the guide https://modelcontextprotocol.io/quickstart/user and add the following configuration:

{
  "mcpServers": {
    "metamask": {
      "command": "node",
      "args": [
        "/PATH/TO/YOUR_PROJECT/dist/index.ts"
      ]
    }
  }
}

Tools

call: Executing a new message call immediately without submitting a transaction to the network.
get-chain-list: Get a list of all chains information.
get-connect-uri: Get the connect URI to connect to a MetaMask wallet.
show-connect-qrcode: Show the connect QR code for a given connect URI.
deploy-contract: Deploy a contract to the network, given bytecode, and constructor arguments.
disconnect: Disconnect the wallet.
estimate-fee-per-gas: Estimate for the fees per gas (in wei) for a transaction to be likely included in the next block.
estimate-gas: Estimate the gas necessary to complete a transaction without submitting it to the network.
get-account: Get the current account.
get-native-currency-balance: Get the native currency balance of an address.
get-token-balance: Get token balance of an address.
get-block-number: Fetch the number of the most recent block seen.
get-block: Fetch information about a block at a block number, hash or tag.
get-chain-id: Get the current chain id.
get-chains: Get the configured chains.
get-ens-address: Fetch the ENS address for name.
get-ens-name: Fetch the primary ENS name for address.
get-gas-price: Fetch the current price of gas (in wei).
get-token: Fetch the token information.
get-transaction-reeceipt: Fetch the Transaction Receipt given a Transaction hash.
get-transaction: Fetch transaction given hash or block identifiers.
read-contract: Call a read-only function on a contract, and returning the response.
send-transaction: Send transactions to networks.
sign-message: Sign a message.
switch-chain: Switch the target chain.
verify-message: Verify that a message was signed by the provided address.
wait-for-transaction-receipt: Waits for the transaction to be included on a block, and then returns the transaction receipt.
write-contract: Execute a write function on a contract.

Prompts

be-metamask-assistant

Contributing

Contributions are welcome! Please submit pull requests with any improvements or bug fixes.

License

MIT License