web3-tools-mcp 1.3.0 → 1.3.1

package/README.md

@@ -6,6 +6,8 @@ A Model Context Protocol (MCP) server for blockchain interactions using [viem](h
 
 - Multi-chain support (Ethereum, Arbitrum, Avalanche, Base, BNB Chain, Gnosis, Sonic, Optimism, Polygon, zkSync Era, Linea, Unichain)
 - Smart contract interactions (read functions, ABI retrieval, source code)
+- Contract simulation & gas estimation (simulate transactions, estimate costs)
+- Real-time gas price tracking (legacy & EIP-1559)
 - ENS resolution (names ↔ addresses, text records, avatars)
 - Token balances (native & ERC20, batch queries)
 - Event log queries with Hypersync acceleration
@@ -94,6 +96,11 @@ npx web3-tools-mcp
 ### Contract Interaction
 - `call_contract_function` - Call view/pure functions (supports batch)
 
+### Gas & Simulation
+- `simulate_contract` - Simulate contract calls without broadcasting (includes gas estimate)
+- `estimate_gas` - Estimate gas cost for any transaction
+- `get_gas_price` - Get current gas prices (legacy & EIP-1559)
+
 ### ENS
 - `resolve_ens_name` - ENS name → address
 - `reverse_resolve_ens` - Address → ENS name

package/dist/tools/gas.d.ts

@@ -0,0 +1,99 @@
+import { z } from "zod";
+declare const _default: {
+    simulate_contract: {
+        title: string;
+        description: string;
+        schema: z.ZodObject<{
+            chain: z.ZodEnum<["mainnet", "arbitrum", "avalanche", "base", "bnb", "gnosis", "sonic", "optimism", "polygon", "zksync", "linea", "unichain", "localhost"]>;
+            contractAddress: z.ZodString;
+            functionAbi: z.ZodString;
+            args: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, "many">>;
+            from: z.ZodOptional<z.ZodString>;
+            value: z.ZodOptional<z.ZodString>;
+            blockNumber: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            contractAddress: string;
+            functionAbi: string;
+            blockNumber?: string | undefined;
+            from?: string | undefined;
+            value?: string | undefined;
+            args?: (string | number | boolean | null)[] | undefined;
+        }, {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            contractAddress: string;
+            functionAbi: string;
+            blockNumber?: string | undefined;
+            from?: string | undefined;
+            value?: string | undefined;
+            args?: (string | number | boolean | null)[] | undefined;
+        }>;
+        handler: (args: {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            contractAddress: string;
+            functionAbi: string;
+            blockNumber?: string | undefined;
+            from?: string | undefined;
+            value?: string | undefined;
+            args?: (string | number | boolean | null)[] | undefined;
+        }) => Promise<import("../types.js").ToolResult>;
+    };
+    estimate_gas: {
+        title: string;
+        description: string;
+        schema: z.ZodObject<{
+            chain: z.ZodEnum<["mainnet", "arbitrum", "avalanche", "base", "bnb", "gnosis", "sonic", "optimism", "polygon", "zksync", "linea", "unichain", "localhost"]>;
+            to: z.ZodOptional<z.ZodString>;
+            from: z.ZodOptional<z.ZodString>;
+            value: z.ZodOptional<z.ZodString>;
+            data: z.ZodOptional<z.ZodString>;
+            functionAbi: z.ZodOptional<z.ZodString>;
+            args: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            from?: string | undefined;
+            to?: string | undefined;
+            value?: string | undefined;
+            data?: string | undefined;
+            args?: (string | number | boolean | null)[] | undefined;
+            functionAbi?: string | undefined;
+        }, {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            from?: string | undefined;
+            to?: string | undefined;
+            value?: string | undefined;
+            data?: string | undefined;
+            args?: (string | number | boolean | null)[] | undefined;
+            functionAbi?: string | undefined;
+        }>;
+        handler: (args: {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            from?: string | undefined;
+            to?: string | undefined;
+            value?: string | undefined;
+            data?: string | undefined;
+            args?: (string | number | boolean | null)[] | undefined;
+            functionAbi?: string | undefined;
+        }) => Promise<import("../types.js").ToolResult>;
+    };
+    get_gas_price: {
+        title: string;
+        description: string;
+        schema: z.ZodObject<{
+            chain: z.ZodEnum<["mainnet", "arbitrum", "avalanche", "base", "bnb", "gnosis", "sonic", "optimism", "polygon", "zksync", "linea", "unichain", "localhost"]>;
+            formatted: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, "strip", z.ZodTypeAny, {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            formatted: boolean;
+        }, {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            formatted?: boolean | undefined;
+        }>;
+        handler: (args: {
+            chain: "mainnet" | "arbitrum" | "avalanche" | "base" | "bnb" | "gnosis" | "sonic" | "optimism" | "polygon" | "zksync" | "linea" | "unichain" | "localhost";
+            formatted: boolean;
+        }) => Promise<import("../types.js").ToolResult>;
+    };
+};
+export default _default;
+//# sourceMappingURL=gas.d.ts.map

package/dist/tools/gas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gas.d.ts","sourceRoot":"","sources":["../../src/tools/gas.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKxB,wBAoQE"}

package/dist/tools/gas.js

@@ -0,0 +1,229 @@
+import { isAddress, parseAbiItem, encodeFunctionData, decodeFunctionResult } from "viem";
+import { z } from "zod";
+import { getClientManager, SUPPORTED_CHAINS } from "../client.js";
+import { convertArgumentsToTypes, createTool, formatResponse } from "../utils.js";
+export default {
+    simulate_contract: createTool("Simulate Contract Call", "Simulate a contract call (including state-changing functions) without broadcasting. Returns simulation result and estimated gas.", z.object({
+        chain: z
+            .enum(SUPPORTED_CHAINS)
+            .describe("Blockchain network to simulate on"),
+        contractAddress: z
+            .string()
+            .describe("Contract address to call"),
+        functionAbi: z
+            .string()
+            .describe('Function ABI signature (e.g., "function transfer(address to, uint256 amount)"). Can be any function type.'),
+        args: z
+            .array(z.union([z.string(), z.number(), z.boolean(), z.null()]))
+            .optional()
+            .describe("Function arguments in order matching the ABI signature"),
+        from: z
+            .string()
+            .optional()
+            .describe("Sender address (defaults to zero address)"),
+        value: z
+            .string()
+            .optional()
+            .describe("ETH value to send with the transaction (in wei as string)"),
+        blockNumber: z
+            .string()
+            .optional()
+            .describe("Block number for simulation (defaults to latest)"),
+    }), async (args) => {
+        if (!isAddress(args.contractAddress)) {
+            throw new Error(`Invalid contract address: ${args.contractAddress}`);
+        }
+        if (args.from && !isAddress(args.from)) {
+            throw new Error(`Invalid from address: ${args.from}`);
+        }
+        const clientManager = getClientManager();
+        const client = clientManager.getClient(args.chain);
+        try {
+            const abiItem = parseAbiItem(args.functionAbi);
+            const convertedArgs = convertArgumentsToTypes(args.args || [], abiItem.inputs);
+            const blockTag = args.blockNumber ? BigInt(args.blockNumber) : undefined;
+            // Simulate the call
+            const result = await client.call({
+                to: args.contractAddress,
+                data: encodeFunctionData({
+                    abi: [abiItem],
+                    functionName: abiItem.name,
+                    args: convertedArgs,
+                }),
+                account: args.from ? args.from : undefined,
+                value: args.value ? BigInt(args.value) : undefined,
+                blockNumber: blockTag,
+            });
+            // Also estimate gas
+            const gasEstimate = await client.estimateGas({
+                to: args.contractAddress,
+                data: encodeFunctionData({
+                    abi: [abiItem],
+                    functionName: abiItem.name,
+                    args: convertedArgs,
+                }),
+                account: args.from ? args.from : undefined,
+                value: args.value ? BigInt(args.value) : undefined,
+                blockNumber: blockTag,
+            });
+            // Decode the result if the function has outputs
+            let decodedResult = result.data;
+            if (abiItem.outputs && abiItem.outputs.length > 0 && result.data) {
+                decodedResult = decodeFunctionResult({
+                    abi: [abiItem],
+                    functionName: abiItem.name,
+                    data: result.data,
+                });
+            }
+            return formatResponse({
+                success: true,
+                chain: args.chain,
+                contractAddress: args.contractAddress,
+                functionName: abiItem.name,
+                result: decodedResult,
+                rawData: result.data,
+                gasEstimate: gasEstimate.toString(),
+                blockNumber: args.blockNumber || "latest",
+            });
+        }
+        catch (error) {
+            // Check if it's a revert error
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return formatResponse({
+                success: false,
+                chain: args.chain,
+                contractAddress: args.contractAddress,
+                error: errorMessage,
+                reverted: errorMessage.includes("revert") || errorMessage.includes("execution reverted"),
+            });
+        }
+    }),
+    estimate_gas: createTool("Estimate Gas", "Estimate gas required for a transaction. Supports contract calls, transfers, and deployments.", z.object({
+        chain: z
+            .enum(SUPPORTED_CHAINS)
+            .describe("Blockchain network"),
+        to: z
+            .string()
+            .optional()
+            .describe("Recipient address (omit for contract deployment)"),
+        from: z
+            .string()
+            .optional()
+            .describe("Sender address (optional)"),
+        value: z
+            .string()
+            .optional()
+            .describe("ETH value to send (in wei as string)"),
+        data: z
+            .string()
+            .optional()
+            .describe("Transaction data (hex string for contract calls or deployment bytecode)"),
+        functionAbi: z
+            .string()
+            .optional()
+            .describe("Optional: Function ABI signature to encode call data automatically"),
+        args: z
+            .array(z.union([z.string(), z.number(), z.boolean(), z.null()]))
+            .optional()
+            .describe("Optional: Function arguments (only used with functionAbi)"),
+    }), async (args) => {
+        if (args.to && !isAddress(args.to)) {
+            throw new Error(`Invalid to address: ${args.to}`);
+        }
+        if (args.from && !isAddress(args.from)) {
+            throw new Error(`Invalid from address: ${args.from}`);
+        }
+        const clientManager = getClientManager();
+        const client = clientManager.getClient(args.chain);
+        try {
+            let callData = args.data;
+            // If functionAbi is provided, encode the call data
+            if (args.functionAbi) {
+                const abiItem = parseAbiItem(args.functionAbi);
+                const convertedArgs = convertArgumentsToTypes(args.args || [], abiItem.inputs);
+                callData = encodeFunctionData({
+                    abi: [abiItem],
+                    functionName: abiItem.name,
+                    args: convertedArgs,
+                });
+            }
+            const gasEstimate = await client.estimateGas({
+                to: args.to ? args.to : undefined,
+                account: args.from ? args.from : undefined,
+                value: args.value ? BigInt(args.value) : undefined,
+                data: callData,
+            });
+            return formatResponse({
+                success: true,
+                chain: args.chain,
+                gasEstimate: gasEstimate.toString(),
+                to: args.to,
+                from: args.from,
+                value: args.value,
+            });
+        }
+        catch (error) {
+            throw new Error(`Gas estimation failed: ${error}`);
+        }
+    }),
+    get_gas_price: createTool("Get Gas Price", "Get current gas prices for a chain. Returns both legacy gasPrice and EIP-1559 fees (maxFeePerGas, maxPriorityFeePerGas).", z.object({
+        chain: z
+            .enum(SUPPORTED_CHAINS)
+            .describe("Blockchain network"),
+        formatted: z
+            .boolean()
+            .optional()
+            .default(true)
+            .describe("Return prices in Gwei (default: true). If false, returns wei."),
+    }), async (args) => {
+        const clientManager = getClientManager();
+        const client = clientManager.getClient(args.chain);
+        try {
+            // Get both legacy and EIP-1559 gas prices
+            const [gasPrice, feeData] = await Promise.all([
+                client.getGasPrice(),
+                client.estimateFeesPerGas().catch(() => null), // Some chains don't support EIP-1559
+            ]);
+            const formatPrice = (wei) => {
+                if (args.formatted) {
+                    // Convert to Gwei (1 Gwei = 1e9 wei)
+                    const gwei = Number(wei) / 1e9;
+                    return `${gwei.toFixed(2)} Gwei`;
+                }
+                return wei.toString();
+            };
+            const response = {
+                chain: args.chain,
+                timestamp: new Date().toISOString(),
+                legacy: {
+                    gasPrice: args.formatted ? formatPrice(gasPrice) : gasPrice.toString(),
+                    gasPriceWei: gasPrice.toString(),
+                },
+            };
+            // Add EIP-1559 data if available
+            if (feeData) {
+                response.eip1559 = {
+                    maxFeePerGas: args.formatted
+                        ? formatPrice(feeData.maxFeePerGas)
+                        : feeData.maxFeePerGas.toString(),
+                    maxPriorityFeePerGas: args.formatted
+                        ? formatPrice(feeData.maxPriorityFeePerGas)
+                        : feeData.maxPriorityFeePerGas.toString(),
+                    maxFeePerGasWei: feeData.maxFeePerGas.toString(),
+                    maxPriorityFeePerGasWei: feeData.maxPriorityFeePerGas.toString(),
+                };
+                // Calculate estimated total cost for a standard 21000 gas transaction
+                const standardGasLimit = 21000n;
+                const estimatedCost = feeData.maxFeePerGas * standardGasLimit;
+                response.eip1559.estimatedCostFor21kGas = args.formatted
+                    ? `${(Number(estimatedCost) / 1e18).toFixed(6)} ETH`
+                    : estimatedCost.toString();
+            }
+            return formatResponse(response);
+        }
+        catch (error) {
+            throw new Error(`Failed to get gas price: ${error}`);
+        }
+    }),
+};
+//# sourceMappingURL=gas.js.map

package/dist/tools/gas.js.map

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

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAsBnE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,QAcjD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAwBnE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,QAcjD"}

package/dist/tools/index.js

@@ -3,6 +3,7 @@ import balanceTools from './balance.js';
 import contractTools from './contract.js';
 import contractInfoTools from './contract-info.js';
 import ensTools from './ens.js';
+import gasTools from './gas.js';
 import logTools from './logs.js';
 import signatureTools from './signatures.js';
 const allToolDefinitions = {
@@ -12,7 +13,8 @@ const allToolDefinitions = {
     ...balanceTools,
     ...logTools,
     ...advancedTools,
-    ...ensTools
+    ...ensTools,
+    ...gasTools
 };
 // Register all tools with the MCP server
 export function registerAllTools(server) {

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAGA,OAAO,aAAa,MAAM,eAAe,CAAA;AACzC,OAAO,YAAY,MAAM,cAAc,CAAA;AACvC,OAAO,aAAa,MAAM,eAAe,CAAA;AACzC,OAAO,iBAAiB,MAAM,oBAAoB,CAAA;AAClD,OAAO,QAAQ,MAAM,UAAU,CAAA;AAC/B,OAAO,QAAQ,MAAM,WAAW,CAAA;AAChC,OAAO,cAAc,MAAM,iBAAiB,CAAA;AAE5C,MAAM,kBAAkB,GAAG;IACzB,GAAG,cAAc;IACjB,GAAG,aAAa;IAChB,GAAG,iBAAiB;IACpB,GAAG,YAAY;IACf,GAAG,QAAQ;IACX,GAAG,aAAa;IAChB,GAAG,QAAQ;CACH,CAAA;AAEV,yCAAyC;AACzC,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;QAC1D,MAAM,CAAC,YAAY,CACjB,IAAI,EACJ;YACE,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;SAC/B,EACD,KAAK,EAAE,IAAS,EAAE,MAA8D,EAAE,EAAE;YAClF,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACjC,CAAC,CACF,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAGA,OAAO,aAAa,MAAM,eAAe,CAAA;AACzC,OAAO,YAAY,MAAM,cAAc,CAAA;AACvC,OAAO,aAAa,MAAM,eAAe,CAAA;AACzC,OAAO,iBAAiB,MAAM,oBAAoB,CAAA;AAClD,OAAO,QAAQ,MAAM,UAAU,CAAA;AAC/B,OAAO,QAAQ,MAAM,UAAU,CAAA;AAC/B,OAAO,QAAQ,MAAM,WAAW,CAAA;AAChC,OAAO,cAAc,MAAM,iBAAiB,CAAA;AAE5C,MAAM,kBAAkB,GAAG;IACzB,GAAG,cAAc;IACjB,GAAG,aAAa;IAChB,GAAG,iBAAiB;IACpB,GAAG,YAAY;IACf,GAAG,QAAQ;IACX,GAAG,aAAa;IAChB,GAAG,QAAQ;IACX,GAAG,QAAQ;CACH,CAAA;AAEV,yCAAyC;AACzC,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;QAC1D,MAAM,CAAC,YAAY,CACjB,IAAI,EACJ;YACE,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;SAC/B,EACD,KAAK,EAAE,IAAS,EAAE,MAA8D,EAAE,EAAE;YAClF,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACjC,CAAC,CACF,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "web3-tools-mcp",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Model Context Protocol server for blockchain interactions using viem, Etherscan, and Hypersync",
   "type": "module",
   "main": "dist/index.js",

package/src/tools/gas.ts

@@ -0,0 +1,267 @@
+import { type AbiFunction, type Address, isAddress, parseAbiItem, encodeFunctionData, decodeFunctionResult } from "viem";
+import { z } from "zod";
+import type { ChainName } from "../types.js";
+import { getClientManager, SUPPORTED_CHAINS } from "../client.js";
+import { convertArgumentsToTypes, createTool, formatResponse } from "../utils.js";
+
+export default {
+  simulate_contract: createTool(
+    "Simulate Contract Call",
+    "Simulate a contract call (including state-changing functions) without broadcasting. Returns simulation result and estimated gas.",
+    z.object({
+      chain: z
+        .enum(SUPPORTED_CHAINS)
+        .describe("Blockchain network to simulate on"),
+      contractAddress: z
+        .string()
+        .describe("Contract address to call"),
+      functionAbi: z
+        .string()
+        .describe(
+          'Function ABI signature (e.g., "function transfer(address to, uint256 amount)"). Can be any function type.'
+        ),
+      args: z
+        .array(z.union([z.string(), z.number(), z.boolean(), z.null()]))
+        .optional()
+        .describe("Function arguments in order matching the ABI signature"),
+      from: z
+        .string()
+        .optional()
+        .describe("Sender address (defaults to zero address)"),
+      value: z
+        .string()
+        .optional()
+        .describe("ETH value to send with the transaction (in wei as string)"),
+      blockNumber: z
+        .string()
+        .optional()
+        .describe("Block number for simulation (defaults to latest)"),
+    }),
+    async (args) => {
+      if (!isAddress(args.contractAddress)) {
+        throw new Error(`Invalid contract address: ${args.contractAddress}`);
+      }
+
+      if (args.from && !isAddress(args.from)) {
+        throw new Error(`Invalid from address: ${args.from}`);
+      }
+
+      const clientManager = getClientManager();
+      const client = clientManager.getClient(args.chain as ChainName);
+
+      try {
+        const abiItem = parseAbiItem(args.functionAbi) as AbiFunction;
+        const convertedArgs = convertArgumentsToTypes(args.args || [], abiItem.inputs);
+
+        const blockTag = args.blockNumber ? BigInt(args.blockNumber) : undefined;
+
+        // Simulate the call
+        const result = await client.call({
+          to: args.contractAddress as Address,
+          data: encodeFunctionData({
+            abi: [abiItem],
+            functionName: abiItem.name,
+            args: convertedArgs,
+          }),
+          account: args.from ? (args.from as Address) : undefined,
+          value: args.value ? BigInt(args.value) : undefined,
+          blockNumber: blockTag,
+        });
+
+        // Also estimate gas
+        const gasEstimate = await client.estimateGas({
+          to: args.contractAddress as Address,
+          data: encodeFunctionData({
+            abi: [abiItem],
+            functionName: abiItem.name,
+            args: convertedArgs,
+          }),
+          account: args.from ? (args.from as Address) : undefined,
+          value: args.value ? BigInt(args.value) : undefined,
+          blockNumber: blockTag,
+        });
+
+        // Decode the result if the function has outputs
+        let decodedResult: unknown = result.data;
+        if (abiItem.outputs && abiItem.outputs.length > 0 && result.data) {
+          decodedResult = decodeFunctionResult({
+            abi: [abiItem],
+            functionName: abiItem.name,
+            data: result.data,
+          });
+        }
+
+        return formatResponse({
+          success: true,
+          chain: args.chain,
+          contractAddress: args.contractAddress,
+          functionName: abiItem.name,
+          result: decodedResult,
+          rawData: result.data,
+          gasEstimate: gasEstimate.toString(),
+          blockNumber: args.blockNumber || "latest",
+        });
+      } catch (error) {
+        // Check if it's a revert error
+        const errorMessage = error instanceof Error ? error.message : String(error);
+
+        return formatResponse({
+          success: false,
+          chain: args.chain,
+          contractAddress: args.contractAddress,
+          error: errorMessage,
+          reverted: errorMessage.includes("revert") || errorMessage.includes("execution reverted"),
+        });
+      }
+    }
+  ),
+
+  estimate_gas: createTool(
+    "Estimate Gas",
+    "Estimate gas required for a transaction. Supports contract calls, transfers, and deployments.",
+    z.object({
+      chain: z
+        .enum(SUPPORTED_CHAINS)
+        .describe("Blockchain network"),
+      to: z
+        .string()
+        .optional()
+        .describe("Recipient address (omit for contract deployment)"),
+      from: z
+        .string()
+        .optional()
+        .describe("Sender address (optional)"),
+      value: z
+        .string()
+        .optional()
+        .describe("ETH value to send (in wei as string)"),
+      data: z
+        .string()
+        .optional()
+        .describe("Transaction data (hex string for contract calls or deployment bytecode)"),
+      functionAbi: z
+        .string()
+        .optional()
+        .describe("Optional: Function ABI signature to encode call data automatically"),
+      args: z
+        .array(z.union([z.string(), z.number(), z.boolean(), z.null()]))
+        .optional()
+        .describe("Optional: Function arguments (only used with functionAbi)"),
+    }),
+    async (args) => {
+      if (args.to && !isAddress(args.to)) {
+        throw new Error(`Invalid to address: ${args.to}`);
+      }
+
+      if (args.from && !isAddress(args.from)) {
+        throw new Error(`Invalid from address: ${args.from}`);
+      }
+
+      const clientManager = getClientManager();
+      const client = clientManager.getClient(args.chain as ChainName);
+
+      try {
+        let callData = args.data;
+
+        // If functionAbi is provided, encode the call data
+        if (args.functionAbi) {
+          const abiItem = parseAbiItem(args.functionAbi) as AbiFunction;
+          const convertedArgs = convertArgumentsToTypes(args.args || [], abiItem.inputs);
+          callData = encodeFunctionData({
+            abi: [abiItem],
+            functionName: abiItem.name,
+            args: convertedArgs,
+          });
+        }
+
+        const gasEstimate = await client.estimateGas({
+          to: args.to ? (args.to as Address) : undefined,
+          account: args.from ? (args.from as Address) : undefined,
+          value: args.value ? BigInt(args.value) : undefined,
+          data: callData as `0x${string}` | undefined,
+        });
+
+        return formatResponse({
+          success: true,
+          chain: args.chain,
+          gasEstimate: gasEstimate.toString(),
+          to: args.to,
+          from: args.from,
+          value: args.value,
+        });
+      } catch (error) {
+        throw new Error(`Gas estimation failed: ${error}`);
+      }
+    }
+  ),
+
+  get_gas_price: createTool(
+    "Get Gas Price",
+    "Get current gas prices for a chain. Returns both legacy gasPrice and EIP-1559 fees (maxFeePerGas, maxPriorityFeePerGas).",
+    z.object({
+      chain: z
+        .enum(SUPPORTED_CHAINS)
+        .describe("Blockchain network"),
+      formatted: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe("Return prices in Gwei (default: true). If false, returns wei."),
+    }),
+    async (args) => {
+      const clientManager = getClientManager();
+      const client = clientManager.getClient(args.chain as ChainName);
+
+      try {
+        // Get both legacy and EIP-1559 gas prices
+        const [gasPrice, feeData] = await Promise.all([
+          client.getGasPrice(),
+          client.estimateFeesPerGas().catch(() => null), // Some chains don't support EIP-1559
+        ]);
+
+        const formatPrice = (wei: bigint): string => {
+          if (args.formatted) {
+            // Convert to Gwei (1 Gwei = 1e9 wei)
+            const gwei = Number(wei) / 1e9;
+            return `${gwei.toFixed(2)} Gwei`;
+          }
+          return wei.toString();
+        };
+
+        const response: any = {
+          chain: args.chain,
+          timestamp: new Date().toISOString(),
+          legacy: {
+            gasPrice: args.formatted ? formatPrice(gasPrice) : gasPrice.toString(),
+            gasPriceWei: gasPrice.toString(),
+          },
+        };
+
+        // Add EIP-1559 data if available
+        if (feeData) {
+          response.eip1559 = {
+            maxFeePerGas: args.formatted
+              ? formatPrice(feeData.maxFeePerGas)
+              : feeData.maxFeePerGas.toString(),
+            maxPriorityFeePerGas: args.formatted
+              ? formatPrice(feeData.maxPriorityFeePerGas)
+              : feeData.maxPriorityFeePerGas.toString(),
+            maxFeePerGasWei: feeData.maxFeePerGas.toString(),
+            maxPriorityFeePerGasWei: feeData.maxPriorityFeePerGas.toString(),
+          };
+
+          // Calculate estimated total cost for a standard 21000 gas transaction
+          const standardGasLimit = 21000n;
+          const estimatedCost = feeData.maxFeePerGas * standardGasLimit;
+          response.eip1559.estimatedCostFor21kGas = args.formatted
+            ? `${(Number(estimatedCost) / 1e18).toFixed(6)} ETH`
+            : estimatedCost.toString();
+        }
+
+        return formatResponse(response);
+      } catch (error) {
+        throw new Error(`Failed to get gas price: ${error}`);
+      }
+    }
+  ),
+};

package/src/tools/index.ts

@@ -6,6 +6,7 @@ import balanceTools from './balance.js'
 import contractTools from './contract.js'
 import contractInfoTools from './contract-info.js'
 import ensTools from './ens.js'
+import gasTools from './gas.js'
 import logTools from './logs.js'
 import signatureTools from './signatures.js'
 
@@ -16,7 +17,8 @@ const allToolDefinitions = {
   ...balanceTools,
   ...logTools,
   ...advancedTools,
-  ...ensTools
+  ...ensTools,
+  ...gasTools
 } as const
 
 // Register all tools with the MCP server