OpenOcean MCP

Instructions

Implementation Reference

• src/tools/chain.ts:84-106 (handler)

  The handler function that implements the core logic of the GET_TRANSACTION tool. It resolves the chain, uses ChainService to fetch the transaction by hash, and returns the result as JSON.
  export const getTransaction = async (args: z.infer<typeof hashParamsSchema>) => { try { const inputChain = args.chain.toLowerCase(); const chainObject = getChainFromName(inputChain); console.error(`[GET_TRANSACTION] Using chain: ${chainObject.name}`, args); const service = new ChainService(); const tx = await service.getTransaction(chainObject.id, args.hash); if (tx instanceof Error) { return `Error fetching getTransaction: ${tx.message}`; } return JSON.stringify(tx, null, 2); } catch (error: unknown) { const message = error instanceof Error ? error.message : "An unknown error occurred while fetching getTransaction."; console.error(`[GET_TRANSACTION] Error: ${message}`); throw new Error(`Failed to fetch getTransaction: ${message}`); } }
• src/types.ts:14-26 (schema)

  Zod schema defining the input parameters for the GET_TRANSACTION tool: optional chain (defaults to 'fraxtal') and required hash (validated with viem's isHash).
  export const hashParamsSchema = z.object({ chain: z .string() .optional() .describe( "The blockchain network to execute the transaction on. uses fraxtal as default", ) .default("fraxtal"), hash: z .string() .refine(isHash, { message: "Invalid hash" }) .describe("Hash from the OpenOcean contract on the blockchain."), });
• src/tools/index.ts:28-33 (registration)

  Tool object registration in tools/index.ts, defining name, description, input schema, and handler reference.
  getTransaction: { name: "GET_TRANSACTION", description: "Get Transaction", parameters: hashParamsSchema, execute: chainExecute.getTransaction },
• src/index.ts:17-17 (registration)

  Final registration of the GET_TRANSACTION tool to the FastMCP server.
  server.addTool(tools.getTransaction);