wallet-inspector-mcp

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.

!GitHub License !Python Version !Status

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

1. Install Dependencies:

Using uv (recommended):

   uv async

Or using pip:

   pip install mcp[cli] python-dotenv tabulate

1. Installing to Claude Desktop:

Install the server as a Claude Desktop application: ``bash 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   |
  +==========+=================+=============+
  | ethereum | 605.371497 ETH  | $1842034.66 |
  +----------+-----------------+-------------+
  | polygon  | 100.500000 MATIC| $50.25      |
  +----------+-----------------+-------------+
  | bsc      | 10.000000 BNB   | $600.00     |
  +----------+-----------------+-------------+

  Wallet DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK balances:

  +----------+---------------+-------------+
  | Chain    | Token Amount  | USD Value   |
  +==========+===============+=============+
  | solana   | 1.000000 SOL  | $20.50      |
  +----------+---------------+-------------+

• Activity Output (EVM only):

  Wallet 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 activity:

  Chain ID: 8453
  Block Time: 2025-02-20T13:52:29+00:00
  Tx Hash: 0x184544c8d67a0cbed0a3f04abe5f958b96635e8c743c070f70e24b1c06cd1aa6
  Type: Receive
  Asset Type: ERC20
  Value: 123.069653 ENT
  USD Value: $0.14

• Transaction Output:

  Wallet 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 transactions:

  Chain: ethereum
  Block Time: 2023-11-07T05:31:56Z
  Tx Hash: 0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
  From: 0xd8da6bf26964af9d7eed9e03e53415d37aa96045
  To: 0x1234567890abcdef1234567890abcdef12345678
  Value: 0.000320 ETH

  Wallet DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK transactions:

  Chain: solana
  Block Time: 2023-03-28T09:20:00Z
  Tx Hash: 5SzSbWKM9yZC7cCGMhUhvnYdWQytrk9NBaWwug1gQBKKwNEBvBKqPSfVeYYnZwUuUyvcCHgYhDkTRrB6YBfwzfv8
  From: DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK
  To: 9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin
  Value: 0.010000 SOL

Tools

get_wallet_balance

• Description: Retrieves the balance of a specified wallet address across supported EVM and Solana blockchains.
• Parameters:
• wallet_address (str): The wallet address to query (e.g., '0x123...' for EVM chains or 'DYw8jCT...' for Solana).
• Returns: An ASCII table with balance details (chain, token amount, USD value) or an error message.
• Supported Chains: Solana,arbitrum,arbitrum,avalanche_c,base,berachain,bnb,ethereum and more.

get_wallet_activity

• Description: Queries transaction activity for a specified wallet address on supported EVM blockchains.
• Parameters:
• wallet_address (str): The EVM-compatible wallet address to query (e.g., '0x123...').
• Returns: Formatted text with activity details (chain_id, block_time, tx_hash, type, asset_type, value, value_usd) or an error message.
• Supported Chains: Arbitrum,arbitrum,avalanche_c,base,berachain,bnb,ethereum and more.

get_wallet_transactions

• Description: Fetches the transaction history of a specified wallet address on supported EVM and Solana blockchains.
• Parameters:
• wallet_address (str): The wallet address to query (e.g., '0x123...' for EVM chains or 'DYw8jCT...' for Solana).
• limit (int, optional): Maximum number of transactions to return (default: 100).
• Returns: Formatted text with transaction details (chain, block_time, tx_hash, from, to, value) or an error message.
• Supported Chains: Solana,arbitrum,arbitrum,avalanche_c,base,berachain,bnb,ethereum and more.

License

This project is licensed under the MIT License. See the LICENSE file for details.