# TokenOS Wallet Inspector

> TokenOS Wallet Inspector is an MCP server for finance and payments. Read-only MCP server to inspect Solana wallets, tokens and transactions for AI clients. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API, Web
- **Website:** https://tokenos.ai/mcp/wallet-inspector
- **MCP Registry name:** ai.tokenos/wallet-inspector
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [crypto and web3](https://ai-powered.com/categories/crypto-and-web3)
- **Listing updated:** 2026-11-18

## About

The README-style listing describes a remote MCP server that lets an AI assistant look up Solana wallet addresses, SPL and Token-2022 holdings, token mints and transaction signatures. Pasting an address returns its SOL balance, token positions with USD values and recent activity. For a token mint, the server reports supply, price, market cap, mint and freeze authority status, metadata mutability and top-20 holder concentration, along with a heuristic rug-risk score.

The server runs over streamable HTTP using JSON-RPC 2.0, is stateless, and requires no authentication or wallet connection, since every tool is read-only. Solana reads go through TokenOS's own RPC, while prices come from Jupiter with a CoinGecko fallback. Risk outputs are presented as heuristics rather than financial, legal or security advice.

It suits people analysing Solana addresses or tokens from inside an AI chat client, and it is also offered for ChatGPT at a separate endpoint.

## Features

- **Wallet holdings lookup:** Shows a wallet's SOL balance, token holdings with USD values and its ten most recent transactions.
- **Token safety snapshot:** Reports supply, price, market cap, mint and freeze authority status and top-holder concentration for a mint.
- **Heuristic rug-risk score:** Gives a rule-based risk reading for a token, framed as a heuristic rather than advice.
- **Transaction decoding:** Explains a transaction signature with status, fee, invoked programs, balance changes and log lines.
- **Read-only and unauthenticated:** Tools are annotated read-only and need no wallet connection, signing or login.

## Good for

- Check what tokens a Solana wallet currently holds
- Assess whether a new token shows rug-pull warning signs before trading
- See who the largest holders of a token are and how concentrated supply is
- Understand what a specific Solana transaction did in plain language

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http wallet-inspector https://tokenos.ai/api/mcp/apps/wallet-inspector
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://tokenos.ai/api/mcp/apps/wallet-inspector
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "wallet-inspector": {
      "url": "https://tokenos.ai/api/mcp/apps/wallet-inspector"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "wallet-inspector": {
      "type": "http",
      "url": "https://tokenos.ai/api/mcp/apps/wallet-inspector"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "wallet-inspector": {
      "serverUrl": "https://tokenos.ai/api/mcp/apps/wallet-inspector"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "wallet-inspector": {
      "type": "http",
      "url": "https://tokenos.ai/api/mcp/apps/wallet-inspector"
    }
  }
}
```

## Tools

- `inspect_wallet`: Return SOL balance, all token holdings with USD values, total tracked value and the 10 most recent transactions for a Solana wallet address.
- `check_token`: Return supply, price, market cap, mint/freeze authority status, metadata mutability, top-20 holders with concentration, and a heuristic rug-risk score for a token mint.
- `explain_transaction`: Decode a transaction signature: status, fee, programs invoked, SOL and token balance changes, and the last log lines.

## FAQ

### Does the server need authentication or a wallet connection?

The listing states it is stateless with no authentication and that it is read-only, so there is nothing to connect or sign.

### What does the rug-risk check return?

It returns a heuristic risk score and read for a token mint, which the listing says should not be treated as financial advice.

### Which blockchain does it cover?

The tools are for Solana addresses, token mints and transaction signatures.

### How do I add TokenOS Wallet Inspector to Claude Code?

Run this command in your terminal: claude mcp add --transport http wallet-inspector https://tokenos.ai/api/mcp/apps/wallet-inspector

### What are the best alternatives to TokenOS Wallet Inspector?

The closest alternatives to TokenOS Wallet Inspector are Solana Rpc, Solana Rent & Rug Shield MCP Gateway, SolGuard Solana Token-2022 Scanner & Safe-Swap Router, Solrisk MCP and Haris Guardian - Solana Token Risk Check.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Solana Rpc](https://ai-powered.com/mcp/solana-rpc): Solana Rpc is a freemium MCP server for crypto and web3.
- [Solana Rent & Rug Shield MCP Gateway](https://ai-powered.com/mcp/solana-rent-and-rug-shield-mcp-gateway-2): Solana Rent & Rug Shield MCP Gateway is a freemium MCP server for security.
- [SolGuard Solana Token-2022 Scanner & Safe-Swap Router](https://ai-powered.com/mcp/solguard-solana-token-2022-scanner-and-safe-swap-router): SolGuard Solana Token-2022 Scanner & Safe-Swap Router is an MCP server for crypto and web3.
- [Solrisk MCP](https://ai-powered.com/mcp/solrisk-mcp): Solrisk MCP is an open-source MCP server for crypto and web3.
- [Haris Guardian - Solana Token Risk Check](https://ai-powered.com/mcp/haris-guardian-solana-token-risk-check): Haris Guardian - Solana Token Risk Check is a freemium MCP server for security.
- [RugRadar](https://ai-powered.com/mcp/rugradar-2): RugRadar is a freemium MCP server for crypto and web3.
- [NullClear Arbiter](https://ai-powered.com/mcp/nullclear-arbiter-2): NullClear Arbiter is a freemium MCP server for crypto and web3.
- [MemePump Token Safety](https://ai-powered.com/mcp/memepump-token-safety): MemePump Token Safety is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/tokenos-wallet-inspector
