# Remote MCP (Recommended)

## Quick Start

Remote MCP is the easiest way to connect. CryptoQuant hosts the MCP server, and your AI client connects to it directly via URL.

> **Which method should I use?**
>
> * **Connector** — Recommended for most users. Simply connect and start asking questions in Claude.ai or Claude Desktop.
> * **Config Setting** — For developers who want to integrate CryptoQuant MCP into their own workflows or tools.

### Using Connector 

— [Claude.ai](http://Claude.ai) and Claude Desktop

1. In Claude, click **"Add connectors"**

2. Select **"Add custom connector"**

   ![Add custom connector](/files/uCluVYI4HwrxNRhAyli1)

3. Enter the following:
   * **Name**: `CryptoQuant`
   * **Remote MCP Server URL**: `https://mcp.cryptoquant.com/mcp`

4. Click **"Add"**

5. Click **"Connect"**

   ![Connect connector](/files/o6af7YGt3LXI9A6u8UId)

6. Choose either **API Key** or **Keyless** authentication

   ![Authentication options](/files/G70F6jxOucgdkVHMZieG)

   > ⚠️ **Keyless mode uses a shared rate limit pool.** This means limits may be reached more quickly due to usage from other users. For a dedicated rate limit, use your [own API Key](https://cryptoquant.com/settings/api).

7. You're ready to go!

### Using Config Setting

— Claude Desktop/Claude Code/Cursor

> ⚠️ **Prerequisites**: Node.js v18 or higher must be installed. [Download from nodejs.org](https://nodejs.org/en/download)

Add the following to your MCP configuration file:

#### **Claude Desktop (claude\_desktop\_config.json)**

path for Mac : `~/Library/Application Support/Claude/claude_desktop_config.json`

path for Windows : `%APPDATA%\\Claude\\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "CryptoQuant": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.cryptoquant.com/mcp"
      ]
    }
  }
}
```

#### **Cursor (mcp.json)**

path `.cursor/mcp.json`

```json
{
  "mcpServers": {
    "CryptoQuant": {
      "url": "https://mcp.cryptoquant.com/mcp"
    }
  }
}
```

#### **Claude Code**

```bash
claude mcp add --transport http CryptoQuant https://mcp.cryptoquant.com/mcp
```

After saving, restart the app.

#### Authentication

Complete the authentication flow the same way as the Connector setup above.

## Troubleshooting

#### Remote MCP Connection Issues

1. Verify the server URL is correct: `https://mcp.cryptoquant.com/mcp`
2. Check your internet connection
3. For desktop clients using config setting, verify Node.js v18+ is installed
4. Try refreshing the connector or removing and re-adding it

#### API Key Issues

1. Verify the API key is valid [on the settings page](https://cryptoquant.com/settings/api)
2. If using environment variables, verify they are set correctly


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://userguide.cryptoquant.com/api/mcp-server-beta/remote-mcp-recommended.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.