Brex MCP Server

/** * @file Get Budgets Tool (read-only) */ import { Server } from "@modelcontextprotocol/sdk/server/index.js"; import { BrexClient } from "../services/brex/client.js"; import { logError } from "../utils/logger.js"; import { registerToolHandler, ToolCallRequest } from "./index.js"; import { SpendBudgetStatus, BudgetListParams } from "../models/budget.js"; function getBrexClient(): BrexClient { return new BrexClient(); } interface GetBudgetsParams { limit?: number; cursor?: string; parent_budget_id?: string; spend_budget_status?: SpendBudgetStatus; } function validateParams(input: unknown): GetBudgetsParams { const raw = (input || {}) as Record<string, unknown>; const out: GetBudgetsParams = {}; 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; } if (raw.cursor !== undefined) out.cursor = String(raw.cursor); if (raw.parent_budget_id !== undefined) out.parent_budget_id = String(raw.parent_budget_id); if (raw.spend_budget_status !== undefined) out.spend_budget_status = String(raw.spend_budget_status) as SpendBudgetStatus; return out; } export function registerGetBudgets(_server: Server): void { registerToolHandler("get_budgets", async (request: ToolCallRequest) => { try { const params = validateParams(request.params.arguments); const client = getBrexClient(); const apiParams: BudgetListParams = { limit: params.limit, cursor: params.cursor, parent_budget_id: params.parent_budget_id, spend_budget_status: params.spend_budget_status }; const resp = await client.getBudgets(apiParams); const items = Array.isArray(resp.items) ? resp.items : []; return { content: [{ type: "text", text: JSON.stringify({ budgets: items, meta: { count: items.length, next_cursor: resp.next_cursor || null } }, null, 2) }] }; } catch (error) { logError(`Error in get_budgets: ${error instanceof Error ? error.message : String(error)}`); throw error; } }); }