Grok

Connect the OAuth-protected Nansen MCP surface in Grok as a custom connector. No API key.

Connect Nansen to Grok to use 12 curated tools for token and wallet analysis. Sign in with your Nansen account through OAuth. No API key is needed.

What you need

A Nansen account and a Grok account. Tool calls use your Nansen account's API credits and rate limits.

Connect Nansen in Grok

1. Open grok.com/connectors. Grok opens Plugins on the Connectors tab.

2. Click New, then Connector. In the New Connector dialog, choose Custom.

   

   Select Custom in the New Connector dialog
3. Enter Nansen in Name and paste this Server URL:

   https://mcp.nansen.ai/ra/connector-curated/mcp

   

   Enter Nansen and the production MCP server URL
4. Click Add Connector. A sign-in window opens and shows Connect Nansen to Grok, with read-only access (nansen:read).

   

   Connect Nansen to Grok sign-in window
5. Sign in with your Nansen account and click Allow. The window closes. You do not enter a client ID, client secret, or scope: Grok registers itself with Nansen's OAuth sign-in automatically.

6. Back in Grok, open Nansen under Connected. Click See more and confirm all 12 curated tools are enabled.

7. Start a chat, type @Nansen and pick the connector, then try:

   Use Nansen's token_info tool to look up USDC on Ethereum. Show the tool result.

Grok, ChatGPT, and Claude share the same 12 curated tools and credit costs.

Grok Business and Enterprise

For Grok Business and Enterprise, a team admin provisions the connector in the cloud console before members of the organization can connect their Nansen accounts.

1. Sign in at console.x.ai, select your team, and open Grok Business → Connectors.

2. Click + Add Connector, then select Other.

3. Enter https://mcp.nansen.ai/ra/connector-curated/mcp and complete any required authentication.

4. After the admin provisions it, members connect their own Nansen accounts on grok.com/connectors.

Adding and removing connectors requires Team Read-Write permissions, typically granted to team admins. If the custom-connector option is missing, ask a team admin to provision it.

Manage access

The connector uses the Nansen account you selected during sign-in. To sign in again, open the connector and click Reauthenticate. To remove it from Grok, click Disconnect.

Rate limits

See Nansen API rate limits.

Errors and what to do

This surface fails closed. A failed tool call returns a safe failure message that includes a request ID. Give that request ID to support. The message does not expose tokens, API keys, account IDs, or internal details.

What you see	What it means	What to do
Sign-in / authorize prompt again	Missing, expired, or invalid OAuth session	Complete consent again with the same Nansen account
Scope / permission denied	The session lacks nansen:read	Open the connector, click Reauthenticate, and approve access again
Sign-in window shows Something went wrong	Nansen's sign-in rejected the request	Send the Request ID shown on the page to support
Grok stays on "Complete authentication in the popup window"	The sign-in window was closed before it finished	Click Cancel, then add the connector again
Rate limit / try again later	Your Nansen plan's request cap was hit	Wait, then retry. Honor any retry hint Grok shows
Insufficient credits	The signed-in account cannot pay for the tool	Add credits or upgrade at app.nansen.ai
Failed tool call with a request ID	The tool ran and returned a safe error	Copy the request ID and send it to support. Do not send tokens or screenshots of secrets
Missing tools or names that do not match the curated tools	Wrong URL, or the connector did not finish discovery	Confirm the URL is https://mcp.nansen.ai/ra/connector-curated/mcp, then recreate the custom connector
Tools listed but no data	OAuth did not complete, or the account has no remaining credits	Re-run consent, then check usage

If a tool call fails, keep the request ID, start a new chat, and retry. Do not paste API keys or bearer tokens into the chat.

Need more tools?

Grok connects only through OAuth and the curated tools. For the full tool catalog, connect another MCP client to https://mcp.nansen.ai/ra/mcp with a NANSEN-API-KEY header. See Manually connecting to Nansen MCP.