GoldRush

Dados de blockchain em mais de 100 redes — saldos de carteiras, preços de tokens, transações, pares DEX e mais. API REST, WebSocket em tempo real com feeds de preços OHLCV, CLI e x402 pague por requisição.

Ver em goldrush.devExperimente este MCPPatrocinado

Documentação

Servidor MCP GoldRush

Um servidor que expõe as APIs GoldRush como recursos e ferramentas MCP, permitindo que LLMs interajam com dados de blockchain.

O Servidor MCP GoldRush fornece uma implementação do Model Context Protocol (MCP) que expõe as APIs GoldRush como recursos e ferramentas MCP. Ele permite que LLMs interajam com dados de blockchain em múltiplas redes.

Nota

Você precisará de uma chave de API GoldRush para usar este servidor.

Cadastre-se por \$10/mês - perfeito para desenvolvedores nativos de IA que usam Claude, Cursor ou Windsurf.

Instruções de Configuração

Passo 1: Instalação

Nenhuma instalação é necessária, pois o servidor pode ser executado diretamente usando npx.

Passo 2: Configurar com clientes MCP

Adicione isto ao seu `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 mais detalhes, siga o [MCP Quickstart oficial para usuários do Claude Desktop](https://modelcontextprotocol.io/quickstart/user).

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

Para mais detalhes, veja [Configurar Model Context Protocol (MCP)](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/tutorials#set-up-model-context-protocol-mcp).

1. Abra as Configurações do Cursor 2. Vá para Features > MCP 3. Clique em + Adicionar novo servidor MCP global 4. Adicione isto ao seu `~/.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 configuração específica do projeto, adicione o acima a um arquivo `.cursor/mcp.json` no diretório do seu projeto.

Adicione isto ao seu arquivo `~/.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>"
      }
    }
  }
}   
```

Passo 3: Uso Programático

O servidor foi projetado para ser iniciado como um subprocesso por um cliente MCP. Aqui está um exemplo usando o SDK TypeScript do 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);

Ferramentas Disponíveis

O Servidor MCP GoldRush expõe mais de 50 ferramentas para interagir com dados de blockchain. Aqui estão algumas das ferramentas mais comumente usadas:

* **multichain_address_activity**: Obtém um resumo da atividade da carteira em todas as blockchains suportadas. * **multichain_balances**: Obtém saldos de tokens para um endereço de carteira em múltiplas blockchains. * **multichain_transactions**: Obtém transações para múltiplos endereços de carteira em múltiplas blockchains. * **token_balances**: Comumente usado para buscar os tokens nativos e fungíveis (ERC20) mantidos por um endereço. * **historical_token_balances**: Comumente usado para buscar os tokens nativos e fungíveis (ERC20) históricos mantidos por um endereço em uma determinada altura de bloco ou data. * **native_token_balance**: Obtém o saldo do token nativo (ETH, BNB, MATIC, etc.) para um endereço de carteira especificado em uma blockchain. * **erc20_token_transfers**: Comumente usado para renderizar as transferências de entrada e saída de um token junto com preços históricos de um endereço. * **historical_portfolio_value**: Comumente usado para renderizar um saldo diário de portfólio para um endereço, dividido por token. * **token_holders**: Usado para obter uma lista paginada de detentores de tokens atuais ou históricos para um token ERC20 ou ERC721 especificado. * **transaction**: Comumente usado para buscar e renderizar uma única transação, incluindo seus eventos de log decodificados. * **transaction_summary**: Comumente usado para buscar as transações mais antigas e mais recentes, e a contagem de transações de uma carteira. * **transactions_for_address**: Comumente usado para buscar e renderizar as transações mais recentes envolvendo um endereço. * **transactions_for_block**: Comumente usado para buscar todas as transações, incluindo seus eventos de log decodificados em um bloco, e sinalizar carteiras ou transações interessantes. * **nft_for_address**: Comumente usado para obter todos os NFTs pertencentes a um endereço de carteira específico em uma blockchain. * **nft_check_ownership**: Comumente usado para verificar a propriedade de NFTs (incluindo ERC-721 e ERC-1155) dentro de uma coleção. * **token_approvals**: Comumente usado para obter uma lista de aprovações em todos os contratos de tokens, categorizadas por gastadores, para os ativos de uma carteira. * **bitcoin_hd_wallet_balances**: Busca saldos para cada endereço filho ativo derivado de uma carteira HD Bitcoin. * **bitcoin_non_hd_wallet_balances**: Busca o saldo Bitcoin para um endereço não-HD. * **bitcoin_transactions**: Busca transações para um endereço Bitcoin específico com detalhes completos da transação. * **historical_token_prices**: Comumente usado para obter preços históricos de um token entre intervalos de datas. * **gas_prices**: Obtém estimativas de gás em tempo real para diferentes velocidades de transação em uma rede específica. * **log_events_by_address**: Comumente usado para obter todos os logs de eventos emitidos por um endereço de contrato específico. * **log_events_by_topic**: Comumente usado para obter todos os logs de eventos do mesmo hash de tópico em todos os contratos dentro de uma cadeia específica. * **block**: Comumente usado para buscar e renderizar um único bloco para um explorador de blocos. * **block_heights**: Comumente usado para obter todas as alturas de blocos dentro de um intervalo de datas específico.

Visite nosso repositório no GitHub para uma lista completa de ferramentas e seus parâmetros.

Recursos Disponíveis

Recursos são uma primitiva central no Model Context Protocol que permitem que servidores exponham dados e conteúdo para uso como contexto em interações com LLMs. O Servidor MCP GoldRush fornece recursos estáticos e dinâmicos:

* **config://supported-chains**: Fornece uma lista de todas as redes blockchain suportadas pela API GoldRush * **config://quote-currencies**: Fornece uma lista de todas as moedas de cotação suportadas para conversões de preço * **status\://all-chains**: Fornece o status de sincronização em tempo real para todas as cadeias * **status\://chain/{chainName}**: Fornece informações detalhadas de status para uma cadeia específica

Recursos dinâmicos buscam dados em tempo real da API GoldRush a cada solicitação, garantindo informações atualizadas.

Exemplo de Interação com LLM

Depois de configurar o Servidor MCP GoldRush com seu cliente LLM preferido, você pode começar a fazer perguntas relacionadas a blockchain:

"Quais são os principais tokens nesta carteira Ethereum: 0xeefB13C7D42eFCc655E528dA6d6F7bBcf9A2251d?"
"Mostre-me o histórico de transações para este endereço de carteira na Polygon."
"Quais NFTs esta carteira possui em múltiplas cadeias?"
"Obtenha os preços de gás para transferências ERC20 na mainnet Ethereum."

O LLM usará automaticamente as ferramentas MCP GoldRush apropriadas para recuperar os dados de blockchain e fornecer respostas informativas.

Recursos Relacionados

GoldRush Agent Skills — Instale habilidades para agentes de IA (Claude, Cursor, Gemini)
GoldRush SDKs & CLI — Ferramentas TypeScript, Python e CLI
Powered by GoldRush — Veja como projetos usam nossas APIs
O que é GoldRush — Aprenda sobre todos os produtos GoldRush