> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Ramp

**Authentication:** OAuth. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* List every transaction over \$1,000 last month, by department.
* Find expenses missing receipts and ping the cardholder.
* Pull spend by category for Q1.

## Available Tools

#### list_gl_accounts

List Ramp GL (General Ledger) accounts for accounting integration. Returns account names, codes, and classifications. Supports cursor-based pagination.

#### list_vendors

List Ramp vendors for bill pay. Returns vendor names, contact info, and default payment methods. Supports cursor-based pagination.

#### list_bills

List Ramp bills with filtering by entity, vendor, status (DRAFT, PENDING, APPROVED, PAID), and date range. Supports cursor-based pagination.

#### get_bill

Get a specific Ramp bill by ID with full details including line items, vendor info, and payment method.

#### create_bill

Create a new Ramp bill for bill pay. Requires vendor ID, amount, entity ID, issued date, and due date. Optionally include invoice number and memo.

#### update_bill

Update an existing Ramp bill. Only approved bills can be updated. Can modify amount, invoice details, due date, and line items.

#### get_business

Get the Ramp business profile including business name, settings, and integration status.

#### get_business_balance

Get the Ramp business balance including current balance, statement balance, credit limit, and available credit.

#### get_bank_account

Get a specific Ramp bank account by ID with account type, verification status, and details.

#### list_cards

List Ramp cards with filtering by user, entity, card program, physical/virtual type, and state (ACTIVE, SUSPENDED, TERMINATED). Supports cursor-based pagination.

#### get_card

Get a specific Ramp card by ID with full details including spend limits, spending restrictions, and cardholder info.

#### create_virtual_card

Create a new Ramp virtual card. This is an async operation that returns a task ID. Use get_deferred_task_status to check completion.

#### create_physical_card

Create a new Ramp physical card. Requires shipping address. This is an async operation that returns a task ID. Use get_deferred_task_status to check completion.

#### get_deferred_task_status

Check the status of an async/deferred Ramp operation (card creation, suspension, etc.). Returns task status and result data when completed.

#### update_card

Update a Ramp card's display name, spend limit, or spending restrictions.

#### suspend_card

Suspend a Ramp card. This is an async operation that returns a task ID. The card will be temporarily disabled.

#### unsuspend_card

Unsuspend/reactivate a suspended Ramp card. This is an async operation that returns a task ID.

#### list_departments

List all Ramp departments/cost centers with their entity assignments and hierarchy. Supports cursor-based pagination.

#### list_entities

List all Ramp business entities for multi-entity businesses. Returns entity names, addresses, and primary entity designation. Supports cursor-based pagination.

#### get_entity

Get a specific Ramp business entity by ID with full details including address and phone.

#### list_limits

List Ramp spending limits/policies with filtering by user, card, department, and entity. Returns limit amounts, intervals, and usage. Supports cursor-based pagination.

#### get_limit

Get a specific Ramp spending limit by ID with full details including amount, interval, restrictions, and current usage.

#### list_reimbursements

List Ramp reimbursement requests with filtering by user and status (PENDING, APPROVED, REJECTED, REIMBURSED). Supports cursor-based pagination.

#### get_reimbursement

Get a specific Ramp reimbursement by ID with full details including receipts, accounting categories, and approval status.

#### list_transactions

List Ramp card transactions with filtering by date range, card ID, user ID, department ID, amount range, and transaction state (PENDING, CLEARED, DECLINED). Supports cursor-based pagination.

#### get_transaction

Get a specific Ramp transaction by ID with full details including receipts, memo, merchant info, and accounting categories.

#### list_cashbacks

List Ramp cashback/rewards earned on transactions. Supports cursor-based pagination.

#### list_users

List Ramp users with filtering by department, location, role (ADMIN, OWNER, USER, BOOKKEEPER), status, and entity. Supports cursor-based pagination.

#### get_user

Get a specific Ramp user by ID with full profile including associated cards, spending limits, department, and manager info.