Solscan MCP

The Solscan MCP server provides a standardized interface for AI models (like Claude or Codex) to connect AI agents with live and decoded Solana on-chain data.

Get started

First, get a Solscan API key from the Solscan API page if you do not have one. Solscan offers two types of key, and both work with the MCP server:

• Free API key — no cost, with a lower rate limit and access to core endpoints. Good for trying the MCP server and light usage.

• Paid (Pro) API key — higher rate limits and access to the full v2.0 endpoint set, including advanced DeFi, market, and metadata tools.

Which tools return data depends on your plan. If a tool call fails with a plan or rate-limit error, that tool likely requires a paid tier — or you have hit your quota. See Rate limits & pricing.

Once you have a key, pick your client below and follow it end to end.

The server is a hosted Streamable HTTP endpoint:

https://mcp.solscan.io/mcp

Authenticate by passing your API key as a bearer token — the same value works whether it is a free or paid key

Claude Desktop

Claude Desktop is Anthropic's desktop chat app.

Step 1 — Add Solscan to your config

In Claude Desktop, open Settings > Developer > Edit Config to open the claude_desktop_config.json file.

In the file that opens, add the solscan server (replace YourApiKey with your key):

{
  "mcpServers": {
    "solscan": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.solscan.io/mcp",
        "--header",
        "Authorization:${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "Bearer YourApiKey"
      }
    }
  }
}

Requires Node.js.

Step 2 — Confirm it's connected

Save, then fully quit Claude Desktop and reopen it. Open Settings > Developer and look for solscan under Local MCP servers with a running badge.

Step 3 — Ask your first question

Ask in plain language and approve the tool calls when prompted:

What is the current price of SOL?

In this example, the agent calls get_token_price_latest and answers with the current price. This tool works on any paid Pro API plan.

Claude Code

Claude Code is Anthropic's coding assistant that runs in your terminal.

Step 1 — Add the server

Run this in your terminal, replacing YourApiKey with your key:

claude mcp add --transport http solscan \
  https://mcp.solscan.io/mcp \
  --header "Authorization: Bearer YourApiKey"

Step 2 — Confirm it's connected

Check the server's status and look for Status: ✔ Connected:

claude mcp get solscan

Step 3 — Ask your first question

Start a Claude Code session by running claude, then ask in plain language and let the agent pick the tools:

Extract all swap activity of JUP via Jupiter platform in the last 2 days

The agent calls get_token_defi_activities, filters by platform and time range, and summarizes the swaps.

Codex Desktop

Codex Desktop is the ChatGPT desktop app running OpenAI's Codex agent, which can connect to MCP servers.

Step 1 — Add the server

In Codex Desktop, open Settings > Plugins > Add > Add MCP Server. Enter the following server details (replace YourApiKey with your key):

• Name: Solscan MCP

• Type: Streamable HTTP

• URL: https://mcp.solscan.io/mcp

• Headers: Key=AUTHORIZATION, Value=Bearer YourApiKey

Step 2 — Confirm it's connected

Save, then fully quit Codex Desktop and reopen it. Run /mcp and confirm that solscan is listed as an enabled server.

Step 3 — Ask your first question

Ask in plain language:

text

Who is the largest holder of USDC on Solana? use Solscan mcp

The agent calls get_token_holders and returns the ranked holder list.

Codex CLI

Codex CLI is OpenAI's coding agent in your terminal.

Step 1 — Set your API key as an environment variable

Run this in your terminal (replace YourApiKey with your key):

export SOLSCAN_API_KEY=YourApiKey

Step 2 — Add the server

codex mcp add solscan \
  --url https://mcp.solscan.io/mcp \
  --bearer-token-env-var SOLSCAN_API_KEY

Step 3 — Confirm it's connected

Check the server and look for enabled: true:

codex mcp get solscan

Step 4 — Ask your first question

Start a Codex session by running codex, then ask in plain language:

Who funded this wallet D27DgiipBR5dRdij2L6NQ27xwyiLK5Q2DsEM5ML5EuLK use Solscan mcp

The agent calls get_account_metadata / funding tools and traces the first funding source.

---

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.

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

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 D27DgiipBR5dRdij2L6NQ27xwyiLK5Q2DsEM5ML5EuLK?

Extract all swap activity of JUP via Jupiter platform in the last 2 days

Who funded this wallet D27DgiipBR5dRdij2L6NQ27xwyiLK5Q2DsEM5ML5EuLK?