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
claude mcp add --transport http nansen-mcp https://nansen-mcp--nansen-ai.run.toolsWhat 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.toolsPlatform CLI: remote server
codex mcp add nansen-mcp --url https://nansen-mcp--nansen-ai.run.toolsConfig file
{
"mcpServers": {
"nansen-mcp": {
"url": "https://nansen-mcp--nansen-ai.run.tools"
}
}
}Config file
{
"servers": {
"nansen-mcp": {
"type": "http",
"url": "https://nansen-mcp--nansen-ai.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http nansen-mcp https://nansen-mcp--nansen-ai.run.toolsStep 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.