Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BREX_API_KEY | Yes | Your Brex API key |
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_transactions | Retrieve transactions for a specific Brex account by account ID. Legacy endpoint for general transaction retrieval. Returns transaction list with money annotation. |
| get_expenses | Retrieve a paginated list of expenses with optional filters for status, type, and amount. Supports expansion of related objects like merchant and budget details. Returns expenses with automatic money annotation (cents, dollars, formatted). |
| get_account_details | Retrieve detailed information for a specific Brex account by account ID. Returns complete account details including current balance, available balance, type, currency, and status. |
| upload_receipt | Upload a receipt image (base64-encoded) to a specific card expense. Creates a pre-signed S3 URL, uploads the receipt, and associates it with the expense. Returns upload confirmation. NOTE: This is a write operation. |
| match_receipt | Create a pre-signed S3 URL for uploading a receipt that will be automatically matched with existing expenses. Returns upload URL and receipt matching details. Receipt matching expires after 30 minutes. NOTE: This is a write operation. |
| update_expense | Update metadata for an existing card expense (memo, category, budget, department, location, custom fields). Returns updated expense object. NOTE: This is a write operation - use cautiously. |
| get_all_accounts | Fetch all Brex accounts (card and cash) with automatic pagination. Supports status filtering. Returns account details including balances, type, currency, and status. Includes money annotation on balance fields. |
| get_all_expenses | Fetch all expenses across multiple pages with automatic pagination handling. Supports date range filtering, amount filtering, status filtering, and merchant search. Returns aggregated results with summary statistics. Use window_days to batch large date ranges. |
| get_all_card_expenses | Fetch all card expenses across multiple pages (similar to get_all_expenses but card-specific endpoint). Supports pagination, date filtering, merchant search, and amount filters. Returns complete expense objects with money annotation and summaries. |
| get_card_transactions | List settled transactions for all card accounts (primary card endpoint). Supports pagination and user filtering. NOTE: Does not support posted_at_start or expand parameters - filter client-side by posted_at_date if needed. Returns transactions with money annotation. |
| get_cash_account_statements | List finalized statements for a specific cash account by account ID. Requires cash account scopes. Supports cursor-based pagination. Returns complete statement objects with period details and transaction summaries. |
| get_expense | Retrieve a single expense by its unique ID. Supports expansion of nested objects (merchant, budget, user, department, location, receipts). Returns complete expense details with money annotation. |
| get_card_expense | Retrieve a single card expense by its unique ID. Supports expansion of nested objects. Returns complete card expense details with money annotation. (Deprecated - use get_expense instead) |
| get_card_statements_primary | List all finalized statements for the primary card account. Supports cursor-based pagination. Returns complete statement objects with period dates, balances, and payment information. |
| get_cash_transactions | List settled transactions for a specific cash account. Requires cash account scopes. Supports pagination. NOTE: Does not support posted_at_start or expand parameters - filter client-side by posted_at_date if needed. Returns transactions with money annotation. |
| get_budgets | List budget allocations with spending limits and current status. Supports filtering by parent budget and status. Returns paginated budget list with amount details (amount, period, recurrence, limit type). |
| get_budget | Retrieve a single budget by its unique ID. Returns complete budget details including spending limits, period configuration, and current status. |
| get_spend_limits | List spend limit policies with authorization settings and spending controls. Supports filtering by member user and pagination. Returns detailed limit configurations including base limits, buffer percentages, and merchant category controls. |
| get_spend_limit | Retrieve a single spend limit by its unique ID. Returns complete spend limit configuration including authorization settings, period recurrence, merchant controls, and current balance. |
| get_budget_programs | List budget program configurations that define automated budget assignment rules. Supports filtering by status and pagination. Returns program details including budget blueprints and employee filters. |
| get_budget_program | Retrieve a single budget program by its unique ID. Returns complete program configuration including budget blueprints, employee filters, and automation settings. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| summarize_transactions | Summarize transactions for a Brex account |
| summarize_expenses | Summarize expenses by category and status |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Brex Accounts | List of all Brex accounts (card and cash) with balances and status. Supports query parameters: ?summary_only=true (condensed data), &fields=field1,field2 (select specific fields using dot notation, e.g., 'id,status,current_balance.amount') |
| Brex Card Accounts | List of all card accounts with balances and status. Supports query parameters: ?summary_only=true, &fields=field1,field2 |
| Brex Cash Accounts | List of all cash accounts with balances and status. Requires cash account scopes. Supports query parameters: ?summary_only=true, &fields=field1,field2 |
| Brex Primary Cash Account | Information for the primary cash account. Requires cash account scopes. Supports query parameters: ?summary_only=true, &fields=field1,field2 |
| Brex Card Transactions | List of settled transactions for all card accounts. Supports query parameters: ?summary_only=true, &fields=field1,field2 |
| Brex Expenses | List of all Brex expenses with automatic expansion of merchant and budget details. Supports query parameters: ?summary_only=true (condensed data), &fields=field1,field2 (select specific fields using dot notation, e.g., 'id,status,purchased_amount.amount') |
| Brex Card Expenses | List of all card expenses with automatic expansion of merchant and budget details. Supports query parameters: ?summary_only=true, &fields=field1,field2 |
| Brex Budgets | List of all budget allocations with spending limits and status. Supports query parameters: ?summary_only=true, &fields=field1,field2 |
| Brex Spend Limits | List of all spend limit policies with authorization settings. Supports query parameters: ?summary_only=true, &fields=field1,field2 |
| Brex Budget Programs | List of all budget programs with employee filter configurations. Supports query parameters: ?summary_only=true, &fields=field1,field2 |
| Brex MCP Usage Guide | Guidelines and examples for using the Brex MCP server safely and efficiently. Includes parameter reference, tool selection guide, and best practices. |