# Solscan MCP

The Solscan MCP server provides a standardized interface for AI models (like Claude or ChatGPT) to interact with the Solana blockchain. It leverages the Solscan Pro API to provide high-fidelity, indexed data that is ready for LLM consumption without the need for manual transaction decoding.

### Introduction

Solscan MCP allows your AI agents to "speak" Solana. Instead of dealing with raw RPC calls, the protocol provides semantic tools to fetch human-readable account details, token metrics, and DeFi activities.

#### Key Features

* **Balance & Portfolio Tracking:** Access real-time SOL and SPL token balances.
* **DeFi Intelligence:** Track swaps, liquidity movements, and yield farming activities.
* **Decoded Transactions:** View transaction actions (swaps, transfers, mints) in a human-readable format.
* **Global Market Data:** Retrieve token prices, trending lists, and holder distributions.

***

### What You Can Access

The following tools are available within the Solscan MCP, categorized by their data focus:

#### Solscan Pro API Endpoints in Categories

| **Category**           | **Description**                                                                   | **Tools (Functions)**                                                                                    |
| ---------------------- | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Account Data**       | Fetch comprehensive details and activity logs for specific Solana addresses.      | `get_account_detail`, `get_account_transactions`, `get_account_token_accounts`, `get_account_stake_info` |
| **Token Information**  | Retrieve metadata, supply, and holder distributions for SPL tokens.               | `get_token_meta`, `get_token_holders`, `get_token_list`, `get_token_price_latest`                        |
| **Trading Data**       | Track DEX trades, market volume, and historical performance across the ecosystem. | `get_market_info`, `get_dex_trades`, `get_token_defi_activities`, `get_market_volume`                    |
| **Account Metadata**   | Access identity-related data, labels, and leaderboard rankings.                   | `get_account_metadata`, `get_account_leaderboard`, `get_personal_labels`                                 |
| **Blockchain Data**    | Explore block-level details, program lists, and epoch information.                | `get_block_last`, `get_block_detail`, `get_program_list`, `get_block_transactions`                       |
| **Transaction Decode** | Convert complex program instructions into readable actions.                       | `get_transaction_actions`, `get_account_data_decoded`, `get_tx_actions_multi`                            |

***

### Getting Started

#### Prerequisites

* A **Solscan Pro API Key** (v2.0). You can subscribe to Solscan Pro API service at <https://solscan.io/apis>

#### Installation

1. We host a Streamable HTTP MCP server at

   `https://mcp.solscan.io/mcp`
2. **Configure Environment:** Create a `.env` file in the root directory:

   `SOLSCAN_API_KEY=your_pro_api_key_here`

#### Example questions to ask with Solcan MCP

* What is the current price of SOL?
* Who is the largest holder of USDC on Solana?
* Check total portfolio value of this wallet {address}?
* Extract all swap activity of JUP via Jupiter platform in the last 2 days
* Who funded this wallet {address}?