Nansen
io.github.nansen-ai/nansen-mcp · v1.0.1 · MCP 2025-11-25
Blockchain analytics API for AI agents. Smart Money signals, wallet profiling, token analytics.
Reachability
reachable
checked 2026-07-14 04:11 UTC
Registry status active
Tools pinned 37
495312a21139
Tools last changed
unchanged since first capture 2026-07-14
Provenance
Registry namespace io.github.nansen-ai
(GitHub-account verified by the official registry)
Remote endpoints
https://mcp.nansen.ai/ra/mcp/ (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-07-14 04:11 | first capture | 37 tools pinned |
Pinned tool definitions (37)
| Tool | Description |
|---|---|
| smart_traders_and_funds_token_balances | Get aggregated (not per wallet) smart trader and fund (EXCLUDES whales, large holders, influencers, etc.) token balances and 24h change per chain for all chains (default is ['all'], which queries all supported chains) or specific... |
| smart_traders_and_funds_perp_trades | Get recent Hyperliquid perpetual futures trades from Smart Traders and Funds across all tokens. This tool provides granular smart trader and funds activity. For a big picture view of smart traders and funds activity across all tokens,... |
| token_current_top_holders | Get upto 25 (per page) top holders information for a specific token. **Note:** Using `labelType: smart_money` is not a good proxy for an overall market view. Use it only if user explicitly requests it, or to combine it with other non... |
| token_dex_trades | Get DEX trades for a specific token. **Modes:** - `onchain_tokens` (default): Analyze on-chain tokens by contract address - `perps`: Analyze Hyperliquid perpetual futures by symbol (chain auto-set to "hyperliquid") **NOTE:** In... |
| token_transfers | Get 25 token transfers (per page) for a specific token based on the sort order. Default is most recent transfers first. **NOTE:** This tool does not support native tokens (so11111111111111111111111111111111111111112,... |
| token_flows | Get hourly aggregated token flows for a specific segment of holders over a date range. The segments are Top 100 holders, Whale, Public Figure, Smart Money and Exchange. **Note:** Using `holder_segment: smart_money` is not a good proxy... |
| token_pnl_leaderboard | Upto 25 results (per page) of trader PnL for a token. Use the sorting and filtering options to narrow down the results. **Modes:** - `onchain_tokens` (default): Analyze on-chain tokens by contract address - `perps`: Analyze Hyperliquid... |
| token_who_bought_sold | Get TOTAL amount of tokens bought/sold by address for a token on DEX (Decentralised Exchanges) ONLY. Use this tool to find out WHO is buying or selling a token (on DEX) AND then you can check if they are liquidating profits or... |
| token_recent_flows_summary | Get **TOTAL** token flows per segment: 1. Public Figures 2. Top PnL Traders 3. Whales 4. Smart Traders 5. Exchanges 6. Fresh Wallets Inflow and outflow of tokens between the segments is CRITICAL in identifying... |
| token_discovery_screener | Get comprehensive token screening data across multiple blockchain networks with advanced filtering. A maximum of 25 results are returned out of 1000s of tokens. Use the sorting and filtering options to narrow down the results. A... |
| token_ohlcv | Get OHLCV (Open, High, Low, Close, Volume) price data for a token with automatic interval resolution. Supports EVM chains and Solana for on-chain tokens, AND Hyperliquid perpetual futures. For Hyperliquid perps, pass... |
| token_info | Get token information — spot on-chain details or Hyperliquid perpetual futures stats. On-chain tokens mode (default): Returns token details (name, symbol, market cap, FDV, supply, deployment date, socials) and spot trading metrics... |
| token_quant_scores | Get Nansen Score Indicators for a token - quantitative risk and reward signals. Use this tool when assessing a token's risk/reward profile, evaluating buy/sell decisions, or when the user needs quantitative data to make trading... |
| nansen_score_top_tokens | Discover and filter a daily list of attractive tokens using Nansen Score Indicators weighted by coefficients (= Performance Score). Use this tool when you don't know which tokens to buy and need recommendations based on backtested... |
| hyperliquid_leaderboard | Get Hyperliquid perpetual futures trader leaderboard with performance metrics. Returns: Trader performance rankings as markdown. Columns returned: - **Address**: Trader's wallet address - **Label**: Nansen label of the... |
| address_historical_balances | Get historical native coin & token balances of address. |
| address_related_addresses | Get information about related addresses of an input address. Note: This only includes the the "special" connections 'First Funder', 'Signer', 'Previous Signer', 'Multisig Signer of', 'Previous Multisig Signer of', 'Deployed via',... |
| address_counterparties | Get 25 (per page) addresses or entities with the most common interactions with input addresses Default sort is net value transferred between them. Also returns the top 3 tokens transferred by count for each counterparty Note: To get... |
| address_transactions | Get list of 20 MOST RECENT transactions made by an address (per page). Only the latest transactions according to the date range are returned. |
| address_dex_trades | Get a wallet's individual DEX trades (token swaps) on a single chain — the bought/sold token pair, amounts, and USD value per trade, newest first. Wallet-centric companion to `token_dex_trades` (which is token-centric). Chain: one per... |
| wallet_pnl_for_token | Get PnL stats for a specific token traded by the input address during a specific date range. Use this tool for analysing the performance of the wallet for the specific token over a time period. |
| wallet_pnl_summary | Get aggregate stats of overall realized PnL for the input address. Note, this tool DOES NOT include unrealized PnL. For unrealized PnL you need to check change in token prices of the current holdings. Use this tool for analysing the... |
| address_portfolio | Get comprehensive portfolio overview for a wallet address or entity. Hyperliquid perpetual positions include liquidation prices to support risk analysis workflows. For wallet addresses, supports different modes: - 'fast-mode-default':... |
| general_search | General search tool. This is your FIRST entry point to look up for possible tokens, entities, and addresses related to a query. Do NOT use this tool for prediction markets. For Polymarket names, topics, event slugs, or URLs, use... |
| growth_chain_rank | Get chain growth rankings by active addresses, transactions, gas fees and DEX volume. |
| transaction_lookup | Get comprehensive transaction details including token transfers. |
| prediction_market_lookup | Search Polymarket for events and markets by name, topic, URL, or slug. **PM building blocks:** - An **event** is a grouped prediction topic containing many child markets. - A **market** is one tradable outcome with its own... |
| prediction_market_screener | Browse and sort Polymarket markets, events, or categories. **When to use:** - Broad discovery, screening, and ranked browsing across many markets. - Do NOT use this to resolve one named market/event/slug/URL — use ... |
| prediction_market_ohlcv | Historical odds/volume candles for a Polymarket market. **When to use:** - Current odds / implied probability, price history, and recent probability changes on a specific market. **Key fields:** - `Close` is the share price for the... |
| prediction_market_orderbook | Live orderbook for a Polymarket market. **When to use:** - Bid/ask depth, liquidity, and yes-share / no-share order structure. **Key fields:** - `Order Size` is share quantity, not USD. Do not describe share size as dollar depth... |
| prediction_market_top_holders | Largest current holders for a Polymarket market. **Key fields:** - Positions are share balances, not USD notional. - `Position Value USD` is current marked value, not payout at resolution. - `Side Held` is the share side currently... |
| prediction_market_trades | Recent trades for a Polymarket market. **When to use:** - Source of truth for recent fills and latest trade-tape pricing. - Do not overwrite recent trade prices with older OHLCV candles. **Key fields:** - `Share Size` is quantity;... |
| prediction_market_pnl_leaderboard | PnL leaderboard for a Polymarket market. **When to use:** - Only for profitability claims. **Key fields:** - `Side Held` reflects current side exposure where the API provides it. **Pitfalls:** - If PnL fields are blank, say... |
| prediction_market_position_detail | Detailed position breakdown for a Polymarket market. **Key fields:** - `Position Size (Shares)` is quantity held in this market. - `Position Value USD` is current marked value, not final payout at resolution. - `Cost Basis USD` and... |
| prediction_market_address_trades | Prediction market trade history for a Polygon wallet. **Key fields:** - `Share Size` is quantity traded in the displayed outcome side. - `Value USD` applies to that row only, not the whole transaction. **Pitfalls:** - Use this for... |
| prediction_market_address_summary | Prediction market summary metrics for a Polygon wallet. **When to use:** - First wallet-level Polymarket tool for a quick trader overview. - Use before detailed address trades/PnL when the user asks for a general wallet profile,... |
| prediction_market_address_pnl | Prediction market PnL breakdown for a Polygon wallet. **Key fields:** - Market-by-market PnL when the API provides it. - Blank PnL fields mean unavailable data, not zero. - `Position Size (Shares)` is quantity; `Position Value USD` is... |
Status badge
[](https://toolpin.dev/servers/io.github.nansen-ai/nansen-mcp)
Maintain this server? Add the badge to your README — it links your users to this live status page.