Rhumb

Instructions

Implementation Reference

• packages/mcp/src/tools/check-balance.ts:11-33 (handler)

  The main handler function for the check_balance MCP tool. It calls the Rhumb API client to fetch the current balance and formats a response message.

  export async function handleCheckBalance(
    _input: CheckBalanceInput,
    client: RhumbApiClient
  ): Promise<CheckBalanceOutput> {
    try {
      const balance = await client.getBalance();
      return {
        balance_usd: balance.balance_usd,
        balance_usd_cents: balance.balance_usd_cents,
        auto_reload_enabled: balance.auto_reload_enabled,
        message: balance.balance_usd_cents < 100
          ? `⚠️ Low balance: $${balance.balance_usd}. Top up at https://rhumb.dev/pricing`
          : `Balance: $${balance.balance_usd}`,
      };
    } catch (err) {
      return {
        balance_usd: 0,
        balance_usd_cents: 0,
        auto_reload_enabled: false,
        message: `Failed to check balance: ${err instanceof Error ? err.message : String(err)}`,
      };
    }
  }

• packages/mcp/src/types.ts:520-533 (schema)

  Schema and type definitions for the input and output of the check_balance tool.

  export const CheckBalanceInputSchema = {
    type: "object" as const,
    properties: {},
    required: [] as string[],
  };
  
  export type CheckBalanceInput = Record<string, never>;
  
  export type CheckBalanceOutput = {
    balance_usd: number;
    balance_usd_cents: number;
    auto_reload_enabled: boolean;
    message: string;
  };