The GoldRush MCP Server provides a Model Context Protocol (MCP) implementation that exposes GoldRush APIs as MCP resources and tools. It enables LLMs to interact with blockchain data across multiple chains.
You’ll need a GoldRush API key to use this server.

Get Started

Sign up for a free API key to get started with GoldRush.

​
Setup Instructions

​
Step 1: Installation

No installation is needed as the server can be run directly using npx.

​
Step 2: Configure with MCP clients

1

Usage with Claude Desktop

Add this to your claude_desktop_config.json:
{
  "mcpServers": {
    "goldrush": {
      "command": "npx",
      "args": [
        "-y",
        "@covalenthq/goldrush-mcp-server@latest"
      ],
      "env": {
        "GOLDRUSH_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}
For more details, follow the official MCP Quickstart for Claude Desktop Users.
2

Usage with Claude Code CLI

$ claude mcp add goldrush -e GOLDRUSH_API_KEY=<YOUR_API_KEY_HERE> -- npx @covalenthq/goldrush-mcp-server
For more details, see Set up Model Context Protocol (MCP).
3

Usage with Cursor

  1. Open Cursor Settings
  2. Go to Features > MCP
  3. Click + Add new global MCP server
  4. Add this to your ~/.cursor/mcp.json:
{
  "mcpServers": {
    "goldrush": {
      "command": "npx",
      "args": [
        "-y",
        "@covalenthq/goldrush-mcp-server@latest"
      ],
      "env": {
        "GOLDRUSH_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}
For project-specific configuration, add the above to a .cursor/mcp.json file in your project directory.
4

Usage with Windsurf

Add this to your ~/.codeium/windsurf/mcp_config.json file:
{
  "mcpServers": {
    "goldrush": {
      "command": "npx",
      "args": [
        "-y",
        "@covalenthq/goldrush-mcp-server@latest"
      ],
      "env": {
        "GOLDRUSH_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

​
Step 3: Programmatic Usage

The server is designed to be started as a subprocess by an MCP client. Here’s an example using the MCP TypeScript SDK: 
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

const transport = new StdioClientTransport({
  command: "npx",
  args: ["-y", "@covalenthq/goldrush-mcp-server@latest"],
  env: {"GOLDRUSH_API_KEY": "your_api_key_here"}
});

const client = new Client(
  {
    name: "example-client",
    version: "1.0.0"
  },
  {
    capabilities: {
      tools: {}
    }
  }
);

await client.connect(transport);

// List tools
const resources = await client.listTools();
const tools = await client.listTools();
console.log("Available tools:", tools.tools.map(tool => tool.name).join(", "));

// Now you can call tools
const result = await client.callTool({
  name: "getAllChains",
  arguments: {}
});

console.log(result);

​
Available Tools

The GoldRush MCP Server exposes over 50 tools for interacting with blockchain data. Here are some of the most commonly used tools:
Visit our GitHub repository for a complete list of tools and their parameters.

​
Available Resources

Resources are a core primitive in the Model Context Protocol that allow servers to expose data and content for use as context in LLM interactions. The GoldRush MCP Server provides both static and dynamic resources:
Dynamic resources fetch real-time data from the GoldRush API on each request, ensuring current information.

​
Example LLM Interaction

Once you’ve set up the GoldRush MCP Server with your preferred LLM client, you can start asking blockchain-related questions:
  • “What are the top tokens in this Ethereum wallet: 0xeefB13C7D42eFCc655E528dA6d6F7bBcf9A2251d?”
  • “Show me the transaction history for this wallet address on Polygon.”
  • “What NFTs does this wallet own across multiple chains?”
  • “Get the gas prices for ERC20 transfers on Ethereum mainnet.”
The LLM will automatically use the appropriate GoldRush MCP tools to retrieve the blockchain data and provide you with informative responses.