call
Simulate and execute blockchain transactions instantly without network submission. Use contract addresses and encoded data to test calls securely via MetaMask MCP, ensuring private key safety during operations.
Instructions
Executing a new message call immediately without submitting a transaction to the network.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | A contract hashed method call with encoded args. | |
| to | Yes | The contract address or recipient. | |
| value | No | Value (in wei) sent with this transaction. |
Implementation Reference
- src/tools/call.ts:19-53 (handler)The execute handler for the 'call' tool. It calls wagmi's 'call' function with the provided args (to, data, value), returns the result hash on success, or error message on failure.execute: async (args) => { try { const result = await call(wagmiConfig, args); return { content: [ { type: "text", text: JSONStringify({ hash: result, }), }, ], }; } catch (error) { if (error instanceof TransactionExecutionError) { return { content: [ { type: "text", text: error.cause.message, }, ], }; } return { content: [ { type: "text", text: (error as Error).message, }, ], }; } },
- src/tools/call.ts:14-18 (schema)The input schema (parameters) for the 'call' tool defining 'to', 'data', and optional 'value'.parameters: z.object({ to: Address.describe("The contract address or recipient."), data: Calldata.describe("A contract hashed method call with encoded args."), value: z.coerce.bigint().optional().describe("Value (in wei) sent with this transaction."), }),
- src/tools/call.ts:11-54 (registration)The server.addTool call that registers the 'call' tool, including name, description, schema, and handler.server.addTool({ name: "call", description: "Executing a new message call immediately without submitting a transaction to the network.", parameters: z.object({ to: Address.describe("The contract address or recipient."), data: Calldata.describe("A contract hashed method call with encoded args."), value: z.coerce.bigint().optional().describe("Value (in wei) sent with this transaction."), }), execute: async (args) => { try { const result = await call(wagmiConfig, args); return { content: [ { type: "text", text: JSONStringify({ hash: result, }), }, ], }; } catch (error) { if (error instanceof TransactionExecutionError) { return { content: [ { type: "text", text: error.cause.message, }, ], }; } return { content: [ { type: "text", text: (error as Error).message, }, ], }; } }, });
- src/tools/register-tools.ts:33-33 (registration)Invocation of registerCallTools within the main registerTools function to register the 'call' tool.registerCallTools(server, wagmiConfig);
- src/tools/index.ts:1-1 (helper)Export of the call tool registration from index.ts, allowing import in register-tools.ts.export * from "./call";