# 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}?


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.solscan.io/api-access/solscan-mcp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.