GoldRush

Datos de blockchain en más de 100 cadenas: saldos de billeteras, precios de tokens, transacciones, pares DEX y más. API REST, WebSocket en tiempo real con feeds de precios OHLCV, CLI y x402 pago por solicitud.

Ver en goldrush.devPrueba este MCPPatrocinado

Documentación

Servidor MCP de GoldRush

Un servidor que expone las APIs de GoldRush como recursos y herramientas MCP, permitiendo que los LLM interactúen con datos de blockchain.

El Servidor MCP de GoldRush proporciona una implementación del Protocolo de Contexto de Modelo (MCP) que expone las APIs de GoldRush como recursos y herramientas MCP. Permite que los LLM interactúen con datos de blockchain en múltiples cadenas.

Nota

Necesitarás una clave de API de GoldRush para usar este servidor.

Regístrate por \$10/mes: perfecto para desarrolladores nativos de IA que usan Claude, Cursor o Windsurf.

Instrucciones de Configuración

Paso 1: Instalación

No se necesita instalación, ya que el servidor se puede ejecutar directamente usando npx.

Paso 2: Configurar con clientes MCP

Añade esto a tu `claude_desktop_config.json`:

```json theme={null}
{
  "mcpServers": {
    "goldrush": {
      "command": "npx",
      "args": [
        "-y",
        "@covalenthq/goldrush-mcp-server@latest"
      ],
      "env": {
        "GOLDRUSH_API_KEY": "<GOLDRUSH_API_KEY>"
      }
    }
  }
}   
```

Para más detalles, sigue la [Guía rápida oficial de MCP para usuarios de Claude Desktop](https://modelcontextprotocol.io/quickstart/user).

```bash theme={null} $ claude mcp add goldrush -e GOLDRUSH_API_KEY= -- npx @covalenthq/goldrush-mcp-server ```

Para más detalles, consulta [Configurar el Protocolo de Contexto de Modelo (MCP)](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/tutorials#set-up-model-context-protocol-mcp).

1. Abre la Configuración de Cursor 2. Ve a Funciones > MCP 3. Haz clic en + Añadir nuevo servidor MCP global 4. Añade esto a tu `~/.cursor/mcp.json`:

```json theme={null}
{
  "mcpServers": {
    "goldrush": {
      "command": "npx",
      "args": [
        "-y",
        "@covalenthq/goldrush-mcp-server@latest"
      ],
      "env": {
        "GOLDRUSH_API_KEY": "<GOLDRUSH_API_KEY>"
      }
    }
  }
}   
```

Para una configuración específica del proyecto, añade lo anterior a un archivo `.cursor/mcp.json` en el directorio de tu proyecto.

Añade esto a tu archivo `~/.codeium/windsurf/mcp_config.json`:

```json theme={null}
{
  "mcpServers": {
    "goldrush": {
      "command": "npx",
      "args": [
        "-y",
        "@covalenthq/goldrush-mcp-server@latest"
      ],
      "env": {
        "GOLDRUSH_API_KEY": "<GOLDRUSH_API_KEY>"
      }
    }
  }
}   
```

Paso 3: Uso Programático

El servidor está diseñado para iniciarse como un subproceso por un cliente MCP. Aquí tienes un ejemplo usando el SDK de TypeScript de MCP:

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": "<GOLDRUSH_API_KEY>"}
});

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

await client.connect(transport);

// List tools
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);

Herramientas Disponibles

El Servidor MCP de GoldRush expone más de 50 herramientas para interactuar con datos de blockchain. Estas son algunas de las herramientas más utilizadas:

* **multichain_address_activity**: Obtiene un resumen de la actividad de una billetera en todas las blockchains compatibles. * **multichain_balances**: Obtiene los saldos de tokens para una dirección de billetera en múltiples blockchains. * **multichain_transactions**: Obtiene transacciones para múltiples direcciones de billetera en múltiples blockchains. * **token_balances**: Se usa comúnmente para obtener los tokens nativos y fungibles (ERC20) que posee una dirección. * **historical_token_balances**: Se usa comúnmente para obtener los tokens nativos y fungibles (ERC20) históricos que posee una dirección en una altura de bloque o fecha determinada. * **native_token_balance**: Obtiene el saldo de token nativo (ETH, BNB, MATIC, etc.) para una dirección de billetera específica en una blockchain. * **erc20_token_transfers**: Se usa comúnmente para mostrar las transferencias de entrada y salida de un token junto con los precios históricos de una dirección. * **historical_portfolio_value**: Se usa comúnmente para mostrar un saldo diario de cartera para una dirección desglosado por token. * **token_holders**: Se usa para obtener una lista paginada de tenedores de tokens actuales o históricos para un token ERC20 o ERC721 específico. * **transaction**: Se usa comúnmente para obtener y mostrar una sola transacción, incluidos sus eventos de registro decodificados. * **transaction_summary**: Se usa comúnmente para obtener las transacciones más antiguas y más recientes, y el conteo de transacciones de una billetera. * **transactions_for_address**: Se usa comúnmente para obtener y mostrar las transacciones más recientes que involucran una dirección. * **transactions_for_block**: Se usa comúnmente para obtener todas las transacciones, incluidos sus eventos de registro decodificados en un bloque, y marcar billeteras o transacciones interesantes. * **nft_for_address**: Se usa comúnmente para obtener todos los NFT que posee una dirección de billetera específica en una blockchain. * **nft_check_ownership**: Se usa comúnmente para verificar la propiedad de NFT (incluidos ERC-721 y ERC-1155) dentro de una colección. * **token_approvals**: Se usa comúnmente para obtener una lista de aprobaciones en todos los contratos de tokens categorizadas por gastadores para los activos de una billetera. * **bitcoin_hd_wallet_balances**: Obtiene los saldos de cada dirección hija activa derivada de una billetera HD de Bitcoin. * **bitcoin_non_hd_wallet_balances**: Obtiene el saldo de Bitcoin para una dirección no HD. * **bitcoin_transactions**: Obtiene transacciones para una dirección de Bitcoin específica con detalles completos de la transacción. * **historical_token_prices**: Se usa comúnmente para obtener precios históricos de un token entre rangos de fechas. * **gas_prices**: Obtiene estimaciones de gas en tiempo real para diferentes velocidades de transacción en una red específica. * **log_events_by_address**: Se usa comúnmente para obtener todos los registros de eventos emitidos desde una dirección de contrato específica. * **log_events_by_topic**: Se usa comúnmente para obtener todos los registros de eventos del mismo hash de tema en todos los contratos dentro de una cadena específica. * **block**: Se usa comúnmente para obtener y mostrar un solo bloque para un explorador de bloques. * **block_heights**: Se usa comúnmente para obtener todas las alturas de bloque dentro de un rango de fechas específico.

Visita nuestro repositorio de GitHub para obtener una lista completa de herramientas y sus parámetros.

Recursos Disponibles

Los recursos son una primitiva central en el Protocolo de Contexto de Modelo que permiten a los servidores exponer datos y contenido para usarse como contexto en interacciones con LLM. El Servidor MCP de GoldRush proporciona recursos tanto estáticos como dinámicos:

* **config://supported-chains**: Proporciona una lista de todas las redes blockchain compatibles con la API de GoldRush * **config://quote-currencies**: Proporciona una lista de todas las monedas de cotización compatibles para conversiones de precios * **status\://all-chains**: Proporciona el estado de sincronización en tiempo real de todas las cadenas * **status\://chain/{chainName}**: Proporciona información detallada del estado de una cadena específica

Los recursos dinámicos obtienen datos en tiempo real de la API de GoldRush en cada solicitud, lo que garantiza información actualizada.

Ejemplo de Interacción con LLM

Una vez que hayas configurado el Servidor MCP de GoldRush con tu cliente LLM preferido, puedes comenzar a hacer preguntas relacionadas con blockchain:

"¿Cuáles son los principales tokens en esta billetera de Ethereum: 0xeefB13C7D42eFCc655E528dA6d6F7bBcf9A2251d?"
"Muéstrame el historial de transacciones de esta dirección de billetera en Polygon."
"¿Qué NFT posee esta billetera en múltiples cadenas?"
"Obtén los precios de gas para transferencias ERC20 en la red principal de Ethereum."

El LLM usará automáticamente las herramientas MCP de GoldRush apropiadas para recuperar los datos de blockchain y proporcionarte respuestas informativas.

Recursos Relacionados

Habilidades de Agente de GoldRush — Instala habilidades para agentes de IA (Claude, Cursor, Gemini)
SDK y CLI de GoldRush — Herramientas de TypeScript, Python y CLI
Impulsado por GoldRush — Mira cómo los proyectos usan nuestras APIs
Qué es GoldRush — Aprende sobre todos los productos de GoldRush

Esta documentación está construida y alojada en Mintlify, una plataforma de documentación para desarrolladores.