Wallet Inspector MCP

1# Wallet Inspector MCP
2 
3An MCP server  that empowers AI agents to inspect any wallet’s balance and onchain activity across major EVM chains and Solana chain.
4 
5![GitHub License](https://img.shields.io/github/license/kukapay/wallet-inspector-mcp)
6![Python Version](https://img.shields.io/badge/python-3.10+-blue)
7![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
8 
9## Features
10 
11- **Multi-Chain Support**: Queries Solana, Ethereum, Polygon, Binance Smart Chain (BSC), Base, Arbitrum and more.
12- **Flexible Output**: Balances in ASCII tables, activities and transactions in structured text.
13 
14## Installation
15 
16### Prerequisites
17 
18- **Python**: Version 3.10 or higher.
19- **Dune SIM API Key**: Obtain from [Dune Analytics](https://dune.com).
20- **Dependency Manager**: `uv` (recommended) or `pip`.
21 
22### Setup
23 
241. **Clone the Repository**:
25 
26   ```bash
27   git clone https://github.com/kukapay/wallet-inspector-mcp.git
28   cd wallet-inspector-mcp
29   ```
30 
312. **Install Dependencies**:
32 
33   Using `uv` (recommended):
34 
35   ```bash
36   uv async
37   ```
38 
39   Or using `pip`:
40 
41   ```bash
42   pip install mcp[cli] python-dotenv tabulate
43   ```
44 
453. **Installing to Claude Desktop**:
46 
47    Install the server as a Claude Desktop application:
48    ```bash
49    uv run mcp install cli.py --name "Wallet Inspector"
50    ```
51 
52    Configuration file as a reference:
53 
54    ```json
55    {
56       "mcpServers": {
57           "Wallet Inspector": {
58               "command": "uv",
59               "args": [ "--directory", "/path/to/wallet-inspector-mcp", "run", "main.py" ],
60               "env": { "DUNE_SIM_API_KEY": "your_dune_sim_api_key_here"},               
61           }
62       }
63    }
64    ```
65    Replace `/path/to/wallet-inspector-mcp` with your actual installation path, and `your_dune_sim_api_key_here` with your Dune SIM API key.
66 
67## Usage
68 
69### Interacting with the Server
70 
71Use an MCP-compatible client (e.g., Claude Desktop CLI) to query the server. Example natural language queries:
72 
73- **Balance Queries**:
74  - "Check the balance of wallet 0xd8da6bf26964af9d7eed9e03e53415d37aa96045."
75  - "What is the balance for wallet DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK?"
76  - "Get balances for 0x1234567890abcdef1234567890abcdef12345678 on EVM chains."
77 
78- **Activity Queries** (EVM only):
79  - "Show activity for wallet 0xd8da6bf26964af9d7eed9e03e53415d37aa96045."
80  - "Get transaction history for 0x1234567890abcdef1234567890abcdef12345678 on EVM chains."
81 
82- **Transaction Queries**:
83  - "List transactions for wallet 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 with limit 50."
84  - "Show transaction history for wallet DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK."
85  - "Get the latest 10 transactions for 0x1234567890abcdef1234567890abcdef12345678."
86 
87### Example Outputs
88 
89- **Balance Output**:
90 
91  ```
92  Wallet 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 balances:
93 
94  +----------+-----------------+-------------+
95  | Chain    | Token Amount    | USD Value   |
96  +==========+=================+=============+
97  | ethereum | 605.371497 ETH  | $1842034.66 |
98  +----------+-----------------+-------------+
99  | polygon  | 100.500000 MATIC| $50.25      |
100  +----------+-----------------+-------------+
101  | bsc      | 10.000000 BNB   | $600.00     |
102  +----------+-----------------+-------------+
103 
104  Wallet DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK balances:
105 
106  +----------+---------------+-------------+
107  | Chain    | Token Amount  | USD Value   |
108  +==========+===============+=============+
109  | solana   | 1.000000 SOL  | $20.50      |
110  +----------+---------------+-------------+
111  ```
112 
113- **Activity Output** (EVM only):
114 
115  ```
116  Wallet 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 activity:
117 
118  Chain ID: 8453
119  Block Time: 2025-02-20T13:52:29+00:00
120  Tx Hash: 0x184544c8d67a0cbed0a3f04abe5f958b96635e8c743c070f70e24b1c06cd1aa6
121  Type: Receive
122  Asset Type: ERC20
123  Value: 123.069653 ENT
124  USD Value: $0.14
125  ```
126 
127- **Transaction Output**:
128 
129  ```
130  Wallet 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 transactions:
131 
132  Chain: ethereum
133  Block Time: 2023-11-07T05:31:56Z
134  Tx Hash: 0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
135  From: 0xd8da6bf26964af9d7eed9e03e53415d37aa96045
136  To: 0x1234567890abcdef1234567890abcdef12345678
137  Value: 0.000320 ETH
138 
139  Wallet DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK transactions:
140 
141  Chain: solana
142  Block Time: 2023-03-28T09:20:00Z
143  Tx Hash: 5SzSbWKM9yZC7cCGMhUhvnYdWQytrk9NBaWwug1gQBKKwNEBvBKqPSfVeYYnZwUuUyvcCHgYhDkTRrB6YBfwzfv8
144  From: DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK
145  To: 9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin
146  Value: 0.010000 SOL
147  ```
148 
149## Tools
150### `get_wallet_balance`
151 
152- **Description**: Retrieves the balance of a specified wallet address across supported EVM and Solana blockchains.
153- **Parameters**:
154  - `wallet_address` (str): The wallet address to query (e.g., '0x123...' for EVM chains or 'DYw8jCT...' for Solana).
155- **Returns**: An ASCII table with balance details (chain, token amount, USD value) or an error message.
156- **Supported Chains**: Solana,arbitrum,arbitrum,avalanche_c,base,berachain,bnb,ethereum and more.
157 
158### `get_wallet_activity`
159 
160- **Description**: Queries transaction activity for a specified wallet address on supported EVM blockchains.
161- **Parameters**:
162  - `wallet_address` (str): The EVM-compatible wallet address to query (e.g., '0x123...').
163- **Returns**: Formatted text with activity details (chain_id, block_time, tx_hash, type, asset_type, value, value_usd) or an error message.
164- **Supported Chains**: Arbitrum,arbitrum,avalanche_c,base,berachain,bnb,ethereum and more.
165 
166### `get_wallet_transactions`
167 
168- **Description**: Fetches the transaction history of a specified wallet address on supported EVM and Solana blockchains.
169- **Parameters**:
170  - `wallet_address` (str): The wallet address to query (e.g., '0x123...' for EVM chains or 'DYw8jCT...' for Solana).
171  - `limit` (int, optional): Maximum number of transactions to return (default: 100).
172- **Returns**: Formatted text with transaction details (chain, block_time, tx_hash, from, to, value) or an error message.
173- **Supported Chains**: Solana,arbitrum,arbitrum,avalanche_c,base,berachain,bnb,ethereum and more.
174 
175## License
176 
177This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
178