Skip to main content
MCP server CX Codex

Nansen-MCP — Claude Code MCP server: blockchain analysis and crypto intelligence

MCP server that grants agents access to Nansen's onchain data: smart trader balances, DEX trades, token flows, wallet PnL, and asset screening. Useful if you need live crypto market intelligence right in your IDE.

no license 1,658 installs updated 2026-03-13

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http nansen-mcp https://nansen-mcp--nansen-ai.run.tools
Open on GitHub

What Nansen-MCP does

Nansen-MCP bridges your IDE to institutional blockchain analytics. The agent taps into 24 tools: smart trader balances per chain, address histories, DEX activity, PnL leaderboards, and portfolio breakdowns. Data splits by market segment—smart traders, whales, public figures, exchanges—so you can compare behavior across different players.

The server includes token screening via Nansen Score (risk-reward signals), Hyperliquid perpetuals analysis, detailed address tracking, and counterparty detection. Requests route through https://nansen-mcp--nansen-ai.run.tools and cover all major EVM chains plus Solana. One caveat: token_ohlcv only works on EVM and Solana; Hyperliquid perps data flows through a separate endpoint.

Setup varies by IDE: Claude Code uses claude mcp add with the URL; Cursor and GitHub Copilot expect JSON config with the server address; Codex and Gemini CLI have their own add commands. You'll need internet access and a Nansen API key.

What it helps with

  • identify which smart traders are accumulating or dumping a token
  • find top holders and traders with best PnL on an asset
  • track historical balance and transaction data for any address
  • compare token inflows and outflows across market segments
  • evaluate risk-reward on emerging tokens using quantitative signals

Example prompts for the agent

  • Show me smart trader balances in DOGE and their 24-hour changes across all chains
  • Find the top 5 tokens by Nansen Score with the strongest upside potential
  • Analyze how much USDC hit exchanges in the last 6 hours

How to install Nansen-MCP

Platform CLI: remote server

claude mcp add --transport http nansen-mcp https://nansen-mcp--nansen-ai.run.tools

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Nansen-MCP

How do I install Nansen-MCP in Claude Code?

Run claude mcp add --transport http nansen-mcp https://nansen-mcp--nansen-ai.run.tools in your terminal. The server connects to Claude Code and your agent gains access to all Nansen tools.

What does Nansen-MCP provide?

It exposes 24 tools for blockchain analysis: smart trader balances, DEX trades, address histories, portfolio PnL, token flow tracking across market segments, and asset recommendations powered by Nansen Score.

Which blockchains are supported?

All major EVM chains and Solana. Hyperliquid is supported for perpetuals analysis. If a chain isn't available for a query, the server returns an error—check support in your request.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open