GoldRush MCP Server

Instructions

Implementation Reference

• src/services/AllChainsService.ts:95-124 (handler)

  The handler for the multichain_transactions tool, which executes the GoldRush client call to getMultiChainMultiAddressTransactions.

  async (params) => {
      try {
          const response =
              await goldRushClient.AllChainsService.getMultiChainMultiAddressTransactions(
                  {
                      chains: params.chains as Chain[],
                      addresses: params.addresses,
                      limit: params.limit,
                      before: params.before,
                      after: params.after,
                      withLogs: params.withLogs,
                      withDecodedLogs: params.withDecodedLogs,
                      quoteCurrency: params.quoteCurrency as Quote,
                  }
              );
          return {
              content: [
                  {
                      type: "text",
                      text: stringifyWithBigInt(response.data),
                  },
              ],
          };
      } catch (error) {
          return {
              content: [{ type: "text", text: `Error: ${error}` }],
              isError: true,
          };
      }
  }

• src/services/AllChainsService.ts:35-94 (schema)

  Input schema validation for the multichain_transactions tool using Zod.

  {
      chains: z
          .array(
              z.union([
                  z.enum(
                      Object.values(ChainName) as [string, ...string[]]
                  ),
                  z.number(),
              ])
          )
          .optional()
          .describe(
              "Array of blockchain networks to query. Can be chain names (e.g., 'eth-mainnet') or chain IDs (e.g., 1). If not specified, queries all supported chains."
          ),
      addresses: z
          .array(z.string())
          .optional()
          .describe(
              "Array of wallet addresses to get transactions for. Each address should be a valid blockchain address."
          ),
      limit: z
          .number()
          .optional()
          .default(10)
          .describe(
              "Maximum number of transactions to return per request. Default is 10, maximum is 100."
          ),
      before: z
          .string()
          .optional()
          .describe(
              "Pagination cursor to get transactions before this point. Use the 'before' value from previous response."
          ),
      after: z
          .string()
          .optional()
          .describe(
              "Pagination cursor to get transactions after this point. Use the 'after' value from previous response."
          ),
      withLogs: z
          .boolean()
          .optional()
          .default(false)
          .describe(
              "Include transaction logs in the response. Default is false."
          ),
      withDecodedLogs: z
          .boolean()
          .optional()
          .default(false)
          .describe(
              "Include decoded transaction logs in the response. Only applicable when withLogs is true. Default is false."
          ),
      quoteCurrency: z
          .enum(Object.values(validQuoteValues) as [string, ...string[]])
          .optional()
          .describe(
              "Currency to quote token values in (e.g., 'USD', 'EUR'). If not specified, uses default quote currency."
          ),
  },

• src/services/AllChainsService.ts:28-94 (registration)

  Registration of the multichain_transactions tool within the MCP server.

  server.tool(
      "multichain_transactions",
      "Fetch paginated transactions for up to 10 EVM addresses and 10 EVM chains with one API call. Useful for building Activity Feeds. " +
          "Requires addresses array. Optional parameters include chains array, " +
          "pagination (before/after), limit (default 10), quoteCurrency for value conversion, " +
          "and options to include logs (withLogs, withDecodedLogs). " +
          "Use this to analyze transaction history across different networks simultaneously.",
      {
          chains: z
              .array(
                  z.union([
                      z.enum(
                          Object.values(ChainName) as [string, ...string[]]
                      ),
                      z.number(),
                  ])
              )
              .optional()
              .describe(
                  "Array of blockchain networks to query. Can be chain names (e.g., 'eth-mainnet') or chain IDs (e.g., 1). If not specified, queries all supported chains."
              ),
          addresses: z
              .array(z.string())
              .optional()
              .describe(
                  "Array of wallet addresses to get transactions for. Each address should be a valid blockchain address."
              ),
          limit: z
              .number()
              .optional()
              .default(10)
              .describe(
                  "Maximum number of transactions to return per request. Default is 10, maximum is 100."
              ),
          before: z
              .string()
              .optional()
              .describe(
                  "Pagination cursor to get transactions before this point. Use the 'before' value from previous response."
              ),
          after: z
              .string()
              .optional()
              .describe(
                  "Pagination cursor to get transactions after this point. Use the 'after' value from previous response."
              ),
          withLogs: z
              .boolean()
              .optional()
              .default(false)
              .describe(
                  "Include transaction logs in the response. Default is false."
              ),
          withDecodedLogs: z
              .boolean()
              .optional()
              .default(false)
              .describe(
                  "Include decoded transaction logs in the response. Only applicable when withLogs is true. Default is false."
              ),
          quoteCurrency: z
              .enum(Object.values(validQuoteValues) as [string, ...string[]])
              .optional()
              .describe(
                  "Currency to quote token values in (e.g., 'USD', 'EUR'). If not specified, uses default quote currency."
              ),
      },