GoldRush MCP Server

Instructions

Implementation Reference

• src/services/BitcoinService.ts:70-123 (handler)

  Implementation of the "bitcoin_transactions" tool, including registration, input schema definition, and the handler function.

  server.tool(
      "bitcoin_transactions",
      "Used to fetch the full transaction history of a Bitcoin wallet.\n" +
          "Required: address - The Bitcoin address to query transactions for.\n" +
          "Optional: pageSize - Number of results per page (default: 10).\n" +
          "Optional: pageNumber - Page number for pagination (default: 0, first page).\n" +
          "Returns comprehensive transaction details including timestamps, amounts, and transaction IDs.",
      {
          address: z
              .string()
              .describe(
                  "The Bitcoin address to get transaction history for. Must be a valid Bitcoin address."
              ),
          pageSize: z
              .number()
              .optional()
              .default(10)
              .describe(
                  "Number of transactions to return per page. Default is 10, maximum is 100."
              ),
          pageNumber: z
              .number()
              .optional()
              .default(0)
              .describe(
                  "Page number for pagination, starting from 0. Default is 0."
              ),
      },
      async (params) => {
          try {
              const response =
                  await goldRushClient.BitcoinService.getTransactionsForBtcAddress(
                      {
                          address: params.address,
                          pageSize: params.pageSize,
                          pageNumber: params.pageNumber,
                      }
                  );
              return {
                  content: [
                      {
                          type: "text",
                          text: stringifyWithBigInt(response.data),
                      },
                  ],
              };
          } catch (error) {
              return {
                  content: [{ type: "text", text: `Error: ${error}` }],
                  isError: true,
              };
          }
      }
  );