@covalenthq/goldrush-mcp-server 0.0.2 → 0.0.4

package/dist/server.js

@@ -12,23 +12,25 @@ import { addTransactionServiceTools } from "./services/TransactionService.js";
 import { GoldRushClient } from "@covalenthq/client-sdk";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import dotenv from "dotenv";
-const { version } = packageJson;
+import express from "express";
 dotenv.config();
-export function createGoldRushClient() {
-    const apiKey = process.env["GOLDRUSH_API_KEY"];
-    if (!apiKey) {
-        console.error("GOLDRUSH_API_KEY environment variable is not set.");
-        process.exit(1);
+const { version } = packageJson;
+const DEFAULT_PORT = 3000;
+export function createGoldRushClient(apiKey) {
+    const key = apiKey || process.env["GOLDRUSH_API_KEY"];
+    if (!key) {
+        throw new Error("GOLDRUSH_API_KEY is required. Provide it as a parameter or set the environment variable.");
     }
-    return new GoldRushClient(apiKey);
+    return new GoldRushClient(key);
 }
-export function createServer() {
-    const goldRushClient = createGoldRushClient();
+export function createServer(apiKey) {
+    const goldRushClient = createGoldRushClient(apiKey);
     const server = new McpServer({
         name: "GoldRush MCP Server",
         version: version,
-    });
+    }, { capabilities: { logging: {} } });
     addStaticResources(server);
     addRealTimeChainStatusResources(server, goldRushClient);
     addAllChainsServiceTools(server, goldRushClient);
@@ -41,14 +43,210 @@ export function createServer() {
     addSecurityServiceTools(server, goldRushClient);
     return server;
 }
-export async function startServer() {
+export async function startStdioServer(apiKey) {
     try {
-        const server = createServer();
+        const server = createServer(apiKey);
         const transport = new StdioServerTransport();
         await server.connect(transport);
     }
     catch (error) {
-        console.error("Failed to start server:", error);
+        console.error("Failed to start STDIO server:", error);
+        process.exit(1);
+    }
+}
+export function startHttpServer(port = DEFAULT_PORT) {
+    const app = express();
+    app.use(express.json());
+    app.post("/mcp", async (req, res) => {
+        try {
+            const authHeader = req.headers.authorization;
+            const requestId = (() => {
+                try {
+                    return req.body?.id || null;
+                }
+                catch {
+                    return null;
+                }
+            })();
+            if (!authHeader || !authHeader.startsWith("Bearer ")) {
+                console.log("Received invalid Authorization header");
+                res.writeHead(401).end(JSON.stringify({
+                    jsonrpc: "2.0",
+                    error: {
+                        code: -32001,
+                        message: "Missing or invalid Authorization header. Expected format: Bearer <GOLDRUSH_API_KEY>",
+                    },
+                    id: requestId,
+                }));
+                return;
+            }
+            const apiKey = authHeader?.split(" ")[1];
+            if (!apiKey || apiKey.trim() === "") {
+                console.log("Received invalid API key");
+                res.writeHead(401).end(JSON.stringify({
+                    jsonrpc: "2.0",
+                    error: {
+                        code: -32001,
+                        message: "API key is empty or invalid",
+                    },
+                    id: requestId,
+                }));
+                return;
+            }
+            const server = createServer(apiKey);
+            const transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: undefined,
+            });
+            res.on("close", () => {
+                console.log("Request closed");
+                transport.close();
+                server.close();
+            });
+            await server.connect(transport);
+            await transport.handleRequest(req, res, req.body);
+        }
+        catch (error) {
+            console.error("Error handling MCP request:", error);
+            if (!res.headersSent) {
+                res.status(500).json({
+                    jsonrpc: "2.0",
+                    error: {
+                        code: -32603,
+                        message: "Internal server error",
+                    },
+                    id: null,
+                });
+            }
+        }
+    });
+    app.get("/mcp", async (req, res) => {
+        console.log("Received GET MCP request");
+        res.writeHead(405).end(JSON.stringify({
+            jsonrpc: "2.0",
+            error: {
+                code: -32000,
+                message: "Method not allowed.",
+            },
+            id: null,
+        }));
+    });
+    app.delete("/mcp", async (req, res) => {
+        console.log("Received DELETE MCP request");
+        res.writeHead(405).end(JSON.stringify({
+            jsonrpc: "2.0",
+            error: {
+                code: -32000,
+                message: "Method not allowed.",
+            },
+            id: null,
+        }));
+    });
+    app.listen(port, () => {
+        console.log(`MCP Streamable HTTP Server listening on port ${port}`);
+    });
+    process.on("SIGINT", async () => {
+        console.log("Shutting down HTTP server...");
+        process.exit(0);
+    });
+}
+export async function startServer(transportType = "stdio", options = {}) {
+    const { port = DEFAULT_PORT, apiKey } = options;
+    switch (transportType) {
+        case "stdio":
+            await startStdioServer(apiKey);
+            break;
+        case "http":
+            startHttpServer(port);
+            break;
+        default:
+            throw new Error(`Unsupported transport type: ${transportType}`);
+    }
+}
+export function parseArgsAndStart() {
+    try {
+        const args = process.argv.slice(2);
+        let transportType = "stdio";
+        let port = DEFAULT_PORT;
+        let apiKey;
+        for (let i = 0; i < args.length; i++) {
+            const arg = args[i];
+            switch (arg) {
+                case "--transport":
+                case "-t": {
+                    const transport = args[i + 1];
+                    if (!transport) {
+                        throw new Error("Transport type is required");
+                    }
+                    if (transport === "stdio" || transport === "http") {
+                        transportType = transport;
+                        i++;
+                    }
+                    else {
+                        throw new Error(`Invalid transport type: ${transport}. Supported: stdio, http`);
+                    }
+                    break;
+                }
+                case "--port":
+                case "-p": {
+                    const portStr = args[i + 1];
+                    if (!portStr) {
+                        throw new Error("Port value is required");
+                    }
+                    const parsedPort = parseInt(portStr, 10);
+                    if (isNaN(parsedPort) ||
+                        parsedPort < 1 ||
+                        parsedPort > 65535) {
+                        throw new Error(`Invalid port: ${portStr}`);
+                    }
+                    port = parsedPort;
+                    i++;
+                    break;
+                }
+                case "--api-key":
+                case "-k": {
+                    const keyValue = args[i + 1];
+                    if (!keyValue) {
+                        throw new Error("API key cannot be empty");
+                    }
+                    apiKey = keyValue;
+                    i++;
+                    break;
+                }
+                case "--help":
+                case "-h":
+                    console.log(`
+GoldRush MCP Server v${version}
+
+Usage: goldrush-mcp-server [options]
+
+Options:
+  -t, --transport <type>    Transport type: stdio (default) or http
+  -p, --port <number>       Port for HTTP transport (default: ${DEFAULT_PORT})
+  -k, --api-key <key>       GoldRush API key (or set GOLDRUSH_API_KEY env var)
+  -h, --help                Show this help message
+
+Examples:
+  goldrush-mcp-server                           # STDIO transport
+  goldrush-mcp-server -t http                   # HTTP transport on default port
+  goldrush-mcp-server -t http -p 8080           # HTTP transport on port 8080
+  goldrush-mcp-server -k your_api_key          # With API key argument
+`);
+                    process.exit(0);
+                    break;
+                default:
+                    if (arg && arg.startsWith("-")) {
+                        throw new Error(`Unknown argument: ${arg}`);
+                    }
+                    break;
+            }
+        }
+        startServer(transportType, { port, apiKey }).catch((error) => {
+            console.error("Failed to start server:", error);
+            process.exit(1);
+        });
+    }
+    catch (error) {
+        console.error("Error:", error instanceof Error ? error.message : error);
         process.exit(1);
     }
 }

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAKA,OAAO,WAAW,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAChE,OAAO,EAAE,+BAA+B,EAAE,MAAM,iCAAiC,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,MAAM,MAAM,QAAQ,CAAC;AAG5B,MAAM,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC;AAGhC,MAAM,CAAC,MAAM,EAAE,CAAC;AAKhB,MAAM,UAAU,oBAAoB;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAKD,MAAM,UAAU,YAAY;IACxB,MAAM,cAAc,GAAG,oBAAoB,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QACzB,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,OAAO;KACnB,CAAC,CAAC;IAGH,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,+BAA+B,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAGxD,wBAAwB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACjD,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,sBAAsB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC/C,0BAA0B,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACnD,sBAAsB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC/C,kBAAkB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3C,sBAAsB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC/C,uBAAuB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAChD,OAAO,MAAM,CAAC;AAClB,CAAC;AAKD,MAAM,CAAC,KAAK,UAAU,WAAW;IAC7B,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/services/AllChainsService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AllChainsService.d.ts","sourceRoot":"","sources":["../../src/services/AllChainsService.ts"],"names":[],"mappings":"AAEA,OAAO,EAIH,KAAK,cAAc,EAEtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAczE,wBAAgB,wBAAwB,CACpC,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,cAAc,QAwJjC"}
+{"version":3,"file":"AllChainsService.d.ts","sourceRoot":"","sources":["../../src/services/AllChainsService.ts"],"names":[],"mappings":"AAEA,OAAO,EAIH,KAAK,cAAc,EAEtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAczE,wBAAgB,wBAAwB,CACpC,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,cAAc,QAmOjC"}

package/dist/services/AllChainsService.js

@@ -13,16 +13,39 @@ export function addAllChainsServiceTools(server, goldRushClient) {
             z.enum(Object.values(ChainName)),
             z.number(),
         ]))
-            .optional(),
-        addresses: z.array(z.string()).optional(),
-        limit: z.number().optional().default(10),
-        before: z.string().optional(),
-        after: z.string().optional(),
-        withLogs: z.boolean().optional().default(false),
-        withDecodedLogs: z.boolean().optional().default(false),
+            .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))
-            .optional(),
+            .optional()
+            .describe("Currency to quote token values in (e.g., 'USD', 'EUR'). If not specified, uses default quote currency."),
     }, async (params) => {
         try {
             const response = await goldRushClient.AllChainsService.getMultiChainMultiAddressTransactions({
@@ -56,19 +79,33 @@ export function addAllChainsServiceTools(server, goldRushClient) {
         "quoteCurrency for value conversion, limit (default 10), pagination (before), " +
         "and cutoffTimestamp to filter by time. " +
         "Use this to get a comprehensive view of token holdings across different blockchains.", {
-        walletAddress: z.string(),
+        walletAddress: z
+            .string()
+            .describe("The wallet address to get token balances for. Must be a valid blockchain address."),
         quoteCurrency: z
             .enum(Object.values(validQuoteValues))
-            .optional(),
-        before: z.string().optional(),
-        limit: z.number().optional().default(10),
+            .optional()
+            .describe("Currency to quote token values in (e.g., 'USD', 'EUR'). If not specified, uses default quote currency."),
+        before: z
+            .string()
+            .optional()
+            .describe("Pagination cursor to get balances before this point. Use the 'before' value from previous response."),
+        limit: z
+            .number()
+            .optional()
+            .default(10)
+            .describe("Maximum number of token balances to return. Default is 10, maximum is 100."),
         chains: z
             .array(z.union([
             z.enum(Object.values(ChainName)),
             z.number(),
         ]))
-            .optional(),
-        cutoffTimestamp: z.number().optional(),
+            .optional()
+            .describe("Array of blockchain networks to query balances from. Can be chain names or chain IDs. If not specified, queries all supported chains."),
+        cutoffTimestamp: z
+            .number()
+            .optional()
+            .describe("Unix timestamp to filter balances by last activity. Only returns tokens with activity after this time."),
     }, async (params) => {
         try {
             const response = await goldRushClient.AllChainsService.getMultiChainBalances(params.walletAddress, {
@@ -99,8 +136,14 @@ export function addAllChainsServiceTools(server, goldRushClient) {
         "determines whether to include testnet activity. " +
         "Returns a comprehensive summary of chain activity including transaction counts, " +
         "first/last activity timestamps, and activity status across all networks.", {
-        walletAddress: z.string(),
-        testnets: z.boolean().optional().default(false),
+        walletAddress: z
+            .string()
+            .describe("The wallet address to analyze activity for. Must be a valid blockchain address."),
+        testnets: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Whether to include testnet activity in the analysis. Default is false (mainnet only)."),
     }, async (params) => {
         try {
             const response = await goldRushClient.AllChainsService.getAddressActivity(params.walletAddress, { testnets: params.testnets });

package/dist/services/AllChainsService.js.map

@@ -1 +1 @@
-{"version":3,"file":"AllChainsService.js","sourceRoot":"","sources":["../../src/services/AllChainsService.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AllChainsService.js","sourceRoot":"","sources":["../../src/services/AllChainsService.ts"],"names":[],"mappings":"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"}

package/dist/services/BalanceService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BalanceService.d.ts","sourceRoot":"","sources":["../../src/services/BalanceService.ts"],"names":[],"mappings":"AAEA,OAAO,EAGH,KAAK,cAAc,EAEtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkBzE,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,cAAc,QAuSjC"}
+{"version":3,"file":"BalanceService.d.ts","sourceRoot":"","sources":["../../src/services/BalanceService.ts"],"names":[],"mappings":"AAEA,OAAO,EAGH,KAAK,cAAc,EAEtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkBzE,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,cAAc,QA4cjC"}

package/dist/services/BalanceService.js

@@ -8,15 +8,36 @@ export function addBalanceServiceTools(server, goldRushClient) {
         "Optional: quoteCurrency for value conversion, nft (include NFTs, default false), " +
         "noNftFetch, noSpam, and noNftAssetMetadata (all default true) to control data returned. " +
         "Returns detailed token balance information including spot prices and metadata.", {
-        chainName: z.enum(Object.values(ChainName)),
-        address: z.string(),
+        chainName: z
+            .enum(Object.values(ChainName))
+            .describe("The blockchain network to query (e.g., 'eth-mainnet', 'matic-mainnet', 'bsc-mainnet')."),
+        address: z
+            .string()
+            .describe("The wallet address to get token balances for. Must be a valid blockchain address."),
         quoteCurrency: z
             .enum(Object.values(validQuoteValues))
-            .optional(),
-        nft: z.boolean().optional().default(false),
-        noNftFetch: z.boolean().optional().default(true),
-        noSpam: z.boolean().optional().default(true),
-        noNftAssetMetadata: z.boolean().optional().default(true),
+            .optional()
+            .describe("Currency to quote token values in (e.g., 'USD', 'EUR'). If not specified, uses default quote currency."),
+        nft: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Include NFT token balances in the response. Default is false."),
+        noNftFetch: z
+            .boolean()
+            .optional()
+            .default(true)
+            .describe("Skip fetching NFT metadata. Default is true for better performance."),
+        noSpam: z
+            .boolean()
+            .optional()
+            .default(true)
+            .describe("Filter out spam/scam tokens from results. Default is true."),
+        noNftAssetMetadata: z
+            .boolean()
+            .optional()
+            .default(true)
+            .describe("Skip fetching NFT asset metadata. Default is true for better performance."),
     }, async (params) => {
         try {
             const response = await goldRushClient.BalanceService.getTokenBalancesForWalletAddress(params.chainName, params.address, {
@@ -47,17 +68,44 @@ export function addBalanceServiceTools(server, goldRushClient) {
         "Optional: quoteCurrency for value conversion, blockHeight or date to specify point in time, " +
         "nft (include NFTs, default false), noNftFetch, noSpam, and noNftAssetMetadata (all default true). " +
         "Returns token balances as they existed at the specified historical point.", {
-        chainName: z.enum(Object.values(ChainName)),
-        address: z.string(),
+        chainName: z
+            .enum(Object.values(ChainName))
+            .describe("The blockchain network to query (e.g., 'eth-mainnet', 'matic-mainnet', 'bsc-mainnet')."),
+        address: z
+            .string()
+            .describe("The wallet address to get historical token balances for. Must be a valid blockchain address."),
         quoteCurrency: z
             .enum(Object.values(validQuoteValues))
-            .optional(),
-        nft: z.boolean().optional().default(false),
-        noNftFetch: z.boolean().optional().default(true),
-        noSpam: z.boolean().optional().default(true),
-        noNftAssetMetadata: z.boolean().optional().default(true),
-        blockHeight: z.number().optional(),
-        date: z.string().optional(),
+            .optional()
+            .describe("Currency to quote token values in (e.g., 'USD', 'EUR'). If not specified, uses default quote currency."),
+        nft: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Include NFT token balances in the response. Default is false."),
+        noNftFetch: z
+            .boolean()
+            .optional()
+            .default(true)
+            .describe("Skip fetching NFT metadata. Default is true for better performance."),
+        noSpam: z
+            .boolean()
+            .optional()
+            .default(true)
+            .describe("Filter out spam/scam tokens from results. Default is true."),
+        noNftAssetMetadata: z
+            .boolean()
+            .optional()
+            .default(true)
+            .describe("Skip fetching NFT asset metadata. Default is true for better performance."),
+        blockHeight: z
+            .number()
+            .optional()
+            .describe("Specific block height to get historical balances from. Cannot be used with date parameter."),
+        date: z
+            .string()
+            .optional()
+            .describe("Specific date to get historical balances from (YYYY-MM-DD format). Cannot be used with blockHeight parameter."),
     }, async (params) => {
         try {
             const response = await goldRushClient.BalanceService.getHistoricalTokenBalancesForWalletAddress(params.chainName, params.address, {
@@ -89,12 +137,21 @@ export function addBalanceServiceTools(server, goldRushClient) {
         "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)),
-        walletAddress: z.string(),
+        chainName: z
+            .enum(Object.values(ChainName))
+            .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. Must be a valid blockchain address."),
         quoteCurrency: z
             .enum(Object.values(validQuoteValues))
-            .optional(),
-        days: z.number().optional().default(7),
+            .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."),
     }, async (params) => {
         try {
             const response = await goldRushClient.BalanceService.getHistoricalPortfolioForWalletAddress(params.chainName, params.walletAddress, {
@@ -122,16 +179,38 @@ export function addBalanceServiceTools(server, goldRushClient) {
         "Optional: quoteCurrency for value conversion, contractAddress to filter by specific token, " +
         "startingBlock/endingBlock to set range, pageSize (default 10) and pageNumber (default 0). " +
         "Returns token transfer events with timestamps, values, and transaction details.", {
-        chainName: z.enum(Object.values(ChainName)),
-        walletAddress: z.string(),
+        chainName: z
+            .enum(Object.values(ChainName))
+            .describe("The blockchain network to query (e.g., 'eth-mainnet', 'matic-mainnet', 'bsc-mainnet')."),
+        walletAddress: z
+            .string()
+            .describe("The wallet address to get ERC20 transfers for. Must be a valid blockchain address."),
         quoteCurrency: z
             .enum(Object.values(validQuoteValues))
-            .optional(),
-        contractAddress: z.string().nullable(),
-        startingBlock: z.number().optional(),
-        endingBlock: z.number().optional(),
-        pageSize: z.number().optional().default(10),
-        pageNumber: z.number().optional().default(0),
+            .optional()
+            .describe("Currency to quote transfer values in (e.g., 'USD', 'EUR'). If not specified, uses default quote currency."),
+        contractAddress: z
+            .string()
+            .nullable()
+            .describe("Specific ERC20 token contract address to filter transfers. If null, returns transfers for all ERC20 tokens."),
+        startingBlock: z
+            .number()
+            .optional()
+            .describe("Starting block number to begin search from. Use with endingBlock to define a range."),
+        endingBlock: z
+            .number()
+            .optional()
+            .describe("Ending block number to search until. Use with startingBlock to define a range."),
+        pageSize: z
+            .number()
+            .optional()
+            .default(10)
+            .describe("Number of transfers 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.BalanceService.getErc20TransfersForWalletAddressByPage(params.chainName, params.walletAddress, {
@@ -162,12 +241,28 @@ export function addBalanceServiceTools(server, goldRushClient) {
         "Required: chainName (blockchain network), tokenAddress (token contract address). " +
         "Optional: blockHeight or date for historical data, pageSize and pageNumber for pagination. " +
         "Returns list of addresses holding the token with balance amounts and ownership percentages.", {
-        chainName: z.enum(Object.values(ChainName)),
-        tokenAddress: z.string(),
-        blockHeight: z.union([z.string(), z.number()]).optional(),
-        date: z.string().optional(),
-        pageSize: z.number().optional(),
-        pageNumber: z.number().optional(),
+        chainName: z
+            .enum(Object.values(ChainName))
+            .describe("The blockchain network to query (e.g., 'eth-mainnet', 'matic-mainnet', 'bsc-mainnet')."),
+        tokenAddress: z
+            .string()
+            .describe("The token contract address to get holders for. Must be a valid ERC20 or ERC721 contract address."),
+        blockHeight: z
+            .union([z.string(), z.number()])
+            .optional()
+            .describe("Specific block height to get historical token holders from. Cannot be used with date parameter."),
+        date: z
+            .string()
+            .optional()
+            .describe("Specific date to get historical token holders from (YYYY-MM-DD format). Cannot be used with blockHeight parameter."),
+        pageSize: z
+            .number()
+            .optional()
+            .describe("Number of token holders to return per page. Maximum is 100."),
+        pageNumber: z
+            .number()
+            .optional()
+            .describe("Page number for pagination, starting from 0."),
     }, async (params) => {
         try {
             const response = await goldRushClient.BalanceService.getTokenHoldersV2ForTokenAddressByPage(params.chainName, params.tokenAddress, {
@@ -196,12 +291,20 @@ export function addBalanceServiceTools(server, goldRushClient) {
         "Required: chainName (blockchain network), walletAddress (wallet address). " +
         "Optional: quoteCurrency for value conversion, blockHeight for historical balance. " +
         "Returns native token balance with current market value and token metadata.", {
-        chainName: z.enum(Object.values(ChainName)),
-        walletAddress: z.string(),
+        chainName: z
+            .enum(Object.values(ChainName))
+            .describe("The blockchain network to query (e.g., 'eth-mainnet', 'matic-mainnet', 'bsc-mainnet')."),
+        walletAddress: z
+            .string()
+            .describe("The wallet address to get native token balance for. Must be a valid blockchain address."),
         quoteCurrency: z
             .enum(Object.values(validQuoteValues))
-            .optional(),
-        blockHeight: z.union([z.string(), z.number()]).optional(),
+            .optional()
+            .describe("Currency to quote native token value in (e.g., 'USD', 'EUR'). If not specified, uses default quote currency."),
+        blockHeight: z
+            .union([z.string(), z.number()])
+            .optional()
+            .describe("Specific block height to get historical native token balance from."),
     }, async (params) => {
         try {
             const response = await goldRushClient.BalanceService.getNativeTokenBalance(params.chainName, params.walletAddress, {