Nansen
MCP server by Nansen
Query Nansen onchain analytics: labeled wallets, Smart Money activity, token flows, wallet PnL and Hyperliquid perps.
Connect to Nansen
Nansen needs an API key. Connect with its own URL and your key:
Send your key in the NANSEN-API-KEY header. mcp.tc never sees or stores keys. Where to get a key
Share this server
Opens this page, with the URL and setup steps.
mcp.tc/i/nansenAbout
Nansen MCP gives an assistant read access to Nansen onchain data. It covers labeled wallets, Smart Money trades and netflows, token screening, holders, OHLCV and technical indicators, wallet PnL, portfolios and Hyperliquid perpetuals across many chains.
It runs as a hosted Streamable HTTP endpoint at https://mcp.nansen.ai/ra/mcp. Access needs a Nansen API key sent in the NANSEN-API-KEY header. A separate curated connector endpoint exists for sign-in with a Nansen account.
What you can do
- Track Smart Money DEX trades, perp trades and netflows
- Screen and discover trending tokens with filters
- Look up wallet labels, counterparties and first funder
- Analyze wallet PnL and portfolio holdings
- Get token OHLCV, technical indicators and quant scores
- Check Hyperliquid leaderboard and wallet positions
- Search tokens, entities and addresses
Tools 54
get_feedback_preferencesRead-onlyRead the account's saved automatic feedback preference.
submit_feedbackWritesSubmit product feedback for the authenticated Nansen account.
get_feedbackRead-onlyRead a feedback receipt by feedback ID.
smart_traders_and_funds_token_balancesRead-onlyAggregated Smart Money token balances and 24h change per chain.
smart_traders_and_funds_perp_tradesRead-onlyRecent Hyperliquid perp trades by Smart Money addresses.
smart_traders_and_funds_netflowRead-onlySmart Money net USD flow per token over several windows.
smart_traders_and_funds_dex_tradesRead-onlyIndividual DEX trades made by Smart Money wallets.
smart_traders_and_funds_dcasRead-onlyJupiter DCA orders opened by Smart Money on Solana.
smart_traders_and_funds_historical_token_balancesRead-onlyDay-by-day history of aggregated Smart Money balances.
smart_traders_and_funds_pnl_leaderboardRead-onlyRank Smart Money addresses by realized and unrealized PnL.
fund_token_balancesRead-onlyCurrent token holdings aggregated across Fund-labelled wallets.
token_current_top_holdersRead-onlyTop holders for a specific token.
Show 42 more tools
token_dex_tradesRead-onlyDEX trades for a specific token.
token_transfersRead-onlyToken transfers for a specific token, sortable.
token_flowsRead-onlyHourly token-flow history for one holder segment.
token_pnl_leaderboardRead-onlyTrader PnL for a token with sorting and filters.
token_who_bought_soldRead-onlyNet buyers or sellers of a token on DEXs.
token_recent_flows_summaryRead-onlyOn-chain flow snapshot across all wallet categories.
token_discovery_screenerRead-onlyScreen tokens across chains with advanced filters.
token_ohlcvRead-onlyOHLCV price data for a token.
token_technical_indicatorsRead-onlyTechnical-analysis snapshot: SMA, EMA, RSI, MACD, Bollinger, ATR.
token_infoRead-onlyToken details or Hyperliquid perp stats.
token_quant_scoresRead-onlyNansen Score risk and reward indicators for a token.
nansen_score_top_tokensRead-onlyDaily list of tokens ranked by Nansen Score.
hyperliquid_leaderboardRead-onlyHyperliquid perp trader leaderboard with performance metrics.
token_jup_dcaRead-onlyJupiter DCA orders opened against a Solana token.
address_historical_balancesRead-onlyHistorical native and token balances of an address.
address_labelsRead-onlyStandard identity, behavioural and protocol labels for a wallet.
address_related_addressesRead-onlyRelated addresses such as first funder and signers.
address_counterpartiesRead-onlyAddresses or entities with the most interactions with an address.
address_counterparties_batchRead-onlyTop counterparties for up to 10 wallets in one call.
address_transactionsRead-onlyMost recent transactions of an address or entity.
address_dex_tradesRead-onlyA wallet's DEX swaps or Hyperliquid trades on one chain.
address_perp_positionsRead-onlyA wallet's Hyperliquid positions and liquidation risk.
wallet_pnl_for_tokenRead-onlyPnL stats for a wallet on a specific token and date range.
wallet_pnl_summaryRead-onlyAggregate realized PnL for an address.
address_first_funderRead-onlyFirst address that funded an EVM wallet.
address_portfolioRead-onlyPortfolio overview for a wallet or entity.
general_searchRead-onlySearch tokens, entities and addresses by query.
entity_name_searchRead-onlyFind exact entity names from a partial name.
token_sectorsRead-onlyListing token sectors
growth_chain_rankRead-onlyChecking blockchain rankings
transaction_lookupRead-onlyLooking up transaction details
prediction_market_lookupRead-onlyLooking up prediction market
prediction_market_screenerRead-onlyScreening prediction markets
prediction_market_ohlcvRead-onlyLoading prediction market prices
prediction_market_orderbookRead-onlyChecking prediction market orderbook
prediction_market_top_holdersRead-onlyFinding prediction market top holders
prediction_market_tradesRead-onlyChecking prediction market trades
prediction_market_pnl_leaderboardRead-onlyChecking prediction market PnL leaders
prediction_market_position_detailRead-onlyLoading prediction market position
prediction_market_address_tradesRead-onlyChecking prediction market address trades
prediction_market_address_summaryRead-onlySummarizing prediction market address
prediction_market_address_pnlRead-onlyChecking prediction market address PnL
Read from the live server on 22 Nov 2026. Read-only, Writes and Can delete are hints the server declares; your client decides whether to ask before running a tool.
Example prompts
Show Solana tokens with Smart Money inflows over the last 24 hours.
Find Wintermute in Nansen and show its current token holdings.
Look up PEPE on Ethereum and summarize its recent price and token flows.
Show the PnL summary for this wallet address on Ethereum.
Set up
Every client connects to mcp.nansen.ai. Pick yours; the page remembers your choice.
Claude Code
- Run this in a terminal, in your project folder:
claude mcp add --transport http nansen https://mcp.nansen.ai/ra/mcp --header "NANSEN-API-KEY: <YOUR_API_KEY>"- Replace the placeholder with your key before you run it, then check it with
/mcpinside Claude Code.
Add --scope user to make it available in every project, not just this one.
Claude Desktop
- Use the
mcp-remotebridge, which keeps the key on this computer (a connector added on claude.ai with the key under Request headers also shows up here). Open Settings → Developer → Edit Config and add:
{
"mcpServers": {
"nansen": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.nansen.ai/ra/mcp",
"--header",
"NANSEN-API-KEY: <YOUR_API_KEY>"
]
}
}
}- Replace the placeholder with your key and restart Claude Desktop.
The bridge needs Node.js on your computer.
claude.ai
- Open the connector form on claude.ai. This button fills in the name and URL for you:
Add to claude.ai (opens in a new tab)
- Check that the URL reads
https://mcp.nansen.ai/ra/mcp. Under Request headers, addNANSEN-API-KEY: <YOUR_API_KEY>with your key from Nansen, then click Add. - Turn it on in a chat from the tools menu.
Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under Organization settings → Connectors.
Cursor
Add to Cursor (opens in a new tab)
Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):
{
"mcpServers": {
"nansen": {
"url": "https://mcp.nansen.ai/ra/mcp",
"headers": {
"NANSEN-API-KEY": "<YOUR_API_KEY>"
}
}
}
}VS Code
Add it to .vscode/mcp.json. VS Code asks for the key the first time and stores it securely:
{
"servers": {
"nansen": {
"type": "http",
"url": "https://mcp.nansen.ai/ra/mcp",
"headers": {
"NANSEN-API-KEY": "${input:nansen-api-key}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "nansen-api-key",
"description": "NANSEN-API-KEY",
"password": true
}
]
}Devin Desktop
- Add it to
~/.config/devin/mcp_config.json(macOS and Linux) or%APPDATA%\devin\mcp_config.json(Windows):
{
"mcpServers": {
"nansen": {
"serverUrl": "https://mcp.nansen.ai/ra/mcp",
"headers": {
"NANSEN-API-KEY": "<YOUR_API_KEY>"
}
}
}
}- Refresh the MCP server list in Cascade.
Devin Desktop is the new name for Windsurf. It reads serverUrl (or url) for remote servers.
Codex
codex mcp add nansen --url https://mcp.nansen.ai/ra/mcpcodex mcp add can’t set the NANSEN-API-KEY header, so this step is required: put this entry in ~/.codex/config.toml instead of running the command, or add its env_http_headers line to the entry the command made:
[mcp_servers.nansen]
url = "https://mcp.nansen.ai/ra/mcp"
env_http_headers = { "NANSEN-API-KEY" = "NANSEN_API_KEY" }Codex reads the header values from the environment variables named in env_http_headers.
Gemini CLI
gemini mcp add --transport http --header "NANSEN-API-KEY: <YOUR_API_KEY>" nansen https://mcp.nansen.ai/ra/mcpThis adds it to the current project. Add -s user to use it everywhere.
Any client
Most clients accept this shape. Some name the URL field differently: serverUrl in Devin Desktop, httpUrl in Gemini CLI’s settings file.
{
"mcpServers": {
"nansen": {
"type": "http",
"url": "https://mcp.nansen.ai/ra/mcp",
"headers": {
"NANSEN-API-KEY": "<YOUR_API_KEY>"
}
}
}
}Zed puts servers under context_servers in its settings. Cline needs "type": "streamableHttp", or it assumes SSE.
Client only starts local servers? Bridge it with npx -y mcp-remote https://mcp.nansen.ai/ra/mcp.
Embed
Show Nansen in a README or on your site. Each embed links to this page, uses the server’s own URL, and sets no cookies. How embeds work
The card, the iframe and the JSON are in English. Add ?lang=it, fr, de or es to their address for another language.
README badge
[](https://mcp.tc/i/nansen)<a href="https://mcp.tc/i/nansen"><img src="https://mcp.tc/i/nansen/badge.svg" alt="Nansen on mcp.tc" height="20"></a>It follows the reader’s light or dark mode. Add ?theme=light or ?theme=dark to fix it, or ?style=compact to show the mark without the word.
Website card
<script src="https://mcp.tc/w/nansen.js" async></script>The card appears where the tag is. Add data-theme="dark" or data-size="compact" to the tag to change it. The file holds everything it needs, so it makes no other requests and sets no cookies.
iframe
<iframe src="https://mcp.tc/embed/nansen" title="Nansen on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>Use it on pages that don’t allow scripts. Add ?theme=light or ?theme=dark to the address to fix the colors.
JSON
The listing as data for your own pages and tools: name, tagline, the server’s own URL, tools and the “Add to” links. Any site can read it (CORS is open).
https://mcp.tc/i/nansen.jsonAI prompt
Paste this into an AI coding assistant, such as Claude Code or Cursor, and it adds the Nansen card to your site.
Add the mcp.tc card for Nansen, an MCP server, to my website. It is one static script: no build step, no package to install, no cookies.
Put this tag where the card should appear. The card renders right before it:
```html
<script src="https://mcp.tc/w/nansen.js" async></script>
```
To show the card somewhere else, put this placeholder there and load the same script once, for example before `</body>`. Keep the link inside: visitors without JavaScript see it.
```html
<div data-mcptc="nansen"><a href="https://mcp.tc/i/nansen">Nansen on mcp.tc</a></div>
```
Options:
- `data-theme="light"` or `"dark"` on the tag or the placeholder fixes the colors. Without it, the card follows the visitor’s light or dark mode.
- `data-size="compact"` gives a smaller card without the tagline.
- The CSS variable `--mcptc-max-width` on the placeholder or a parent sets the width (default `520px`).
- `?lang=` on the script URL sets the card’s language: `en`, `it`, `fr`, `de` or `es`.
If the site has a Content Security Policy, allow `script-src https://mcp.tc` and `img-src data:` (the icon is inline).
For a README or other Markdown docs, use the badge instead:
```markdown
[](https://mcp.tc/i/nansen)
```
Reference: https://mcp.tc/embedChange history
We read this server’s tool list every 3 hours and record what changes. Last read 22 Nov 2026, 11:58 UTC.
-
Server instructions changed.
New server instructions
Details, 22 Nov 2026, 02:57 UTC
Server instructions
BeforeSupported chains are
scroll, hyperevm, solana,sui,sei, ronin, unichain, bitcoin, linea,fantom, monad,hyperliquid, all, polygon,injective,bnb, ethereum, near, base,sonic,mantle, zksync, ton, iotaevm, avalanche, arbitrum,evm,robinhood, mantra,arc,optimism, plasma, tronAfterSupported chains are arbitrum, plasma, tron, bnb, ton, polygon, ethereum, all, mantle, avalanche, base, linea, sui, hyperliquid, near, fantom, zksync, monad, mantra, injective, ronin, hyperevm, robinhood, sonic, evm, scroll, sei, optimism, bitcoin, arc, solana, iotaevm, unichain
-
Server instructions changed.
New server instructions
Details, 21 Nov 2026, 23:59 UTC
Server instructions
BeforeSupported chains are injective,
arbitrum, iotaevm, evm, unichain, mantle,bnb,arc,ethereum,fantom, hyperevm, polygon, tron, linea, sui,sonic, zksync,monad, optimism, sei, scroll, hyperliquid,avalanche,base, ronin, near, all,robinhood,ton,plasma,solana, mantra, bitcoinAfterSupported chains are scroll, hyperevm, solana, sui, sei, ronin, unichain, bitcoin, linea, fantom, monad, hyperliquid, all, polygon, injective, bnb, ethereum, near, base, sonic, mantle, zksync, ton, iotaevm, avalanche, arbitrum, evm, robinhood, mantra, arc, optimism, plasma, tron
-
Server instructions changed.
New server instructions
Details, 21 Nov 2026, 21:00 UTC
Server instructions
BeforeSupported chains are arc,
linea,polygon,mantle, near,tron, monad,evm,scroll,robinhood, base, bnb, iotaevm, sonic, zksync,hyperliquid,unichain, plasma, mantra, sui, hyperevm, bitcoin, all,avalanche,fantom, injective,ronin,optimism, sei, ethereum, arbitrum,ton,solanaAfterSupported chains are injective, arbitrum, iotaevm, evm, unichain, mantle, bnb, arc, ethereum, fantom, hyperevm, polygon, tron, linea, sui, sonic, zksync, monad, optimism, sei, scroll, hyperliquid, avalanche, base, ronin, near, all, robinhood, ton, plasma, solana, mantra, bitcoin
-
Server instructions changed.
New server instructions
Details, 21 Nov 2026, 02:52 UTC
Server instructions
BeforeSupported chains are base, bnb,
ethereum, arc, optimism,avalanche, fantom,ton, scroll, all, mantle, zksync, hyperevm, plasma, sonic, robinhood, monad,sei,solana, polygon, unichain, near, hyperliquid, evm, linea,arbitrum,tron, mantra, ronin, iotaevm, injective, sui, bitcoinAfterSupported chains are arc, linea, polygon, mantle, near, tron, monad, evm, scroll, robinhood, base, bnb, iotaevm, sonic, zksync, hyperliquid, unichain, plasma, mantra, sui, hyperevm, bitcoin, all, avalanche, fantom, injective, ronin, optimism, sei, ethereum, arbitrum, ton, solana
-
Server instructions changed.
New server instructions
Details, 20 Nov 2026, 23:55 UTC
Server instructions
BeforeSupported chains are base, mantle,
bitcoin,sonic,evm, mantra,monad, sei,near, ton, injective, all, arc, zksync,solana, polygon,hyperevm,hyperliquid,ethereum, robinhood, optimism,tron,avalanche, scroll, fantom, arbitrum, sui, bnb, unichain,ronin,linea,iotaevm,plasmaAfterSupported chains are base, bnb, ethereum, arc, optimism, avalanche, fantom, ton, scroll, all, mantle, zksync, hyperevm, plasma, sonic, robinhood, monad, sei, solana, polygon, unichain, near, hyperliquid, evm, linea, arbitrum, tron, mantra, ronin, iotaevm, injective, sui, bitcoin
-
Server instructions changed.
New server instructions
Details, 20 Nov 2026, 18:00 UTC
Server instructions
BeforeSupported chains are
all,mantle,avalanche, bnb, sei, optimism, linea,mantra,bitcoin, sui, hyperliquid, base, robinhood,monad,unichain, arbitrum,near, solana,ton,polygon,fantom, arc,ethereum,evm,scroll,injective,ronin,tron,iotaevm,plasma, zksync, sonic, hyperevmAfterSupported chains are base, mantle, bitcoin, sonic, evm, mantra, monad, sei, near, ton, injective, all, arc, zksync, solana, polygon, hyperevm, hyperliquid, ethereum, robinhood, optimism, tron, avalanche, scroll, fantom, arbitrum, sui, bnb, unichain, ronin, linea, iotaevm, plasma
-
Server instructions changed.
New server instructions
Details, 20 Nov 2026, 02:52 UTC
Server instructions
BeforeSupported chains are hyperliquid,
sui,scroll,sei, robinhood,ronin,hyperevm, fantom,tron,evm, base, bitcoin,zksync,iotaevm, ton, solana,sonic,plasma, avalanche, unichain, near, injective, mantra, linea, ethereum, arbitrum, optimism, mantle, arc, polygon, bnb, monad, allAfterSupported chains are all, mantle, avalanche, bnb, sei, optimism, linea, mantra, bitcoin, sui, hyperliquid, base, robinhood, monad, unichain, arbitrum, near, solana, ton, polygon, fantom, arc, ethereum, evm, scroll, injective, ronin, tron, iotaevm, plasma, zksync, sonic, hyperevm
-
Server instructions changed.
New server instructions
Details, 19 Nov 2026, 23:53 UTC
Server instructions
BeforeSupported chains are sei,
bnb, sui, ethereum, mantra,tron, iotaevm, unichain, injective,ton, near, hyperevm, evm, scroll,linea,fantom, sonic, plasma, hyperliquid,arc,solana, robinhood, arbitrum, zksync,polygon,base, avalanche, mantle, bitcoin, all,monad,optimism, roninAfterSupported chains are hyperliquid, sui, scroll, sei, robinhood, ronin, hyperevm, fantom, tron, evm, base, bitcoin, zksync, iotaevm, ton, solana, sonic, plasma, avalanche, unichain, near, injective, mantra, linea, ethereum, arbitrum, optimism, mantle, arc, polygon, bnb, monad, all
-
Server instructions changed.
New server instructions
Details, 19 Nov 2026, 17:53 UTC
Server instructions
BeforeSupported chains are
arc, optimism,ethereum,linea,near,iotaevm, robinhood, all, bitcoin,scroll, fantom,base, ronin, sei,hyperliquid,plasma, tron, mantra,solana,ton,mantle,injective, sonic,monad,zksync, unichain, avalanche, evm, hyperevm, bnb, polygon, arbitrum, suiAfterSupported chains are sei, bnb, sui, ethereum, mantra, tron, iotaevm, unichain, injective, ton, near, hyperevm, evm, scroll, linea, fantom, sonic, plasma, hyperliquid, arc, solana, robinhood, arbitrum, zksync, polygon, base, avalanche, mantle, bitcoin, all, monad, optimism, ronin
-
Tracking started: 54 tools.
FAQ
Can I paste mcp.tc/i/nansen into my MCP client?
No. mcp.tc links are pages, not server addresses. Connect with https://mcp.nansen.ai/ra/mcp, so your client talks to Nansen directly. Your key goes there too, never to mcp.tc. The quick link is for sharing: it opens this page, with setup steps for every client.
Does Nansen need an API key or a sign-in?
Yes. Nansen needs an API key, sent as the NANSEN-API-KEY header. Get one from Nansen and keep it in your client’s config, never in a shared file.
Is Nansen a remote or a local server?
Remote. Nansen hosts it at https://mcp.nansen.ai/ra/mcp, and it speaks Streamable HTTP. There’s nothing to install.
What can Nansen do?
It has 54 tools, including get_feedback_preferences, submit_feedback and get_feedback. You can track Smart Money DEX trades, perp trades and netflows, screen and discover trending tokens with filters and look up wallet labels, counterparties and first funder.
Which clients can use it?
Any client that supports remote MCP servers and can send your key: Claude Code, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed and others. On claude.ai and Claude Desktop, add the key as a request header when you create the custom connector. ChatGPT can’t send a key, so it can’t use it.
Does mcp.tc track changes to Nansen?
Yes. Nansen’s History tab shows each change we find to its tools, down to descriptions and parameters, plus new versions and edits by its owner. Follow the listing to get an email when it changes.
Who wrote this page?
mcp.tc’s robot read Nansen’s own metadata (its MCP handshake, tool list and public pages), and an AI model drafted the text from it. A person reviews anything the checks can’t confirm. The text can still be wrong, so if you spot a mistake, use Report this listing on this page.
mcp.tc isn’t affiliated with Nansen. This page was built from Nansen’s public metadata, last checked on 22 Nov 2026, and an AI model wrote the description, so it can be wrong. Names and marks belong to their owners. Something off? Report this listing.