> For the complete documentation index, see [llms.txt](https://docs.nansen.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nansen.ai/mcp/connectors/claude.md).
# Claude
Connect Nansen to Claude with your Nansen account. Sign in through OAuth, no API key. Data calls use Nansen API credits; feedback calls are free.
Explore tokens, Smart Money activity, and public wallets from inside Claude. Sign in with your Nansen account; no API key to create or paste.
### Install
1. [Open Nansen in the Claude connector directory](https://claude.ai/directory/nansen) and select it. You can also open [Customize → Connectors](https://claude.ai/customize/connectors) and search for Nansen.
2. Select **Connect**, then sign in to Nansen. Choose the account whose API credits you want to use. Claude identifies itself to Nansen automatically; there is no client ID or secret to enter.
Nansen then works in Claude on the web, in the desktop app, and on mobile. In a conversation, open the **+** menu, choose **Connectors**, and make sure **Nansen** is turned on.
{% hint style="info" %}
Data-tool calls spend your [Nansen API credits](/getting-started/credits.md), not your Claude subscription, and are subject to [rate limits](/getting-started/rate-limits.md). One prompt can trigger several calls, and some tools cost far more per call than others. Data tools read data. Feedback submission saves a report, and all three feedback tools cost zero credits. Nansen cannot trade or move assets.
{% endhint %}
### Plan and workspace eligibility
Connectors are available on Claude Free, Pro, Max, Team, and Enterprise. On Team and Enterprise plans an organization Owner may need to enable Nansen in [Organization settings → Connectors](https://claude.ai/admin-settings/connectors) before members can connect. Nansen itself imposes no Claude plan requirement; it requires a Nansen account, with sufficient API credits for paid data calls. Feedback calls are free.
### Claude Code
Claude Code signs in through the same Nansen account and needs no API key in its configuration.
{% code overflow="wrap" %}
```bash
claude mcp add --transport http nansen https://mcp.nansen.ai/ra/connector-curated/mcp
```
{% endcode %}
Then run `/mcp` inside Claude Code, select **nansen**, and choose **Authenticate**. Your browser opens the Nansen sign-in page. Approve access and return to the terminal; Claude Code stores the session and refreshes it for you.
This signs in with your Nansen account and uses the curated tools. For the [full tool catalog](/mcp/connecting/tools.md), use the API-key command on [Manually connecting to Nansen MCP](/mcp/connecting.md#2-claude-code-terminal-integration) instead, or alongside it under a different server name.
If you previously added Nansen with an API key, remove that entry first:
```bash
claude mcp remove nansen
```
### Claude in Slack (Claude Tag)
Follow the [Claude Tag OAuth setup](/mcp/connectors/claude-tag.md) to connect Nansen in Slack. For shared channels, connect a dedicated Nansen account and limit the access bundle to the intended channels. Requests through the bundle consume that account's Nansen API credits.
### Verify your connection
With Nansen turned on, send:
> Use Nansen to get token information for USDC on Ethereum, contract 0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eb48. Show the returned data and report any tool error.
Check that Claude actually calls Nansen and returns token data. A visible tool list 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.
### Verify feedback tools
In **Customize → Connectors → Nansen**, check for **Nansen feedback preferences**, **Nansen feedback receipt**, and **Submit Nansen feedback**. The first two read data; submission is a write tool. Organization restrictions and individual tool permissions both apply.
Ask Claude to call `get_feedback_preferences` with an empty `request` and inspect the expanded tool response. This costs zero credits. For a report you approve, use **Allow once** when Claude asks. If approval stalls, preserve the original submission ID and report, reload the conversation, and inspect the pending call or result before retrying. Do not enable persistent approval to bypass a stalled prompt. **Deny** should stop the call without a retry. See [feedback and recovery](/mcp/connectors.md#product-feedback).
### 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."
Claude, ChatGPT, and Grok connect to the same server offering [curated tools](/mcp/connectors.md#curated-tools). See [credits per call](/mcp/connectors.md#credits-per-call). Tool availability also depends on each client's published catalog and permissions. Data coverage depends on supported chains, markets, and account access. If you need the [full tool catalog](/mcp/connecting/tools.md), connect with an API key as described in [Manually connecting to Nansen MCP](/mcp/connecting.md).
### Troubleshooting
| Problem | What to do |
| ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nansen is missing from the connector list | On Team and Enterprise, ask an Owner to enable Nansen in Organization settings → Connectors. If it is still unavailable, use the [manual setup](#manual-setup-custom-connector). |
| 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](https://app.nansen.ai/api?tab=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. |
| Claude answers without calling Nansen | Turn Nansen on in the conversation's tools menu and explicitly ask it to use Nansen. |
| Claude Code says the server needs authentication | Run `/mcp`, select **nansen**, and choose **Authenticate** again. |
To stop using Nansen, open [Customize → Connectors → Yours](https://claude.ai/customize/connectors/yours), select **Nansen**, and disconnect or remove it. In Claude Code, run `/mcp`, select **nansen**, and choose **Clear authentication**.
Manual setup (custom connector)
You do not need this once Nansen is installed from the directory. Use it if your organization cannot install directory connectors, or to test against the server directly.
1. In Claude, open [Customize → Connectors](https://claude.ai/customize/connectors), select **Add**, then **Add custom connector**. On Team or Enterprise, an Owner does this under [Organization settings → Connectors](https://claude.ai/admin-settings/connectors).
2. Enter these values, then select **Continue**. Leave the OAuth client fields on the next screen empty; Claude identifies itself to Nansen automatically.
| Field | Value |
| -------------- | ------------------------------------------------ |
| Name | `Nansen` |
| MCP server URL | `https://mcp.nansen.ai/ra/connector-curated/mcp` |
3. Select **Add**, then **Connect**. Sign in to Nansen on the consent page and select **Allow**. The page shows access to data and product feedback and where you will be sent back to (claude.ai).
4. Nansen now shows as connected. Inspect **Tool permissions** for the current catalog, including read tools and feedback submission. Keep the approval settings you want for each tool.
Use the server URL above for Claude. The `/ra/mcp` endpoint in [Manually connecting to Nansen MCP](/mcp/connecting.md) is for API-key clients.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.nansen.ai/mcp/connectors/claude.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.