# io.github.nansen-ai/nansen-mcp

Blockchain analytics API for AI agents. Smart Money signals, wallet profiling, token analytics.

- **Type:** MCP server
- **Trust:** 60/100 (B), scored on the content rubric
- **Verification:** community-indexed — nobody has claimed this listing
- **Version:** 1.0.1
- **Author:** io.github.nansen-ai
- **License:** Unknown
- **Endpoints:** streamable-http https://mcp.nansen.ai/ra/mcp/
- **Source:** https://mcp.nansen.ai/ra/mcp/
- **Endpoint health:** reachable (last checked 2026-09-28T15:23:25.088Z, 6 samples) — uptime is not a security property and is not part of the trust score
- **Compatible clients:** claude-code, cursor, copilot, chatgpt, gemini (basis: transport)

## Trust

60/100 (B), scored on the content rubric
- Publisher verified: no
- Install scripts: nothing suspicious found
- Prompt-injection scan: clean
- Obfuscation scan: clean
- Evidence age: 32 days

## Security scan

- **Status:** clean
- **Scanned:** 2026-09-02T05:05:48.100Z
- **Version scanned:** live
- **CVEs:** no coverage — this entry has no package coordinates to query OSV against, so "no known CVEs" is NOT asserted for it.

## Tools

38 declared. Observed from a live `tools/list` probe.
- `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
- `smart_traders_and_funds_perp_trades` — Get recent Hyperliquid perpetual futures trades from Smart Money addresses across all tokens. Optional labels narrow this cohort; they do not search all address
- `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. Us
- `token_dex_trades` — Get DEX trades for a specific token. **Modes:** - `onchain_tokens` (default): Analyze on-chain tokens by contract address - `perps`: Analyze Hyperliquid perpetu
- `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 nat
- `token_flows` — Get hourly token-flow history for ONE holder segment over a date range. Use `token_recent_flows_summary` instead for an on-chain snapshot across ALL wallet cate
- `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):
- `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 
- `token_recent_flows_summary` — Get an on-chain flow snapshot across **ALL** wallet categories in one call. This tool supports native ETH on Ethereum and native SOL on Solana, and is the corre
- `token_discovery_screener` — Get comprehensive token screening data across multiple blockchain networks with advanced filtering. A maximum of 25 results per page are returned out of 1000s o
- `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 Hy
- `token_technical_indicators` — Get a technical-analysis snapshot for a token: SMA(20/50/200), EMA(12/26), RSI(14), MACD(12,26,9), Bollinger Bands(20, 2σ), ATR(14), and rolling VWAP(20), compu
- `token_info` — Get token information — spot on-chain details or Hyperliquid perpetual futures stats. On-chain tokens mode (default): Returns token details (name, symbol, marke
- `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 
- `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
- `hyperliquid_leaderboard` — Get Hyperliquid perpetual futures trader leaderboard with performance metrics. Returns: Trader performance rankings as markdown. Columns returned: - **Address**
- `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',
- `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 
- `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 trades on a single chain — DEX swaps (spot) or Hyperliquid perpetual trades, newest first. Wallet-centric companion to `token_dex_trad
- `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 s
- `wallet_pnl_summary` — Get aggregate stats of overall realized PnL for the input address. For Hyperliquid perp traders (chain='hyperliquid'), includes realized PnL from fills plus a c
- `address_portfolio` — Get comprehensive portfolio overview for a wallet address or entity. Hyperliquid perpetual positions include liquidation prices to support risk analysis workflo
- `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 predict
- `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 chil
- `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 
- `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 
- `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
- `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 valu
- `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
- `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 th
- `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 curre
- `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 
- `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
- `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,

## Install

**Verdict: review** — Installable, but 2 things to check first: No CVE coverage: this entry has no npm/PyPI coordinates to query OSV against, so "no known vulnerabilities" is not a claim that can be made about it.
**Cautions** (coverage gaps and advisories — never blocking)
- No CVE coverage: this entry has no npm/PyPI coordinates to query OSV against, so "no known vulnerabilities" is not a claim that can be made about it.
- No publisher has proved control of this listing; it is indexed, not vouched for.
**Config** (claude-code):
```json
"{\n  \"mcpServers\": {\n    \"nansen-mcp\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.nansen.ai/ra/mcp/\"\n    }\n  }\n}"
```

## Blast radius

Contained to moderate — no credential declaration found, from the publisher, the upstream registry, or the README. Known so far: runs on someone else's infrastructure; read-only tool surface.
- Floor 9, ceiling 27 (tier: unknown)
- `unknown` means the floor and ceiling land in different bands — not measured enough to name one. It does not mean low.
- This is impact, not likelihood. A high radius is not a defect: a filesystem server is supposed to write files. It is never part of the trust score.

## Machine-readable views of this entry

- Signed JSON: https://forgeregistry.com/api/v1/packages/io.github.nansen-ai%2Fnansen-mcp
- Install plan: https://forgeregistry.com/api/v1/packages/io.github.nansen-ai%2Fnansen-mcp/install-plan
- Alternatives: https://forgeregistry.com/api/v1/alternatives/io.github.nansen-ai%2Fnansen-mcp
- HTML page: https://forgeregistry.com/registry/io.github.nansen-ai%2Fnansen-mcp
- MCP: POST https://forgeregistry.com/api/mcp → `forge_get_package` / `forge_install_plan`

## About this document

Generated by Forge (https://forgeregistry.com) — a compact rendering of the same record served, signed, at the JSON URL above. Trust and scan facts are the registry's own measurements; anything Forge did not measure is named as unmeasured rather than omitted.