Wallet Inspector

Wallet Inspector MCP is an MCP server that enables AI agents to query and inspect wallet balances and on-chain activity across major EVM chains and Solana. It provides structured outputs that make it easy to understand holdings and activity, empowering automated workflows and analytics.

How to use

To use the Wallet Inspector MCP, connect with an MCP-compatible client and issue natural language queries or structured prompts. You can request balances for a wallet, view activity on supported chains, or fetch transaction histories across EVM and Solana networks. The server returns ASCII tables for balances and structured text for activities and transactions, making it simple to pipe results into dashboards, reports, or other automation.

How to install

Prerequisites you need before installing are:
- Python 3.10 or higher
- Dune SIM API Key (obtainable from Dune Analytics)
- A dependency manager: uv (recommended) or pip

# 1) Clone the project 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

Configuration and runtime setup

You can install and run the MCP as a Claude Desktop application. The following configuration enables Claude Desktop to start the Wallet Inspector MCP as a local process and pass the required API key to Dune SIM.

{
  "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 replace your_dune_sim_api_key_here with your Dune SIM API key.

## What you can query and output formats

You can perform the following kinds of queries: balance checks, wallet activity on EVM chains, and transaction histories for wallets on supported chains. Balances are returned as ASCII tables, while activity and transaction results are provided as structured text for easy parsing.

## Notes on usage with your MCP client

Use an MCP-compatible client to issue queries. Examples include asking for a wallet’s balance, requesting recent transactions, or viewing on-chain activity. The server renders the results in a consistent, readable format so you can integrate them into your tooling.

## Examples of supported tools and endpoints

- get\_wallet\_balance: Retrieves the balance of a specified wallet across supported EVM and Solana blockchains. Returns an ASCII table with chain, token amount, and USD value or an error message. Supported chains include Solana, Arbitrum, Avalanche C, Base, Berachain, BNB, Ethereum, and more.

- get\_wallet\_activity: Queries transaction activity for a wallet on supported EVM blockchains. Returns formatted text with chain\_id, block\_time, tx\_hash, type, asset\_type, value, and USD value. Supported chains include Arbitrum, Avalanche C, Base, Berachain, BNB, Ethereum, and more.

- get\_wallet\_transactions: Fetches transaction history for a wallet on supported EVM and Solana blockchains. Returns formatted text with chain, block\_time, tx\_hash, from, to, and value. Supported chains include Solana, Arbitrum, Avalanche C, Base, Berachain, BNB, Ethereum, and more.

## Security and keys

Protect your Dune SIM API key and any environment variables. Do not share keys in logs or publicly accessible files. Use repository-level and machine-level environment management practices to keep secrets secure.

## Troubleshooting and notes

If queries return errors, verify that the Dune SIM API key is set in your environment and that the Wallet Inspector MCP is running with the correct directory path. Check that the MCP client you are using is configured to connect to the Wallet Inspector server as shown in the runtime configuration.

## Examples of interactions

Balance example: you ask for a specific wallet’s balances and receive an ASCII table listing the balance by chain, token amount, and USD value. Activity example: you request activity for a wallet and receive a structured list including block time, transaction hash, and value details. Transaction example: you request the latest transactions and receive a structured summary with chain, time, hash, and value.

## Tools and endpoints overview

The following tools are exposed for programmatic access through the MCP server: get\_wallet\_balance, get\_wallet\_activity, and get\_wallet\_transactions. Each tool returns data in a predictable format to facilitate automation and integration with dashboards, monitoring, or analytics pipelines.

## Available tools

### get\_wallet\_balance

Retrieves the balance of a specified wallet address across supported EVM and Solana blockchains.

### get\_wallet\_activity

Queries transaction activity for a specified wallet address on supported EVM blockchains.

### get\_wallet\_transactions

Fetches the transaction history of a specified wallet address on supported EVM and Solana blockchains.