Wallet Inspector MCP

An MCP server that empowers AI agents to inspect any wallet’s balance and onchain activity across major EVM chains and Solana chain.

Features

• Multi-Chain Support: Queries Solana, Ethereum, Polygon, Binance Smart Chain (BSC), Base, Arbitrum and more.
• Flexible Output: Balances in ASCII tables, activities and transactions in structured text.

Installation

Prerequisites

• Python: Version 3.10 or higher.
• Dune SIM API Key: Obtain from Dune Analytics.
• Dependency Manager: uv (recommended) or pip.

Setup

1. Clone the Repository:

   git clone https://github.com/kukapay/wallet-inspector-mcp.git
   cd wallet-inspector-mcp
   

2. Install Dependencies:

   Using uv (recommended):

   uv async
   

   Or using pip:

   pip install mcp[cli] python-dotenv tabulate
   

3. Installing to Claude Desktop:

   Install the server as a Claude Desktop application:

   uv run mcp install cli.py --name "Wallet Inspector"
   

   Configuration file as a reference:

   {
      "mcpServers": {
          "Wallet Inspector": {
              "command": "uv",
              "args": [ "--directory", "/path/to/wallet-inspector-mcp", "run", "main.py" ],
              "env": { "DUNE_SIM_API_KEY": "your_dune_sim_api_key_here"},               
          }
      }
   }
   

   Replace /path/to/wallet-inspector-mcp with your actual installation path, and your_dune_sim_api_key_here with your Dune SIM API key.

Usage

Interacting with the Server

Use an MCP-compatible client (e.g., Claude Desktop CLI) to query the server. Example natural language queries:

• Balance Queries:

  • “Check the balance of wallet 0xd8da6bf26964af9d7eed9e03e53415d37aa96045.”
  • “What is the balance for wallet DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK?”
  • “Get balances for 0x1234567890abcdef1234567890abcdef12345678 on EVM chains.”

• Activity Queries (EVM only):

  • “Show activity for wallet 0xd8da6bf26964af9d7eed9e03e53415d37aa96045.”
  • “Get transaction history for 0x1234567890abcdef1234567890abcdef12345678 on EVM chains.”

• Transaction Queries:

  • “List transactions for wallet 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 with limit 50.”
  • “Show transaction history for wallet DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK.”
  • “Get the latest 10 transactions for 0x1234567890abcdef1234567890abcdef12345678.”

Example Outputs

• Balance Output:

  Wallet 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 balances:
  
  +----------+-----------------+-------------+
  | Chain    | Token Amount    | USD Value   |
  +==========+=================+=============+