# kukapay/wallet-inspector-mcp [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/kukapay/wallet-inspector-mcp  
**GitHub Stars:** 9  
**npm Downloads (last month):** 6013  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/kukapay-wallet-inspector-mcp

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

## Tools
Capabilities this server exposes over MCP:

- **get_wallet_balance** — - **Description**: Retrieves the balance of a specified wallet address across supported EVM and Solana blockchains.
- **get_wallet_activity** — - **Description**: Queries transaction activity for a specified wallet address on supported EVM blockchains.
- **get_wallet_transactions** — - **Description**: Fetches the transaction history of a specified wallet address on supported EVM and Solana blockchains.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "wallet-inspector-mcp": {
    "command": "uvx",
    "args": ["mcp"],
    "env": {
      "DUNE_SIM_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `DUNE_SIM_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What kukapay/wallet-inspector-mcp MCP server does

kukapay/wallet-inspector-mcp MCP server exposes wallet data through the Model Context Protocol. It accepts a wallet address and queries supported blockchain networks for balances, activity, or transaction history. The documented coverage includes Solana, Ethereum, Polygon, BNB Smart Chain, Base, Arbitrum, and additional supported networks.

The server is intended for inspection rather than transaction execution. It does not expose a tool for sending assets, signing transactions, or changing wallet state. Queries use public wallet addresses, including EVM-style `0x` addresses and Solana addresses.

## How it works

The server connects to Dune SIM using the `DUNE_SIM_API_KEY` environment variable. An MCP-compatible client invokes one of the available tools with the target wallet address. Results are returned as formatted text rather than as a generalized database schema.

`get_wallet_balance` checks balances across supported EVM and Solana chains. Its output includes the chain, token amount, and USD value, presented as an ASCII table.

`get_wallet_activity` retrieves activity for EVM-compatible addresses. Each returned activity record can include the chain ID, block time, transaction hash, transaction type, asset type, token value, and USD value. This tool is documented as EVM-only, so it is not the appropriate choice for Solana activity queries.

`get_wallet_transactions` returns transaction history for EVM and Solana addresses. The optional `limit` parameter controls the maximum number of records and defaults to 100. Transaction results can include the chain, timestamp, hash, sender, recipient, and value.

## Setup and configuration

Running kukapay/wallet-inspector-mcp MCP server requires Python 3.10 or newer, a Dune SIM API key, and either `uv` or `pip` for dependency installation. The documented setup flow clones the GitHub repository, enters its directory, and installs the required dependencies.

The README lists `uv` as the recommended dependency manager and also provides a pip command that installs the MCP CLI, environment-variable support, and table-formatting dependencies. The server configuration passes `DUNE_SIM_API_KEY` through the MCP client's environment settings.

For Claude Desktop, the documented configuration runs `uv` with the repository directory and starts `main.py`. The setup instructions also show the MCP installation command using `cli.py` and the display name “Wallet Inspector.” A real local repository path and a valid Dune SIM key must replace the placeholders in the example configuration.

## Tools and capabilities

- Query balances on supported EVM and Solana chains.
- Display balance amounts and USD values in ASCII tables.
- Retrieve EVM wallet activity with asset and transaction details.
- Fetch EVM or Solana transaction history.
- Limit transaction-history results with an optional numeric parameter.
- Return an error message when a query cannot be completed.

## Limitations and notes

kukapay/wallet-inspector-mcp MCP server requires an external Dune SIM API key, so it is not a credential-free local data source. The exact network list may extend beyond the chains named in the README, which includes Ethereum, Polygon, BSC, Base, Arbitrum, Solana, Avalanche, and Berachain examples.

Wallet activity is restricted to supported EVM blockchains, while balances and transaction history support both EVM and Solana. The supplied material describes inspection features only; it does not document write operations, authentication beyond the Dune key, rate limits, or historical-data guarantees.

_Full upstream README: https://allmcps.com/mcp/kukapay-wallet-inspector-mcp/readme_