Wallet Inspector MCP

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.