Glassnode MCP Server

A guide to using Glassnode's Model Context Protocol (MCP) server for AI agents.

The Glassnode MCP Server is currently in beta, and its tools are subject to change. Although this MCP server produces accurate data, it is possible that it could be misinterpreted by the LLM you are using.

Overview

Crypto on-chain metrics and market intelligence for AI agents.

A Model Context Protocol (MCP) server providing access to Glassnode's API. The server enables AI agents to access on-chain metrics, market data, and analytics.

For detailed information about the API and available data:

• Glassnode API Documentation

• Glassnode Metric Catalog

• Supported Assets

Features

• Asset and metrics discovery

• Metric metadata retrieval

• Single and bulk data retrieval

Tools

The server provides seven tools for accessing Glassnode data:

1. get_assets_list: Get a list of all cryptocurrencies and tokens supported by Glassnode

2. get_metrics_list: Get a catalog of all available metrics and their paths, optionally filtered by category

3. get_asset_metrics: Get metrics available for a specific asset

4. get_metric_metadata: Get detailed information about a specific metric's structure and parameters

5. fetch_metric: Fetch data (max 30d history) for a specific metric with customizable parameters

6. fetch_bulk_metrics: Fetch data (max 30d history) for multiple assets simultaneously in a single request

Quick Setup

Install the Glassnode MCP server across all your AI clients with a single command:

Public Access

npx add-mcp https://mcp.glassnode.com

Authenticated

This auto-detects installed clients (Claude Code, Cursor, VS Code, Codex, and more) and configures them.

Or follow the per-client instructions below.

The Authenticated tab in each section removes the 30-day time range limit. When using an API key, each request consumes API credits just like a direct API call. Get your key at studio.glassnode.com/settings/api.

Only configure one version of the Glassnode MCP server per client — either public access or authenticated, not both. See Troubleshooting for more details.

Claude.ai and Claude for desktop

1. Open Claude desktop or web app

2. Go to Settings > Connectors > Add custom connector (https://claude.ai/settings/connectors)

3. Enter the URL: https://mcp.glassnode.com

4. Click Add

5. Claude will automatically configure the connection

Connectors do not support custom headers. To use an API key, use the Claude Desktop (Manual Configuration) method instead.

Claude Code

Public Access

claude mcp add --transport http glassnode https://mcp.glassnode.com

Authenticated

Claude Desktop (Manual Configuration)

Add the following to your claude_desktop_config.json:

Public Access

{
  "mcpServers": {
    "glassnode": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.glassnode.com"
      ]
    }
  }
}

Authenticated

Cursor

Add to .cursor/mcp.json in your project root:

Public Access

{
  "mcpServers": {
    "glassnode": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.glassnode.com"
      ]
    }
  }
}

Authenticated

ChatGPT

1. Enable Developer mode in ChatGPT settings

2. Go to Settings > Connectors and click Create

3. Enter the following:

   • Name: Glassnode

   • MCP server URL: https://mcp.glassnode.com

4. Click Create

The Glassnode connector will appear in the composer's Developer mode tools.

ChatGPT connectors do not support custom headers. Use the public access version, or access the Glassnode API directly for authenticated queries.

Windsurf

Add to your mcp_config.json:

Public Access

{
  "mcpServers": {
    "glassnode": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.glassnode.com"
      ]
    }
  }
}

Authenticated

VS Code with Copilot

Public Access

1. Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P)

2. Search for MCP: Add Server

3. Select Command (stdio)

4. Enter npx as the command

5. Enter mcp-remote https://mcp.glassnode.com as the arguments

6. Name it glassnode

Authenticated

Codex CLI

Public Access

codex mcp add glassnode --url https://mcp.glassnode.com

Authenticated

Gemini CLI

Add the following to your ~/.gemini/settings.json:

Public Access

{
  "mcpServers": {
    "glassnode": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.glassnode.com"
      ]
    }
  }
}

Authenticated

Gemini Code Assist

Gemini Code Assist shares the same configuration as Gemini CLI. Add the config above to your ~/.gemini/settings.json, then restart your IDE.

Other MCP Clients

Most MCP-compatible clients support a JSON configuration file. Add the following to your client's MCP config:

Public Access

{
  "mcpServers": {
    "glassnode": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.glassnode.com"
      ]
    }
  }
}

Authenticated

Restart your client after updating the configuration.

Troubleshooting

Duplicate MCP servers

If you added both the public access and API key versions of the Glassnode MCP server, your AI client may see duplicate tools or fail to connect. Keep only one configuration at a time.

To remove the extra server:

• Claude Code: claude mcp remove glassnode, then re-add the version you want.

• Claude Desktop / Cursor / Windsurf: Edit your JSON config file and remove the duplicate glassnode entry.

• VS Code with Copilot: Open the Command Palette, search for MCP: List Servers, and remove the duplicate.

Connection issues

• Restart your client after changing any MCP configuration.

• Verify npx is available by running npx --version in your terminal. If not found, install Node.js.

• Firewall or proxy — ensure your network allows outbound HTTPS connections to mcp.glassnode.com.

Example Prompts

Get an overview of the MCP tools.

What can Glassnode mcp do?

Simple prompts:

- What market metrics Glassnode has for Ethereum?
- What assets does Glassnode support?
- Bitcoin price, use 10 minute resolution

More advanced:

- SOPR and MVRV for Bitcoin and Ethereum, values for the past month
- Show me Bitcoin whale activity
- Compare the market caps of Bitcoin, Ethereum, and Solana over the last month

---