We and selected third parties use cookies or similar technologies for technical purposes and, with your consent, to analyze how the site is used.

You can freely give, refuse or withdraw your consent at any time.

Nansen

MCP server by Nansen

Query Nansen onchain analytics: labeled wallets, Smart Money activity, token flows, wallet PnL and Hyperliquid perps.

Needs an API key (Needs an API key from the vendor)Streamable HTTP

Connect to Nansen

Nansen needs an API key. Connect with its own URL and your key:

https://mcp.nansen.ai/ra/mcp

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/nansen

About

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-only

    Read the account's saved automatic feedback preference.

  • submit_feedbackWrites

    Submit product feedback for the authenticated Nansen account.

  • get_feedbackRead-only

    Read a feedback receipt by feedback ID.

  • smart_traders_and_funds_token_balancesRead-only

    Aggregated Smart Money token balances and 24h change per chain.

  • smart_traders_and_funds_perp_tradesRead-only

    Recent Hyperliquid perp trades by Smart Money addresses.

  • smart_traders_and_funds_netflowRead-only

    Smart Money net USD flow per token over several windows.

  • smart_traders_and_funds_dex_tradesRead-only

    Individual DEX trades made by Smart Money wallets.

  • smart_traders_and_funds_dcasRead-only

    Jupiter DCA orders opened by Smart Money on Solana.

  • smart_traders_and_funds_historical_token_balancesRead-only

    Day-by-day history of aggregated Smart Money balances.

  • smart_traders_and_funds_pnl_leaderboardRead-only

    Rank Smart Money addresses by realized and unrealized PnL.

  • fund_token_balancesRead-only

    Current token holdings aggregated across Fund-labelled wallets.

  • token_current_top_holdersRead-only

    Top holders for a specific token.

Show 42 more tools
  • token_dex_tradesRead-only

    DEX trades for a specific token.

  • token_transfersRead-only

    Token transfers for a specific token, sortable.

  • token_flowsRead-only

    Hourly token-flow history for one holder segment.

  • token_pnl_leaderboardRead-only

    Trader PnL for a token with sorting and filters.

  • token_who_bought_soldRead-only

    Net buyers or sellers of a token on DEXs.

  • token_recent_flows_summaryRead-only

    On-chain flow snapshot across all wallet categories.

  • token_discovery_screenerRead-only

    Screen tokens across chains with advanced filters.

  • token_ohlcvRead-only

    OHLCV price data for a token.

  • token_technical_indicatorsRead-only

    Technical-analysis snapshot: SMA, EMA, RSI, MACD, Bollinger, ATR.

  • token_infoRead-only

    Token details or Hyperliquid perp stats.

  • token_quant_scoresRead-only

    Nansen Score risk and reward indicators for a token.

  • nansen_score_top_tokensRead-only

    Daily list of tokens ranked by Nansen Score.

  • hyperliquid_leaderboardRead-only

    Hyperliquid perp trader leaderboard with performance metrics.

  • token_jup_dcaRead-only

    Jupiter DCA orders opened against a Solana token.

  • address_historical_balancesRead-only

    Historical native and token balances of an address.

  • address_labelsRead-only

    Standard identity, behavioural and protocol labels for a wallet.

  • address_related_addressesRead-only

    Related addresses such as first funder and signers.

  • address_counterpartiesRead-only

    Addresses or entities with the most interactions with an address.

  • address_counterparties_batchRead-only

    Top counterparties for up to 10 wallets in one call.

  • address_transactionsRead-only

    Most recent transactions of an address or entity.

  • address_dex_tradesRead-only

    A wallet's DEX swaps or Hyperliquid trades on one chain.

  • address_perp_positionsRead-only

    A wallet's Hyperliquid positions and liquidation risk.

  • wallet_pnl_for_tokenRead-only

    PnL stats for a wallet on a specific token and date range.

  • wallet_pnl_summaryRead-only

    Aggregate realized PnL for an address.

  • address_first_funderRead-only

    First address that funded an EVM wallet.

  • address_portfolioRead-only

    Portfolio overview for a wallet or entity.

  • general_searchRead-only

    Search tokens, entities and addresses by query.

  • entity_name_searchRead-only

    Find exact entity names from a partial name.

  • token_sectorsRead-only

    Listing token sectors

  • growth_chain_rankRead-only

    Checking blockchain rankings

  • transaction_lookupRead-only

    Looking up transaction details

  • prediction_market_lookupRead-only

    Looking up prediction market

  • prediction_market_screenerRead-only

    Screening prediction markets

  • prediction_market_ohlcvRead-only

    Loading prediction market prices

  • prediction_market_orderbookRead-only

    Checking prediction market orderbook

  • prediction_market_top_holdersRead-only

    Finding prediction market top holders

  • prediction_market_tradesRead-only

    Checking prediction market trades

  • prediction_market_pnl_leaderboardRead-only

    Checking prediction market PnL leaders

  • prediction_market_position_detailRead-only

    Loading prediction market position

  • prediction_market_address_tradesRead-only

    Checking prediction market address trades

  • prediction_market_address_summaryRead-only

    Summarizing prediction market address

  • prediction_market_address_pnlRead-only

    Checking 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

  1. 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>"
  1. Replace the placeholder with your key before you run it, then check it with /mcp inside Claude Code.

Add --scope user to make it available in every project, not just this one.

Claude Desktop

  1. Use the mcp-remote bridge, 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:
claude_desktop_config.json
{
  "mcpServers": {
    "nansen": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.nansen.ai/ra/mcp",
        "--header",
        "NANSEN-API-KEY: <YOUR_API_KEY>"
      ]
    }
  }
}
  1. Replace the placeholder with your key and restart Claude Desktop.

The bridge needs Node.js on your computer.

claude.ai

  1. Open the connector form on claude.ai. This button fills in the name and URL for you:
  1. Check that the URL reads https://mcp.nansen.ai/ra/mcp. Under Request headers, add NANSEN-API-KEY: <YOUR_API_KEY> with your key from Nansen, then click Add.
  2. 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

Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):

mcp.json
{
  "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:

.vscode/mcp.json
{
  "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

  1. Add it to ~/.config/devin/mcp_config.json (macOS and Linux) or %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "mcpServers": {
    "nansen": {
      "serverUrl": "https://mcp.nansen.ai/ra/mcp",
      "headers": {
        "NANSEN-API-KEY": "<YOUR_API_KEY>"
      }
    }
  }
}
  1. 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/mcp

codex 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:

config.toml
[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/mcp

This 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

Badge preview, lightBadge preview, dark
Markdown
[![Nansen on mcp.tc](https://mcp.tc/i/nansen/badge.svg)](https://mcp.tc/i/nansen)
HTML
<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

HTML
<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

HTML
<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.json

What each field means

AI prompt

Paste this into an AI coding assistant, such as Claude Code or Cursor, and it adds the Nansen card to your site.

Markdown
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
[![Nansen on mcp.tc](https://mcp.tc/i/nansen/badge.svg)](https://mcp.tc/i/nansen)
```

Reference: https://mcp.tc/embed

Change history

We read this server’s tool list every 3 hours and record what changes. Last read 22 Nov 2026, 11:58 UTC.

Follow Nansen and we’ll email you when something changes.

  1. , Automatic check

    Server instructions changed.

    New server instructions

    Details, 22 Nov 2026, 02:57 UTC

    Server instructions

    Before

    Supported 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

    After

    Supported 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

  2. , Automatic check

    Server instructions changed.

    New server instructions

    Details, 21 Nov 2026, 23:59 UTC

    Server instructions

    Before

    Supported 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

    After

    Supported 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

  3. , Automatic check

    Server instructions changed.

    New server instructions

    Details, 21 Nov 2026, 21:00 UTC

    Server instructions

    Before

    Supported 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

    After

    Supported 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

  4. , Automatic check

    Server instructions changed.

    New server instructions

    Details, 21 Nov 2026, 02:52 UTC

    Server instructions

    Before

    Supported 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

    After

    Supported 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

  5. , Automatic check

    Server instructions changed.

    New server instructions

    Details, 20 Nov 2026, 23:55 UTC

    Server instructions

    Before

    Supported 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

    After

    Supported 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

  6. , Automatic check

    Server instructions changed.

    New server instructions

    Details, 20 Nov 2026, 18:00 UTC

    Server instructions

    Before

    Supported 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

    After

    Supported 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

  7. , Automatic check

    Server instructions changed.

    New server instructions

    Details, 20 Nov 2026, 02:52 UTC

    Server instructions

    Before

    Supported 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

    After

    Supported 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

  8. , Automatic check

    Server instructions changed.

    New server instructions

    Details, 19 Nov 2026, 23:53 UTC

    Server instructions

    Before

    Supported 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

    After

    Supported 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

  9. , Automatic check

    Server instructions changed.

    New server instructions

    Details, 19 Nov 2026, 17:53 UTC

    Server instructions

    Before

    Supported 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, sui

    After

    Supported 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

  10. , Automatic check

    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.