ChatGPT

Install Nansen from the ChatGPT plugin directory. Tool calls spend your Nansen API credits.

Explore tokens, Smart Money activity, and public wallets from inside ChatGPT. No API key, no manual connector setup.

Install

1. Open Nansen in the ChatGPT plugin directory. If that link does not open, search the directory for Nansen.

2. Select Connect, then sign in to Nansen. Choose the account whose API credits you want to use.

Nansen then works in ChatGPT on the web, on mobile, and in the desktop app. To use it, mention @Nansen or select it from the + menu.

Tool calls spend your Nansen API credits — not your ChatGPT subscription — and are subject to rate limits. One prompt can trigger several calls, and some tools cost far more per call than others. Nansen is read-only: it cannot trade or move assets.

Cannot install? See Plan and workspace eligibility.

Plan and workspace eligibility

The plugin directory is visible across ChatGPT plans, but OpenAI does not publish a per-plan list of who can install a given plugin. Per OpenAI's plugin documentation, whether you can install or invoke one depends on your plan, workspace, role, region, and surface.

If the Connect button is greyed out, OpenAI attributes that to geo restrictions, workspace settings, or your plan type.

On managed workspaces:

• Business — plugins and apps are enabled by default; an administrator can change workspace-wide availability.

• Enterprise and Edu — new plugins and apps are disabled by default. An administrator must enable Nansen under Workspace settings → Plugins, and assign eligible roles where role-based controls apply.

Nansen does not require a paid Nansen plan for this connector. A Nansen Free account can connect and use tools while it has enough API credits for each call. Free accounts start with some trial credits; after those are used, a daily top-up brings additional trial credits if it is below certain minimum threshold. Some tool calls cost more than 10 credits, so check credits per call and your available balance before using them.

Your ChatGPT plan and workspace must also allow you to install and invoke the plugin, as described above.

Verify your connection

With Nansen available in the conversation, send:

Use Nansen to get token information for USDC on Ethereum, contract 0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eb48. Show the returned data and report any tool error.

Check that ChatGPT actually calls Nansen and returns token data. A visible plugin entry or a general answer about USDC does not verify account access. This check consumes API credits. Market figures change, so compare the answer with the tool result rather than expecting a fixed price.

Try a research prompt

• "Show Solana tokens with Smart Money inflows over the last 24 hours."

• "Show the current token balances held by Smart Traders and funds on Ethereum."

• "Find Wintermute in Nansen, then show its current token holdings. Tell me which entity or address you used."

• "Look up PEPE on Ethereum and summarize its recent price and token flows."

ChatGPT, Claude, and Grok use the same 12 curated tools. See credits per call. Availability depends on supported chains, markets, and account access. For the full tool catalog, use Manually connecting to Nansen MCP in another MCP client.

Troubleshooting

Problem	What to do
Nansen is missing, or Connect is greyed out	OpenAI attributes a greyed-out Connect button to geo restrictions, workspace settings, or plan type. On a managed workspace, ask your administrator to enable Nansen under Workspace settings → Plugins. See Plan and workspace eligibility.
Sign-in is requested again, or access is denied	Reconnect with the intended Nansen account.
Insufficient credits	Check API credits for the account used during sign-in at Nansen API. The requested operation may cost more than the remaining balance.
Rate limit reached	Wait before retrying and follow any retry guidance in the error. Avoid repeatedly submitting the same prompt.
Tool call fails with a request ID	Save the request ID, prompt, error text, and time of the request, then send them to Nansen support. Do not share credentials.
ChatGPT answers without calling Nansen	Mention @Nansen in the conversation and explicitly ask it to use Nansen.
Tools appear outdated	Reconnect Nansen from the plugin directory and start a new conversation.

To stop using Nansen, remove it from ChatGPT's plugin settings.

Manual setup (developer mode)

You do not need this if you installed Nansen from the directory. Use it only if your plan or workspace cannot install the published plugin, and you have developer mode available.

OpenAI's developer-mode documentation states developer mode is "available to Pro, Plus, Business, Enterprise, and Education accounts on the web." Workspace policy may restrict access.

1. Open Settings → Security and login and turn on Developer mode.

   

   Security and login settings with the Developer mode toggle turned on
2. Open ChatGPT Plugins, select the plus button, and create a connection with these values:

   Field	Value
   Icon (optional)	Upload the Nansen icon PNG
   Name	Nansen
   Description (optional)	Explore onchain data with Nansen. Tool calls consume Nansen API credits.
   MCP server URL	https://mcp.nansen.ai/ra/connector-curated/mcp

3. Click Choose Authentication and select OAuth.

4. Open Advanced OAuth settings. The OAuth Client ID and OAuth Client Secret fields are inside this section. Enter:

   Field	Value
   Registration method	User-Defined OAuth Client
   OAuth Client ID	chatgpt
   OAuth Client Secret	Leave empty
   Token endpoint auth method	none

   

   Advanced OAuth settings with User-Defined OAuth Client, client ID chatgpt, an empty client secret, and token endpoint auth method none
5. Under Default scopes, keep nansen:read checked and leave Base scopes empty. Check the automatically discovered OAuth endpoints against the screenshot below. Leave Registration URL empty.

   Field	Value
   Auth URL	https://idp.nansen.ai/authorize
   Token URL	https://idp.nansen.ai/token
   Authorization server base	https://idp.nansen.ai
   Resource	https://mcp.nansen.ai

   

   Default scope nansen:read selected, Base scopes empty, and Nansen OAuth endpoints
6. Scroll down to OpenID support and uncheck OIDC enabled, as shown below.

   

   OpenID support with OIDC enabled unchecked
7. Review the custom MCP server notice, check I understand and want to continue, then click Create. Sign in to Nansen and approve the requested access.

8. Review the discovered tools, then open a new conversation and mention @Nansen.

Use the server URL above for ChatGPT. The /ra/mcp endpoint in Manually connecting to Nansen MCP is for API-key clients.

If sign-in fails with an invalid client or redirect URI, confirm the Client ID is chatgpt. Nansen must register the exact callback URL used by ChatGPT; contact Nansen support with the callback URL shown in the connection settings. Do not send an authorization code or token.