GoldRush MCP Server

Instructions

Implementation Reference

• src/services/BalanceService.ts:244-265 (handler)

  The handler for the historical_portfolio_value tool, which calls goldRushClient.BalanceService.getHistoricalPortfolioForWalletAddress.

  async (params) => {
      try {
          const response =
              await goldRushClient.BalanceService.getHistoricalPortfolioForWalletAddress(
                  params.chainName as Chain,
                  params.walletAddress,
                  {
                      quoteCurrency: params.quoteCurrency as Quote,
                      days: params.days,
                  }
              );
          return {
              content: [
                  {
                      type: "text",
                      text: stringifyWithBigInt(response.data),
                  },
              ],
          };
      } catch (error) {
          return {
              content: [{ type: "text", text: `Error: ${error}` }],

• src/services/BalanceService.ts:219-243 (schema)

  The Zod schema validation for the historical_portfolio_value tool parameters.

  {
      chainName: z
          .enum(Object.values(ChainName) as [string, ...string[]])
          .describe(
              "The blockchain network to query (e.g., 'eth-mainnet', 'matic-mainnet', 'bsc-mainnet')."
          ),
      walletAddress: z
          .string()
          .describe(
              "The wallet address to get portfolio history for. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically."
          ),
      quoteCurrency: z
          .enum(Object.values(validQuoteValues) as [string, ...string[]])
          .optional()
          .describe(
              "Currency to quote portfolio values in (e.g., 'USD', 'EUR'). If not specified, uses default quote currency."
          ),
      days: z
          .number()
          .optional()
          .default(7)
          .describe(
              "Number of days of historical data to retrieve. Default is 7 days."
          ),
  },

• src/services/BalanceService.ts:213-243 (registration)

  The MCP tool registration for historical_portfolio_value.

  server.tool(
      "historical_portfolio_value",
      "Commonly used to render a daily portfolio balance for an address broken down by the token. " +
          "Required: chainName (blockchain network), walletAddress (wallet address). " +
          "Optional: quoteCurrency for value conversion, days (timeframe to analyze, default 7). " +
          "Returns portfolio value time series data showing value changes over the specified timeframe.",
      {
          chainName: z
              .enum(Object.values(ChainName) as [string, ...string[]])
              .describe(
                  "The blockchain network to query (e.g., 'eth-mainnet', 'matic-mainnet', 'bsc-mainnet')."
              ),
          walletAddress: z
              .string()
              .describe(
                  "The wallet address to get portfolio history for. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically."
              ),
          quoteCurrency: z
              .enum(Object.values(validQuoteValues) as [string, ...string[]])
              .optional()
              .describe(
                  "Currency to quote portfolio values in (e.g., 'USD', 'EUR'). If not specified, uses default quote currency."
              ),
          days: z
              .number()
              .optional()
              .default(7)
              .describe(
                  "Number of days of historical data to retrieve. Default is 7 days."
              ),
      },