# Nansen-MCP

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1658 installs
- Author: nansen-ai
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/nansen-ai/Nansen-MCP
- Updated: 2026-03-13
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/nansen-mcp

## What it 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.

## Requirements
- Remote server: `https://nansen-mcp--nansen-ai.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http nansen-mcp https://nansen-mcp--nansen-ai.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add nansen-mcp --url https://nansen-mcp--nansen-ai.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "nansen-mcp": {
            "url": "https://nansen-mcp--nansen-ai.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "nansen-mcp": {
            "type": "http",
            "url": "https://nansen-mcp--nansen-ai.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http nansen-mcp https://nansen-mcp--nansen-ai.run.tools
```

## When to use it
- 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
- 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

## Similar
- [nansen-trading](https://affpapa.org/en/nevibecode/skills/nansen-trading.md) — skill · 441 installs
- [nansen-wallet-deep-dive](https://affpapa.org/en/nevibecode/skills/nansen-wallet-deep-dive.md) — skill · 393 installs
- [TONNode — TON blockchain access](https://affpapa.org/en/nevibecode/mcp/tonnode-ton-blockchain-access.md) — MCP server · ★ 17 repo stars
- [dexpaprika-api](https://affpapa.org/en/nevibecode/skills/dexpaprika-api.md) — skill · ★ 36 repo stars
- [emblem-market-research](https://affpapa.org/en/nevibecode/skills/emblem-market-research.md) — skill · 8900 installs
- [Wallet Analytics](https://affpapa.org/en/nevibecode/mcp/wallet-analytics.md) — MCP server · 126 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
