Tools supported by Nansen MCP

Tools supported by Nansen MCP

Explore the suite of tools available through Nansen MCP. Each tool is purpose-built to deliver actionable blockchain insights — from tracking smart money movements to analyzing token flows and wallet activities.

Total tools: 24

Protocol: JSON-RPC 2.0 over Streamable HTTP (SSE) Endpoint: https://mcp.nansen.ai/ra/mcp Auth: NANSEN-API-KEY header Required header: Accept: application/json, text/event-stream

Quick Reference

Tool	Description	Credits
smart_traders_and_funds_token_balances	Smart money holdings & 24h changes	5
smart_traders_and_funds_perp_trades	Smart money perpetual trades (HyperLiquid)	5
token_current_top_holders	Top token holders with labels	5
token_dex_trades	DEX trading activity for a token	1
token_transfers	Token transfer history	1
token_flows	Hourly aggregated token flows by segment	1
token_pnl_leaderboard	Trader PnL rankings for a token	5
token_who_bought_sold	Total bought/sold by address (DEX)	1
token_recent_flows_summary	Flow summary by segment (Smart Money, Whales, etc.)	1
token_discovery_screener	Multi-chain token screening with filters	1
token_ohlcv	OHLCV price data with auto interval	1
token_quant_scores	Quantitative scores for a token	2
nansen_score_top_tokens	Top tokens ranked by Nansen score	1
address_historical_balances	Historical token & native coin balances	1
address_related_addresses	First funders, signers, deployed contracts	1
address_counterparties	Most interacted addresses/entities	5
address_transactions	Recent transactions for an address	1
wallet_pnl_for_token	PnL for a specific token by wallet	1
wallet_pnl_summary	Overall realized PnL for a wallet	1
address_portfolio	Full portfolio overview & DeFi positions	1
general_search	Search tokens, entities, addresses (free)	0
growth_chain_rank	Chain growth rankings by key metrics	1
hyperliquid_leaderboard	Top HyperLiquid traders leaderboard	9
transaction_lookup	Transaction details with transfers (EVM)	1

Common Gotchas

1. Most tools wrap arguments in {"request": {...}} but general_search and transaction_lookup take flat args

2. Date ranges use object format: {"from": "YYYY-MM-DD", "to": "YYYY-MM-DD"}

3. Wallet tools use addresses: ["0x..."] (plural array), not address: "0x..." — except wallet_pnl_for_token, wallet_pnl_summary (singular address), and address_portfolio (wallet_address)

4. Enum values are case-sensitive: "BUY" / "SELL" — not lowercase

5. HyperLiquid dates accept relative strings: "7D_AGO", "30D_AGO", "NOW"