get_cash_account_statements

Instructions

Implementation Reference

• src/tools/getCashAccountStatements.ts:34-59 (handler)

  The main tool handler function that validates parameters, calls the Brex client to fetch cash account statements, formats the response as JSON, and handles errors.

  registerToolHandler("get_cash_account_statements", async (request: ToolCallRequest) => {
    try {
      const params = validateParams(request.params.arguments);
      const client = getBrexClient();
      const resp = await client.getCashAccountStatements(params.account_id, params.cursor, params.limit);
  
      // Return complete objects without any summarization
      const items = Array.isArray(resp?.items) ? resp.items : [];
  
      return {
        content: [{
          type: "text",
          text: JSON.stringify({
            statements: items,
            meta: {
              count: items.length,
              next_cursor: resp?.next_cursor || undefined
            }
          }, null, 2)
        }]
      };
    } catch (error) {
      logError(`Error in get_cash_account_statements: ${error instanceof Error ? error.message : String(error)}`);
      throw error;
    }
  });

• src/tools/index.ts:222-233 (schema)

  JSON schema definition for the tool input parameters as registered with the MCP server.

    name: "get_cash_account_statements",
    description: "Get cash account statements by account ID. Returns complete statement objects. Example: {\"account_id\":\"cash_acc_123\",\"limit\":5}",
    inputSchema: {
      type: "object",
      properties: {
        account_id: { type: "string", description: "Cash account ID" },
        cursor: { type: "string", description: "Pagination cursor" },
        limit: { type: "number", description: "Items per page (default 50, max 100)" }
      },
      required: ["account_id"]
    }
  },

• src/tools/getCashAccountStatements.ts:33-60 (registration)

  Function that registers the get_cash_account_statements tool handler with the tool registry.

  export function registerGetCashAccountStatements(_server: Server): void {
    registerToolHandler("get_cash_account_statements", async (request: ToolCallRequest) => {
      try {
        const params = validateParams(request.params.arguments);
        const client = getBrexClient();
        const resp = await client.getCashAccountStatements(params.account_id, params.cursor, params.limit);
  
        // Return complete objects without any summarization
        const items = Array.isArray(resp?.items) ? resp.items : [];
  
        return {
          content: [{
            type: "text",
            text: JSON.stringify({
              statements: items,
              meta: {
                count: items.length,
                next_cursor: resp?.next_cursor || undefined
              }
            }, null, 2)
          }]
        };
      } catch (error) {
        logError(`Error in get_cash_account_statements: ${error instanceof Error ? error.message : String(error)}`);
        throw error;
      }
    });
  }

• src/tools/getCashAccountStatements.ts:20-31 (helper)

  Parameter validation and parsing function for tool inputs.

  function validateParams(input: unknown): GetCashAccountStatementsParams {
    const raw = (input || {}) as Record<string, unknown>;
    if (!raw.account_id) throw new Error("Missing required parameter: account_id");
    const out: GetCashAccountStatementsParams = { account_id: String(raw.account_id) };
    if (raw.cursor !== undefined) out.cursor = String(raw.cursor);
    if (raw.limit !== undefined) {
      const n = parseInt(String(raw.limit), 10);
      if (isNaN(n) || n <= 0 || n > 100) throw new Error("Invalid limit (1..100)");
      out.limit = n;
    }
    return out;
  }

• src/services/brex/client.ts:309-323 (helper)

  BrexClient method that performs the actual API call to retrieve cash account statements.

  async getCashAccountStatements(id: string, cursor?: string, limit?: number): Promise<PageStatement> {
    try {
      const params: Record<string, unknown> = {};
      if (cursor) params.cursor = cursor;
      if (limit) params.limit = limit;
  
      logDebug(`Fetching statements for cash account ${id} from Brex API`);
      const response = await this.client.get(`/v2/accounts/cash/${id}/statements`, { params });
      logDebug(`Successfully fetched ${response.data.items.length} statements for cash account ${id}`);
      return response.data;
    } catch (error) {
      this.handleApiError(error, 'GET', `/v2/accounts/cash/${id}/statements`);
      throw error;
    }
  }