Alchemy MCP Server

Implementation Reference

• api/alchemyApi.ts:153-181 (handler)

  The core handler function that sends a transaction by posting to the agent wallet server endpoint with the provided parameters.
  async sendTransaction(params: SendTransactionParams) { const { ownerScaAccountAddress, signerAddress, toAddress, value, callData } = params; try { const response = await fetch(`${AGENT_WALLET_SERVER}/transactions/send`, { method: 'POST', headers: { 'Content-Type': 'application/json', }, body: JSON.stringify({ ownerScaAccountAddress, signerAddress, toAddress, value, callData }) }); if (!response.ok) { const errorData = await response.json(); throw new Error(errorData.error || `HTTP ${response.status}: ${response.statusText}`); } const result = await response.json(); return result.data; } catch (error) { console.error('Error sending transaction:', error); throw error; } },
• types/types.d.ts:73-79 (schema)

  TypeScript interface defining the input parameters for the sendTransaction tool.
  export interface SendTransactionParams { ownerScaAccountAddress: string; signerAddress: string; toAddress: string; value?: string; callData?: string; }
• index.ts:317-342 (registration)

  Registers the sendTransaction tool with the MCP server, providing Zod input schema validation and a wrapper handler that calls the alchemyApi implementation.
  server.tool('sendTransaction', { ownerScaAccountAddress: z.string().describe('The owner SCA account address.'), signerAddress: z.string().describe('The signer address to send the transaction from.'), toAddress: z.string().describe('The address to send the transaction to.'), value: z.string().optional().describe('The value of the transaction in ETH.'), callData: z.string().optional().describe('The data of the transaction.'), }, async (params) => { try { const result = await alchemyApi.sendTransaction(params); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }], }; } catch (error) { if (error instanceof Error) { console.error('Error in sendTransaction:', error); return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true }; } return { content: [{ type: "text", text: 'Unknown error occurred' }], isError: true }; } })