binance-mcp

Instructions

Implementation Reference

• src/tools/account.ts:13-21 (handler)

  The execute handler for the binance_account_balances tool. It validates input with balancesSchema, calls the binance.account API endpoint with common params, and returns the balances.

  async run(input) {
    balancesSchema.parse(input);
    try {
      const res = await binance.account(withCommonParams({}));
      return res.data?.balances ?? res.data;
    } catch (err) {
      throw toToolError(err);
    }
  }

• src/tools/account.ts:6-6 (schema)

  Zod schema for the tool input parameters (empty object, no params required). Used in parameters and parsed in run.

  const balancesSchema = z.object({});

• src/index.ts:25-40 (registration)

  Registration of the tool (imported as tool_account_balances and included in tools array at line 19) by adding it to the FastMCP server instance via a loop over all tools.

  tools.forEach((tool) => {
    server.addTool({
      name: tool.name,
      description: tool.description,
      parameters: tool.parameters,
      execute: async (args) => {
        try {
          const result = await tool.run(args);
          return JSON.stringify(result, null, 2);
        } catch (error) {
          const handled = error instanceof ToolError ? error : new ToolError((error as Error).message);
          throw handled;
        }
      },
    });
  });

• src/binance/client.ts:16-18 (helper)

  Helper function used in the handler to add recvWindow parameter to API calls.

  export function withCommonParams<T extends Record<string, unknown>>(params: T) {
    return { ...params, recvWindow };
  }

• src/binance/client.ts:14-15 (helper)

  Binance Spot client instance used by the tool handler to make the account API call.

  export const binance = new Spot(apiKey, apiSecret, { baseURL });