Reference

Agent Tools

Canonical generated list of Ramp tools available through Ramp MCP and Ramp CLI.

This is the canonical generated list of Ramp Agent Tools available through both Ramp MCP and Ramp CLI at build time, including exact tool names, descriptions, and parameters.

Runtime access still depends on the authenticated Ramp identity's permissions, admin controls, scopes, connected client, environment, and installed CLI version. If this list differs from the tools available in your MCP client or CLI, reconnect Ramp or update the CLI and use the live tool list for that connection.

Generated from https://api.ramp.com/v1/public/agent-tools/spec. This reviewed snapshot includes 245 tools. Tools marked Early access are on only for some businesses. Runtime access still depends on the authenticated Ramp identity's permissions, scopes, connected client, environment, and installed CLI version. If this list differs from your MCP client or CLI, reconnect Ramp or update the CLI and use the live tool list.

Accounting and sync

ramp_get_latest_sync

Get the most recent accounting sync commit for the acting user's business and sync type.

Parameters and full description

Get the most recent accounting sync commit for the acting user's business and sync type. Use this when you need the latest sync status plus every intended and successful count exposed by Ramp's accounting latest-sync endpoint.

ParameterTypeDescription
rationalerequiredstringRationale
sync_typerequiredstringSync type to fetch, such as TRANSACTION_SYNC, BILL_SYNC, BILL_PAYMENT_SYNC, REIMBURSEMENT_SYNC, TRANSFER_SYNC, WALLET_TRANSFER_SYNC, or ACCRUAL_SYNC.
ramp_get_sync_commit_failure_details

Get object-level failure details for an accounting sync commit by UUID.

Parameters and full description

Get object-level failure details for an accounting sync commit by UUID. Use this when a customer asks about failed accounting sync rows, including accounting transactions, reimbursements, bills, accounts receivable invoices, credit notes, payments, or refunds.

ParameterTypeDescription
rationalerequiredstringRationale
sync_commit_uuidrequiredstringSync Commit Uuid
ramp_get_tracking_categories

Retrieve active accounting tracking category metadata for transaction coding, such

Parameters and full description

Retrieve active accounting tracking category metadata for transaction coding, such as departments, classes or business units, locations, projects, customers, and cost centers. On Advisor Console, discovery without a transaction returns authorized clients' fields grouped by business and provider connection, including missing integrations. These groups do not establish cross-client field equivalence. If passing transaction_uuid, use an actual TransactionCanonical UUID from context or a prior lookup; omit it rather than passing a placeholder or natural-language reference.

ParameterTypeDescription
rationalerequiredstringRationale
include_hiddenbooleanInclude Hidden
transaction_uuidstring | nullActual TransactionCanonical UUID of the transaction being coded, sourced from transaction context or a prior transaction lookup result. Must be a UUID string; omit this field if no transaction UUID is available. Never invent a placeholder or natural-language reference.
ramp_get_tracking_category_options

List specific departments, projects, or other options for a tracking category.

Parameters and full description

List specific departments, projects, or other options for a tracking category. Pass `query_string` to narrow by name, synonym, or provider code. When semantic search finds nothing, the query falls back to literal name or code matching, so a multi-word phrase can return no options even when one fits. Keep the query to one short term; an empty result is not proof that no option fits: retry a shorter term or omit `query_string` to list the options. Do not call this tool when you already have the exact tracking_category_option_uuid from user-provided context, suggested codings, or another tool result. This UUID identifies the option, not the category. If the user message includes `tracking_category_option_uuid=...`, do not call this tool just to confirm the option. If you're coding a specific transaction or reimbursement, pass its UUID so results respect conditional filtering (subsidiary, department, location, etc.); skip it for generic lookups, including bill/invoice contexts. Setting `include_hidden=true` disables semantic search, so `query_string` then matches literal option names or codes only. Categories can have millions of options — paginate via `next_page_cursor` when needed, keeping all other inputs unchanged between pages.

ParameterTypeDescription
rationalerequiredstringRationale
tracking_category_uuidrequiredstringUUID of the tracking category to get options for. Obtain this from the session's tracking-category context or a registered category-listing tool. This is a category UUID, not an option UUID. Do not call this tool if the exact tracking_category_option_uuid is already available.
include_hiddenbooleanInclude Hidden
next_page_cursorinteger | nullNext Page Cursor
page_sizeintegerPage Size
query_stringstring | nullQuery String
reimbursement_uuidstring | nullOptional. UUID of the reimbursement being coded; applies conditional filtering by the reimbursement's user/department/etc.
transaction_uuidstring | nullOptional. UUID of the transaction being coded; applies conditional filtering by the transaction's user/department/etc.
ramp_mark_ready_to_sync

Mark objects as ready to sync to your accounting provider

Parameters and full description

Mark objects as ready to sync to your accounting provider

ParameterTypeDescription
object_idsrequiredarrayIDs of the objects to mark as ready to sync. All IDs must belong to the authenticated business; the request fails if any ID is not found.
object_typerequiredstringThe type of object to mark ready to sync. Supported values are TRANSACTION and REIMBURSEMENT.

Agent cards and x402

ramp_fund_x402_walletEarly access

Fund the business's x402 wallet from a Ramp Checking Account.

Parameters and full description

Fund the business's x402 wallet from a Ramp Checking Account. Before calling, use ListBusinessAccounts to obtain the source account UUID; never guess it. Confirm the exact source account and positive USD amount with the user before creating this irreversible transfer. MCP and CLI callers must provide an idempotency key. Only active Increase USD accounts are supported.

ParameterTypeDescription
amountrequirednumber | stringAmount
rationalerequiredstringRationale
source_wallet_account_uuidrequiredstringSource Wallet Account Uuid
idempotency_keystring | nullIdempotency Key
ramp_get_agent_card_creds

Get a one-time payment token for a fund. Handles card enrollment and purchase instructions automatically.

Parameters and full description

Get a one-time payment token for a fund. Handles card enrollment and purchase instructions automatically.

ParameterTypeDescription
amountrequiredstringAmount
currency_coderequiredstringCurrency Code
fund_idrequiredstringFund Id
merchant_country_coderequiredstringMerchant Country Code
merchant_namerequiredstringMerchant Name
merchant_urlrequiredstringMerchant Url
rationalerequiredstringRationale
idempotency_keystring | nullOptional for direct callers and required when recognized vault-proxy context is present. Must be a non-empty string of at most 255 characters.
ramp_get_agent_card_funds

List funds that can be used for agent card payments. Returns eligible funds with available balance.

Parameters and full description

List funds that can be used for agent card payments. Returns eligible funds with available balance.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_pay_with_x402Early access

Pay an x402 payment request from your business's stablecoin balance.

Parameters and full description

Pay an x402 payment request from your business's stablecoin balance. Fill the inputs from the merchant's 402 payment challenge. Returns a ready-to-send payment header to attach when retrying the original request.

ParameterTypeDescription
acceptedrequiredobjectExact chosen entry from the challenge's accepts array
idempotency_keyrequiredstringIdempotency Key
rationalerequiredstringRationale
resourcerequiredobjectResource object from the merchant's 402 challenge
extensionsobject | nullExtensions
ramp_provision_x402_walletEarly access

Provision your business's x402 wallet after the user explicitly confirms.

Parameters and full description

Provision your business's x402 wallet after the user explicitly confirms. Returns the same sign-ready Solana wallet on repeated calls. Do not call this tool until an owner or admin confirms that the wallet should be provisioned.

ParameterTypeDescription
confirmedrequiredbooleanConfirmed
rationalerequiredstringRationale
ramp_withdraw_x402_walletEarly access

Withdraw the business's x402 wallet balance to a Ramp Checking Account.

Parameters and full description

Withdraw the business's x402 wallet balance to a Ramp Checking Account. Before calling, use ListBusinessAccounts to obtain the destination account UUID; never guess it. Confirm the exact destination account and USDC amount with the user before creating this irreversible transfer. MCP and CLI callers must provide an idempotency key. Only active Increase USD accounts are supported.

ParameterTypeDescription
amountrequirednumber | stringAmount
destination_wallet_account_uuidrequiredstringDestination Wallet Account Uuid
rationalerequiredstringRationale
idempotency_keystring | nullIdempotency Key

Analytics and AI spend

ramp_get_ai_token_spend_aggregates

Aggregate AI token usage or estimated cost over a time window, grouped by caller-selected dimensions (provider, model, configuration, department, user, or API-key tag group).

Parameters and full description

Aggregate AI token usage or estimated cost over a time window, grouped by caller-selected dimensions (provider, model, configuration, department, user, or API-key tag group).

ParameterTypeDescription
end_atrequiredstringEnd At
metricrequiredstringMetric
rationalerequiredstringRationale
start_atrequiredstringStart At
configuration_idsarray | nullConfiguration Ids
department_uuidsarray | nullDepartment Uuids
group_byarray | nullGroup By
model_compute_tierarray | nullModel Compute Tier
model_context_windowarray | nullModel Context Window
model_familiesarray | nullModel Families
model_fine_tune_sourcearray | nullModel Fine Tune Source
model_speedarray | nullModel Speed
model_thinkingarray | nullModel Thinking
modelsarray | nullModels
providersarray | nullProviders
rollupstringTime bucketing. 'all' returns a single bucket per group; 'daily'/'weekly'/'monthly' return one row per bucket per group.
tag_definition_idstring | nullTag Definition Id
user_uuidsarray | nullUser Uuids
ramp_get_ai_token_spend_connections

Summarize connected AI providers (admin keys, OpenRouter/LiteLLM gateway connections, and Ramp Router). Use GetAiTokenSpendCurrentSpend for actual vendor spend and GetAiTokenSpendAggregates for estimated token usage and cost.

Parameters and full description

Summarize connected AI providers (admin keys, OpenRouter/LiteLLM gateway connections, and Ramp Router). Use GetAiTokenSpendCurrentSpend for actual vendor spend and GetAiTokenSpendAggregates for estimated token usage and cost.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_get_ai_token_spend_current_spend

Report the business's actual trailing-30-day Ramp spend on AI vendors (card, bill, and reimbursement spend) per provider. Requires transaction, reimbursement, or bill read access.

Parameters and full description

Report the business's actual trailing-30-day Ramp spend on AI vendors (card, bill, and reimbursement spend) per provider. Requires transaction, reimbursement, or bill read access.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_get_ai_token_spend_filter_options

List the dimensions and values available for AI-spend aggregate queries: providers, models, model families/facets, departments, and API-key tag groups.

Parameters and full description

List the dimensions and values available for AI-spend aggregate queries: providers, models, model families/facets, departments, and API-key tag groups.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_get_my_ai_token_spend_aggregates

Aggregate the acting user's own AI token usage and estimated token cost over a time window, optionally grouped by provider and model.

Parameters and full description

Aggregate the acting user's own AI token usage and estimated token cost over a time window, optionally grouped by provider and model.

ParameterTypeDescription
end_atrequiredstringEnd At
rationalerequiredstringRationale
start_atrequiredstringStart At
group_byarray | nullGroup By
model_compute_tierarray | nullModel Compute Tier
model_context_windowarray | nullModel Context Window
model_familiesarray | nullModel Families
model_fine_tune_sourcearray | nullModel Fine Tune Source
model_speedarray | nullModel Speed
model_thinkingarray | nullModel Thinking
modelsarray | nullModels
providersarray | nullProviders
rollupstringTime bucketing. 'all' returns a single bucket per group; 'daily'/'weekly'/'monthly' return one row per bucket per group.

Approvals and review

ramp_approve_or_reject_bill

Approve or reject a submitted bill that is pending approval. The authenticated user must be the next required approver on the bill's approval chain. Rejection is additionally allowed for bill-pay admins as an override, even when they are not the next approver. Find bills awaiting the authenticated user's approval with get-bills-for-approval. Some bills require step-up verification that agents cannot complete; in that case the error includes a redirect_url that the human user must open in a browser to finish the action there. Approving advances the bill's approval chain, exactly as approving in the Ramp web app does: depending on the business's payment-release settings, a bill that becomes fully approved with payment details and a payment date already set may proceed to payment automatically. After an approval, the response reports the bill's resulting payment state: whether any of its payments has been initiated (payment_initiated — this includes earlier partial payments; a chain-completing approval may have just added one) and the earliest such payment date (payment_date) — so you can inform the user. This tool never schedules payments or edits payment details; payment scheduling and release are managed in the Ramp web app — hand the user the bill_url returned on success.

Parameters and full description

Approve or reject a submitted bill that is pending approval. The authenticated user must be the next required approver on the bill's approval chain. Rejection is additionally allowed for bill-pay admins as an override, even when they are not the next approver. Find bills awaiting the authenticated user's approval with get-bills-for-approval. Some bills require step-up verification that agents cannot complete; in that case the error includes a redirect_url that the human user must open in a browser to finish the action there. Approving advances the bill's approval chain, exactly as approving in the Ramp web app does: depending on the business's payment-release settings, a bill that becomes fully approved with payment details and a payment date already set may proceed to payment automatically. After an approval, the response reports the bill's resulting payment state: whether any of its payments has been initiated (payment_initiated — this includes earlier partial payments; a chain-completing approval may have just added one) and the earliest such payment date (payment_date) — so you can inform the user. This tool never schedules payments or edits payment details; payment scheduling and release are managed in the Ramp web app — hand the user the bill_url returned on success.

ParameterTypeDescription
action_typerequiredstringAction Type
bill_idrequiredstringBill Id
rationalerequiredstringRationale
reasonstring | nullReason
ramp_approve_or_reject_reimbursement

Approve or reject an employee reimbursement request for an out-of-pocket expense.

Parameters and full description

Approve or reject an employee reimbursement request for an out-of-pocket expense. Use this tool when the user wants to approve or reject a reimbursement. Reimbursements are employee-submitted requests for reimbursement of out-of-pocket expenses. Common usage patterns: "approve this reimbursement", "reject the expense", "yes, reimburse them", "no, don't reimburse this". This tool is specifically for employee reimbursements and is NOT for approving/rejecting card transactions or unified requests (spend allocations, purchase orders).

ParameterTypeDescription
actionrequiredstringThe action to take on the reimbursement: approve or reject.
rationalerequiredstringRationale
reimbursement_idrequiredstringReimbursement Id
thoughtsstring | nullThoughts
user_reasonstring | nullUser Reason
ramp_approve_or_reject_request

Approve or reject a pending unified request for spend allocation (fund), purchase order, or procurement approval.

Parameters and full description

Approve or reject a pending unified request for spend allocation (fund), purchase order, or procurement approval. Use this tool when a user wants to approve or reject a specific request they have identified or referenced. Common usage patterns: "approve this request", "reject this request", "accept the request", "deny this", "authorize this", "yes approve it", "decline this request". This tool is specifically for unified requests (spend allocations, purchase orders, procurement approvals) and is NOT for approving expenses like corporate card transactions or reimbursements. The user must have proper approval authority for the request. Admin approval overrides are not available through this tool; use the app instead.

ParameterTypeDescription
actionrequiredstringThe action to perform: APPROVE or REJECT. ADMIN_APPROVE is unsupported; use the app for admin approval.
rationalerequiredstringRationale
thoughtsrequiredstringThoughts
unified_request_idrequiredstring | nullUnified Request Id
approval_instance_uuidstring | nullApproval Instance Uuid
reasonstring | nullReason
user_confirmed_admin_approvalbooleanUser Confirmed Admin Approval
ramp_approve_or_reject_transaction

Approve or reject a transaction awaiting your review.

Parameters and full description

Approve or reject a transaction awaiting your review. Use this tool when the user wants to approve a transaction, send it back for revisions, or require the cardholder to repay the full amount. The acting user must have the proper approval authority for the transaction. If the user provides a written justification (e.g., “reject this because the receipt is missing”), pass that verbatim via `user_reason`—do not invent your own rationale.

ParameterTypeDescription
actionrequiredstringAction to perform: APPROVE, REJECT_AND_REQUEST_CHANGES (send back to cardholder with requested revisions), or REJECT_AND_REQUEST_FULL_REPAYMENT (require employee repayment).
rationalerequiredstringRationale
thoughtsrequiredstringThoughts
transaction_idrequiredstringThe transaction to act on
user_reasonstring | nullUser Reason
ramp_get_bills_for_approval

Get bills that are pending approval from the current user.

Parameters and full description

Get bills that are pending approval from the current user. Use this tool when the user wants to see bills they need to approve or asks about pending approvals. This returns only bills where the authenticated user is the next required approver in the approval chain. Bills in Ramp have two stages: draft bills (created/uploaded but not yet submitted; use the draft-bill tools) and bills (submitted; they move through approval, then scheduling, then payment). A draft keeps the same ID after submission, but draft-only tools stop working on it once submitted.

ParameterTypeDescription
rationalerequiredstringRationale
limitintegerLimit
page_cursorstring | nullPage Cursor
ramp_get_reimbursements_for_approval

Get employee reimbursements pending approval by the current user. Includes comments, policy assessment data, and recommended actions.

Parameters and full description

Get employee reimbursements pending approval by the current user. Includes comments, policy assessment data, and recommended actions.

ParameterTypeDescription
rationalerequiredstringRationale
limitintegerLimit
ramp_get_requests_to_review

Get requests that require the current user's review and approval.

Parameters and full description

Get requests that require the current user's review and approval. This is the approval-queue wrapper over SearchUnifiedRequests. Use it when the user is specifically asking what they need to review or approve right now. For broader lookup by vendor, owner, status, or request name, prefer SearchUnifiedRequests instead. Only handles lookups, does not take any action.

ParameterTypeDescription
rationalerequiredstringRationale
thoughtsrequiredstringThoughts
page_sizeintegerPage Size
request_typesarray | nullRequest Types
startstring | nullStart
ramp_remind_bill_approvers

Remind next approvers for bills awaiting approval.

Parameters and full description

Remind next approvers for bills awaiting approval. Use this tool when the user wants to nudge approvers for specific bill UUIDs. The bills should be awaiting approval; use get-bills-for-approval first if the user has not identified the bill UUIDs.

ParameterTypeDescription
bill_uuidsrequiredarrayBill Uuids
rationalerequiredstringRationale

Banking and treasury

ramp_account_numbers

List agent account numbers

Parameters and full description

List agent account numbers

ParameterTypeDescription
rationalerequiredstringWhy this MCP tool call is needed.
page_sizeinteger | nullThe number of results to be returned in each page. The value must be between 2 and 100. If not specified, the default value 20 will be used.
startstring | nullThe ID of the last entity of the previous page, used for pagination to get the next page.
ramp_accounts

List bank accounts

Parameters and full description

List bank accounts

ParameterTypeDescription
rationalerequiredstringWhy this MCP tool call is needed.
connection_providerstring | nullFilter bank accounts by connection provider.
page_sizeinteger | nullThe number of results to be returned in each page. The value must be between 2 and 100. If not specified, the default value 20 will be used.
startstring | nullThe ID of the last entity of the previous page, used for pagination to get the next page.
ramp_create

Create a manually connected bank account

Parameters and full description

Create a manually connected bank account

ParameterTypeDescription
account_numberrequiredstringBank account number.
account_subtyperequiredstringBank account subtype.
rationalerequiredstringWhy this MCP tool call is needed.
routing_numberrequiredstringABA routing number used for ACH transfers.
account_namestring | nullOptional display name for the bank account.
idempotency_keystring | nullUnique idempotency key generated by the client. Must be a non-empty string of at most 255 characters.
wire_detailsobject | nullOptional wire-transfer details for the account.
ramp_get_account_balance_history

Get daily balance history for a specific Ramp Checking Account.

Parameters and full description

Get daily balance history for a specific Ramp Checking Account. Use when the user asks about balance history for a specific account, savings account trend, checking account balance over time, or the balance trend for a specific Ramp Checking Account. This tool only supports Ramp Checking Accounts, not Investment Accounts or Managed Portfolios.

ParameterTypeDescription
account_uuidrequiredstringAccount Uuid
rationalerequiredstringRationale
end_datestring | nullEnd Date
start_datestring | nullStart Date
ramp_get_investment_account_balance

Get the balance of investment accounts for the business.

Parameters and full description

Get the balance of investment accounts for the business. Use this when the user asks about investment account balances, brokerage cash, or the current balance of Ramp investment accounts. Returns all investment accounts the business has, along with balances, status, yield, and earnings.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_get_managed_portfolio_account_balance

Get the balance of managed portfolio accounts for the business.

Parameters and full description

Get the balance of managed portfolio accounts for the business. Use this when the user asks about managed portfolio balances, managed portfolio cash, or the current balance of Ramp managed portfolio accounts. Returns all managed portfolio accounts the business has, along with balances, market value, status, yield, and earnings.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_get_ramp_business_account_balance

Get the balance of Ramp Checking Accounts for the business.

Parameters and full description

Get the balance of Ramp Checking Accounts for the business. Returns the available balance, statement balance, and other details for all Ramp Checking Accounts associated with the user's business. This includes yield/earnings information and account status. This tool is intentionally limited to the stable user-facing fields for Ramp Checking Accounts. Do not infer deprecated pending balances or current month accrued yield values from other treasury payloads when responding to the user.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_get_treasury_balance_history

Get daily balance history across all Treasury accounts for a date range.

Parameters and full description

Get daily balance history across all Treasury accounts for a date range.

ParameterTypeDescription
end_daterequiredstringEnd Date
rationalerequiredstringRationale
start_daterequiredstringStart Date
ramp_get_treasury_document_linkEarly access

Get a PDF download link for a monthly Ramp Checking Account statement by document UUID

Parameters and full description

Get a PDF download link for a monthly Ramp Checking Account statement by document UUID

ParameterTypeDescription
document_typerequiredstringValue for document_type.
document_uuidrequiredstringValue for document_uuid.
rationalerequiredstringValue for rationale.
ramp_get_treasury_documents_download_linkEarly access

Get one ZIP download link for selected monthly Ramp Checking Account statements by document type and UUID. Accepts 1–50 selections, ignoring duplicates, with a 50 MiB limit on both the combined statements and ZIP. Creates a private bundle and records document-access audit events. The link expires after one hour; does not return or interpret PDF contents.

Parameters and full description

Get one ZIP download link for selected monthly Ramp Checking Account statements by document type and UUID. Accepts 1–50 selections, ignoring duplicates, with a 50 MiB limit on both the combined statements and ZIP. Creates a private bundle and records document-access audit events. The link expires after one hour; does not return or interpret PDF contents.

ParameterTypeDescription
documentsrequiredarrayDocuments
rationalerequiredstringRationale
ramp_list_business_accounts

List all Ramp Checking Accounts (wallet accounts) for the user's business.

Parameters and full description

List all Ramp Checking Accounts (wallet accounts) for the user's business. Returns account details including balances, currency, yield rate, and status. Use this tool when the user asks about their checking accounts, wallet accounts, or wants to see an overview of their Ramp Checking Accounts.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_list_treasury_accounts

List all Treasury accounts (Ramp Checking Accounts, Investment Accounts, Managed Portfolios).

Parameters and full description

List all Treasury accounts (Ramp Checking Accounts, Investment Accounts, Managed Portfolios).

ParameterTypeDescription
rationalerequiredstringRationale
ramp_list_treasury_documentsEarly access

List available monthly Ramp Checking Account statements, including document UUIDs, account names, and statement periods, filtered by overlapping date range: start_date includes statements ending on or after that date; end_date includes statements starting on or before that date; returns up to 50 results per page; pass next_cursor as cursor with the same filters to continue

Parameters and full description

List available monthly Ramp Checking Account statements, including document UUIDs, account names, and statement periods, filtered by overlapping date range: start_date includes statements ending on or after that date; end_date includes statements starting on or before that date; returns up to 50 results per page; pass next_cursor as cursor with the same filters to continue

ParameterTypeDescription
document_typerequiredstringValue for document_type.
rationalerequiredstringValue for rationale.
cursorstring | nullValue for cursor.
end_datestring | nullValue for end_date.
start_datestring | nullValue for start_date.
ramp_list_wallet_transfers

List transfers for the user's business Ramp wallet accounts.

Parameters and full description

List transfers for the user's business Ramp wallet accounts. Returns a list of transfers including deposits, withdrawals, and other transactions with details like amount, status, and dates.

ParameterTypeDescription
rationalerequiredstringRationale
cursorstring | nullCursor returned by the previous page's next_cursor. Preserve the same wallet account, date filters, and page size when continuing. Omit the cursor when changing accounts.
from_datestring | nullFrom Date
page_sizeintegerPage Size
to_datestring | nullTo Date
wallet_account_uuidstring | nullFilter transfers to this Ramp wallet account UUID. Omit to list transfers across accessible wallet accounts.
ramp_request_funds

Request funds for a banking account

Parameters and full description

Request funds for a banking account

ParameterTypeDescription
amountrequiredobjectAmount to request in minor currency units
banking_account_idrequiredstringUnique identifier of the banking account.
external_bank_account_idrequiredstringExternal bank account to request funds from
rationalerequiredstringWhy this MCP tool call is needed.
agent_account_number_idstring | nullAgent account number to receive the funds. If omitted, the banking account's primary account number is used
idempotency_keystring | nullUnique idempotency key generated by the client. Must be a non-empty string of at most 255 characters.
memostring | nullOptional reason for the funding request

Bills and vendor payments

ramp_create_draft_bill

Create an unsubmitted draft bill for an existing vendor that is visible to the caller and eligible for bill creation. Hidden manually created pending vendors are not eligible. Returns the draft UUID, initial version, and Ramp URL. This does not start approval, schedule, release, or initiate payment. Omitted fields remain empty, so the new draft may not yet be ready for submission.

Parameters and full description

Create an unsubmitted draft bill for an existing vendor that is visible to the caller and eligible for bill creation. Hidden manually created pending vendors are not eligible. Returns the draft UUID, initial version, and Ramp URL. This does not start approval, schedule, release, or initiate payment. Omitted fields remain empty, so the new draft may not yet be ready for submission.

ParameterTypeDescription
draft_billrequiredobjectDraft bill fields to set at creation. Do not include vendor fields; vendor_uuid is the only vendor input.
rationalerequiredstringBriefly explain why you are calling this tool: what goal or workflow it serves and what you intend to do with the result.
vendor_uuidrequiredstringUUID of an existing vendor/payee that is visible to the caller and eligible for bill creation. Hidden manually created pending vendors are not eligible.
idempotency_keystring | nullUnique idempotency key generated by the client. Must be a non-empty string of at most 255 characters.
ramp_create_payeeEarly access

Create a vendor with a contact email and country supplied by the user. US vendors also require a state abbreviation. Returns the vendor, bill-pay vendor, and contact UUIDs. Configured vendor approval policies apply, so creation does not guarantee approval. Explicit draft creation is not supported. Vendors matching an existing name or DBA are rejected, including pending creations and drafts visible to the vendor duplicate check.

Parameters and full description

Create a vendor with a contact email and country supplied by the user. US vendors also require a state abbreviation. Returns the vendor, bill-pay vendor, and contact UUIDs. Configured vendor approval policies apply, so creation does not guarantee approval. Explicit draft creation is not supported. Vendors matching an existing name or DBA are rejected, including pending creations and drafts visible to the vendor duplicate check.

ParameterTypeDescription
contactrequiredobjectRequired primary vendor contact with an email explicitly provided by the user. Never infer or invent an email.
countryrequiredstringRequired vendor country as an ISO 3166-1 alpha-2 code, explicitly provided by the user; never assume US.
namerequiredstringName
rationalerequiredstringRationale
owner_user_uuidsarray | nullOwner User Uuids
statestring | nullState
websitestring | nullWebsite
ramp_get_bill_amount_summary

Get aggregate dollar amounts for bills matching the given filters.

Parameters and full description

Get aggregate dollar amounts for bills matching the given filters. Examples: total unpaid amount, total pending amount. Use when users ask things like "How much do we owe in bills?" or "What's our total outstanding bill amount?". Bills in Ramp have two stages: draft bills (created/uploaded but not yet submitted; use the draft-bill tools) and bills (submitted; they move through approval, then scheduling, then payment). A draft keeps the same ID after submission, but draft-only tools stop working on it once submitted.

ParameterTypeDescription
rationalerequiredstringRationale
due_date_fromstring | nullDue Date From
due_date_tostring | nullDue Date To
max_amountnumber | nullMax Amount
min_amountnumber | nullMin Amount
payment_statusstring | nullPayment Status
vendor_namestring | nullVendor Name
ramp_get_bill_comments

Retrieve comments from a bill's comment thread.

Parameters and full description

Retrieve comments from a bill's comment thread. Bills in Ramp have two stages: draft bills (created/uploaded but not yet submitted; use the draft-bill tools) and bills (submitted; they move through approval, then scheduling, then payment). A draft keeps the same ID after submission, but draft-only tools stop working on it once submitted.

ParameterTypeDescription
bill_idrequiredstringBill Id
rationalerequiredstringRationale
ramp_get_bill_details

Get details for a bill already confirmed to be submitted; submitted bills only.

Parameters and full description

Get details for a bill already confirmed to be submitted; submitted bills only. Requires a bill UUID and known submitted status. A UUID alone does not establish submission: a draft keeps the same UUID after submission. Not applicable to bills whose draft/submitted stage is unknown or to unsubmitted drafts. Returns bill metadata, payment status, and approval status. Submitted bills include bills awaiting approval, scheduling, or payment.

ParameterTypeDescription
bill_idrequiredstringBill Id
rationalerequiredstringRationale
ramp_get_bill_history

Retrieve the full modification and approval history of a bill, including status changes, approval actions, and creation details.

Parameters and full description

Retrieve the full modification and approval history of a bill, including status changes, approval actions, and creation details. Returns a chronological event log — creation, submission, each approval-chain action with actor and timestamp, and deletion. Use it to answer questions like "who approved this bill?". Bills in Ramp have two stages: draft bills (created/uploaded but not yet submitted; use the draft-bill tools) and bills (submitted; they move through approval, then scheduling, then payment). A draft keeps the same ID after submission, but draft-only tools stop working on it once submitted.

ParameterTypeDescription
bill_idrequiredstringBill Id
rationalerequiredstringRationale
ramp_get_bill_invoices

Retrieve invoice file attachments (PDFs/images) for a submitted bill.

Parameters and full description

Retrieve invoice file attachments (PDFs/images) for a submitted bill. Returns the source documents backing the bill: for each attachment, the filename, type, and a time-limited download URL (the URL expires after about 3 days). Draft bills are not supported: draft attachments are not retrievable through agent tools. get-draft-bill-details returns draft metadata and a link to the draft page in the Ramp web app, where attachments can be viewed. Bills in Ramp have two stages: draft bills (created/uploaded but not yet submitted; use the draft-bill tools) and bills (submitted; they move through approval, then scheduling, then payment). A draft keeps the same ID after submission, but draft-only tools stop working on it once submitted.

ParameterTypeDescription
bill_idrequiredstringBill Id
rationalerequiredstringRationale
ramp_get_bill_metrics

Returns the count of bills matching specified filters. Use this to answer questions like "How many bills are pending approval?" or "How many overdue bills do we have?".

Parameters and full description

Returns the count of bills matching specified filters. Use this to answer questions like "How many bills are pending approval?" or "How many overdue bills do we have?". Bills in Ramp have two stages: draft bills (created/uploaded but not yet submitted; use the draft-bill tools) and bills (submitted; they move through approval, then scheduling, then payment). A draft keeps the same ID after submission, but draft-only tools stop working on it once submitted.

ParameterTypeDescription
rationalerequiredstringRationale
approval_statusstring | nullApproval Status
from_due_datestring | nullFrom Due Date
is_draftboolean | nullIs Draft
payment_statusstring | nullPayment Status
status_summarystring | nullStatus Summary
to_due_datestring | nullTo Due Date
vendor_namestring | nullVendor Name
ramp_get_bill_status

Get the recorded payment and approval status of a specific submitted bill.

Parameters and full description

Get the recorded payment and approval status of a specific submitted bill. This tool does not determine required next actions: next_action_required is always null (unavailable), not confirmation that no action is needed. Summary labels describe recorded status. PAYMENT_DETAILS_MISSING indicates incomplete details required for payment release; it does not identify the missing fields, who must supply them, or whether a payment date can be selected. Bills in Ramp have two stages: draft bills (created/uploaded but not yet submitted; use the draft-bill tools) and bills (submitted; they move through approval, then scheduling, then payment). A draft keeps the same ID after submission, but draft-only tools stop working on it once submitted.

ParameterTypeDescription
bill_idrequiredstringBill Id
rationalerequiredstringRationale
ramp_get_draft_bill_details

Get details for an active draft bill that has not been submitted.

Parameters and full description

Get details for an active draft bill that has not been submitted. Submitted bills, including those awaiting approval or payment, are not supported. A draft link may be stale after submission. Returns compact draft-bill metadata by default. Set return_line_items=true to include the full editable payload with line items and tracking categories. Includes canonical submission readiness and verified missing requirements; blank optional fields are not evidence of a submission blocker. Bills in Ramp have two stages: draft bills (created/uploaded but not yet submitted; use the draft-bill tools) and bills (submitted; they move through approval, then scheduling, then payment). A draft keeps the same ID after submission, but draft-only tools stop working on it once submitted.

ParameterTypeDescription
bill_idrequiredstringThe UUID of an active, unsubmitted draft bill. Pass only the UUID, not a full URL, invoice number, or payment ID.
rationalerequiredstringRationale
return_line_itemsbooleanReturn Line Items
ramp_get_recurring_bill

Retrieve details of a recurring bill template including vendor, amount, recurrence schedule, and next payment date.

Parameters and full description

Retrieve details of a recurring bill template including vendor, amount, recurrence schedule, and next payment date. Bills in Ramp have two stages: draft bills (created/uploaded but not yet submitted; use the draft-bill tools) and bills (submitted; they move through approval, then scheduling, then payment). A draft keeps the same ID after submission, but draft-only tools stop working on it once submitted.

ParameterTypeDescription
rationalerequiredstringRationale
recurring_bill_idrequiredstringRecurring Bill Id
ramp_get_rfx_vendor_responsesEarly access

Return all submitted vendor responses for an RFX.

Parameters and full description

Return all submitted vendor responses for an RFX.

ParameterTypeDescription
rationalerequiredstringRationale
rfx_idrequiredstringRfx Id
ramp_get_vendor_agreement

Retrieve details for a specific vendor agreement/contract by UUID. Returns contract metadata, terms, line items, contract owners, documents, linked spend requests, and renewal history.

Parameters and full description

Retrieve details for a specific vendor agreement/contract by UUID. Returns contract metadata, terms, line items, contract owners, documents, linked spend requests, and renewal history.

ParameterTypeDescription
payee_agreement_uuidrequiredstringPayee Agreement Uuid
rationalerequiredstringRationale
ramp_get_vendor_banking_details

List a vendor's active bank accounts on file. Returns each account's UUID, payment rail, currency, last four characters of the account number or IBAN, nickname, default flag, and verification status. Full account and routing numbers are never returned. The account UUID is the value a bill accepts as its vendor bank account. This is read-only; it cannot add, edit, or select bank accounts.

Parameters and full description

List a vendor's active bank accounts on file. Returns each account's UUID, payment rail, currency, last four characters of the account number or IBAN, nickname, default flag, and verification status. Full account and routing numbers are never returned. The account UUID is the value a bill accepts as its vendor bank account. This is read-only; it cannot add, edit, or select bank accounts.

ParameterTypeDescription
payee_uuidrequiredstringPayee Uuid
rationalerequiredstringRationale
ramp_get_vendor_document_bulk_status

Get bulk vendor document upload progress and current document review state.

Parameters and full description

Get bulk vendor document upload progress and current document review state. Use this after `BulkUploadVendorDocuments` to inspect the batch job status, understand whether any documents still need manual review, and inspect the current document/vendor matching and extracted tax details.

ParameterTypeDescription
batch_idrequiredstringBatch Id
rationalerequiredstringRationale
is_w_documentboolean | nullIs W Document
ramp_invite_vendors_to_rfxEarly access

Invite vendors to an existing RFX so they can receive and respond to the questionnaire.

Parameters and full description

Invite vendors to an existing RFX so they can receive and respond to the questionnaire. Each vendor must be an existing payee in Ramp (draft payees are accepted), identified by its payee UUID. The default contact for each payee is used automatically. When a payee has no contacts and the RFX is still pre-publish (DRAFT or IN_REVIEW), the vendor is added as a DRAFT invitation — the RFX cannot be submitted for review or published until the user resolves the draft by providing a contact on the RFX detail page. Each per-vendor result includes a `status` of "active" or "draft" so the agent can tell the user which vendors still need contacts. External agent callers may only add vendors before the RFX is published. Adding a vendor after publish sends an invitation immediately and must be completed in Ramp.

ParameterTypeDescription
rationalerequiredstringRationale
rfx_idrequiredstringRfx Id
vendorsrequiredarrayVendors
ramp_list_bills

List and filter bills with optional search, pagination, and status filters.

Parameters and full description

List and filter bills with optional search, pagination, and status filters. Returns bills for the current user's business. When called with no parameters, returns the most recent bills. Supports optional text search across vendor name, invoice number, and payment ID. Bills in Ramp have two stages: draft bills (created/uploaded but not yet submitted; use the draft-bill tools) and bills (submitted; they move through approval, then scheduling, then payment). A draft keeps the same ID after submission, but draft-only tools stop working on it once submitted. Archived bills are excluded unless include_archived is true.

ParameterTypeDescription
rationalerequiredstringRationale
include_archivedbooleanInclude Archived
include_paidbooleanInclude Paid
limitintegerLimit
page_cursorstring | nullPage Cursor
querystring | nullQuery
ramp_list_vendor_agreements

List and filter vendor agreements/contracts across the business. Returns agreement details including dates, values, renewal status, line items, and days remaining. All filters are optional — omit all to list all agreements, or combine filters to narrow results.

Parameters and full description

List and filter vendor agreements/contracts across the business. Returns agreement details including dates, values, renewal status, line items, and days remaining. All filters are optional — omit all to list all agreements, or combine filters to narrow results.

ParameterTypeDescription
rationalerequiredstringRationale
auto_renewsboolean | nullAuto Renews
contract_owner_idsarray | nullContract Owner Ids
department_idsarray | nullDepartment Ids
evaluate_price_benchmarksbooleanEvaluate Price Benchmarks
has_end_dateboolean | nullHas End Date
include_archivedbooleanInclude Archived
include_vendor_spendbooleanInclude Vendor Spend
is_activeboolean | nullIs Active
is_up_for_renewalboolean | nullIs Up For Renewal
limitintegerLimit
max_days_remaininginteger | nullMax Days Remaining
max_end_datestring | nullMax End Date
max_last_date_to_terminatestring | nullMax Last Date To Terminate
max_start_datestring | nullMax Start Date
max_total_valuenumber | string | nullMax Total Value
min_days_remaininginteger | nullMin Days Remaining
min_end_datestring | nullMin End Date
min_last_date_to_terminatestring | nullMin Last Date To Terminate
min_start_datestring | nullMin Start Date
min_total_valuenumber | string | nullMin Total Value
payee_agreement_idsarray | nullPayee Agreement Ids
payee_owner_idsarray | nullPayee Owner Ids
payee_uuidstring | nullPayee Uuid
renewal_statusarray | nullRenewal Status
sort_ascendingboolean | nullSort Ascending
sort_bystring | nullSort results by: TOTAL_AMOUNT, NUM_DAYS_REMAINING, or END_DATE. Default: NUM_DAYS_REMAINING ascending.
vendor_namestring | nullVendor Name
ramp_request_bill_invoice_upload_link

Create a one-time URL to attach an invoice file (PDF, image or office document) to a draft bill.

Parameters and full description

Create a one-time URL to attach an invoice file (PDF, image or office document) to a draft bill. The file becomes the draft's invoice document. Ramp does not read it to fill in or change draft fields, and the draft is not submitted. Fails when the draft already has an invoice. Use this when you have a local shell with normal network access (such as Claude Code, Cursor, Codex or Ramp CLI) and the invoice file is on local disk; then run the curl command from the response. Never give the URL to the user, as it does not work in a browser. Without a shell, ask the user to attach the invoice to the draft in the Ramp web app.

ParameterTypeDescription
draft_bill_idrequiredstringUUID of the unsubmitted draft bill to attach the invoice to.
rationalerequiredstringRationale
ramp_revoke_rfx_vendor_invitationEarly access

Remove a vendor from an RFX. This is irreversible — on a published RFX

Parameters and full description

Remove a vendor from an RFX. This is irreversible — on a published RFX the vendor immediately loses access to the questionnaire and any e-sign envelope in flight is voided. DRAFT invitations are deleted outright; ACTIVE invitations are revoked (keeping their contact on record). Already-revoked invitations fail cleanly. Use GetRFXDetail to review invitations before revoking.

ParameterTypeDescription
rationalerequiredstringRationale
rfx_vendor_invitation_idrequiredstringRfx Vendor Invitation Id
ramp_search_bills

Search submitted and active draft bills by invoice number, payee, payment ID, or UUID.

Parameters and full description

Search submitted and active draft bills by invoice number, payee, payment ID, or UUID. Returns summary records for submitted and active draft bills, including authoritative lifecycle information: is_draft=true means an unsubmitted draft; is_draft=false means a submitted bill. Full bill details are outside this lookup contract. Accepts a UUID even when its lifecycle is unknown. Submitted and active draft bills may both be returned unless filters exclude them; include_drafts=False restricts results to submitted bills. Archived bills are excluded by default; set include_archived=true to include them. An unpaid bill or one awaiting approval is not necessarily a draft. Explicit invoice references use invoice_number for exact matching, including one- or two-character numbers; query remains a partial text search or UUID lookup. exact_amount filters the recorded invoice header total in its original currency before pagination. Drafts without a header amount cannot match; this is not a computed line-item total or remaining balance. Repeat the same filters with page_cursor until next_page_cursor is null; a page is not the complete match set. No date restriction applies unless supplied. Results include can_view_payment_details: false means the payment-detail lookup is unavailable for this user. Null means access is unknown, not denied. Access may change after search and is checked again when details are requested. Search results do not include payment status, approval status, or payment date; those fields are null here and are available from the bill details lookup for a specific bill. status_summary and paid_date reflect the bill's lifecycle and payment state.

ParameterTypeDescription
rationalerequiredstringRationale
accrual_year_monthstring | nullAccrual Year Month
exact_amountobject | nullOptional exact recorded invoice header total and currency. Intersects all other filters before pagination. Drafts without a header amount cannot match. Omit or pass null for no amount/currency restriction; this is not a payment or remaining-balance amount.
from_due_datestring | nullFrom Due Date
from_payment_datestring | nullFrom Payment Date
include_archivedbooleanInclude Archived
include_draftsboolean | nullInclude Drafts
include_paidboolean | nullInclude Paid
invoice_numberstring | nullInvoice Number
limitintegerLimit
page_cursorstring | nullPage Cursor
querystringQuery
status_summariesarray | nullStatus Summaries
to_due_datestring | nullTo Due Date
to_payment_datestring | nullTo Payment Date
ramp_search_vendors

Search for vendors (payees) within the business by name, or browse them.

Parameters and full description

Search for vendors (payees) within the business by name, or browse them. With a search_term, this tool finds vendor records using both fuzzy SQL matching (trigram similarity + substring) and semantic (vector) search. Without either search input, it lists the business's vendors alphabetically. Use this to find vendor IDs when you need to: - Look up a vendor by partial name - Find the correct vendor UUID for further analysis - Discover vendors similar to a given name - List vendors, optionally filtered by 1099 tracking status Exact display and DBA names are returned first. The search is scoped to the current business and the caller's vendor visibility. Results are candidates, not confirmed identities. For a user, only vendors that user can fully view are searchable; vendors in restricted vendor groups are omitted. Inactive vendors are included, but drafts are excluded unless include_draft is true. Empty or unrelated results do not establish that a vendor does not exist or that the caller has access to its profile. With search_terms, look up up to 50 names by case-insensitive exact display or DBA name in one batch. Each input returns unique_exact, ambiguous, or no_exact_match, bounded candidates, and has_more. Batch mode does not run fuzzy or semantic search; no_exact_match does not establish absence.

ParameterTypeDescription
rationalerequiredstringRationale
include_draftbooleanInclude Draft
is_1099_tracking_enabledboolean | nullIs 1099 Tracking Enabled
limitintegerLimit
search_termstring | nullSearch Term
search_termsarray | nullSearch Terms
tax_1099_yearinteger | nullTax 1099 Year
ramp_set_rfx_vendor_invitation_contactEarly access

Set or replace the contact on an RFX vendor invitation.

Parameters and full description

Set or replace the contact on an RFX vendor invitation. Resolving a DRAFT invitation's contact activates it (DRAFT → ACTIVE) so the RFX can publish; DRAFT invitations without a contact block publishing. On an ACTIVE invitation this swaps the contact who receives vendor-facing communication. Use GetRFXDetail to find invitation ids and current contacts, and the vendor contacts surface to find payee_contact_id values for the invited vendor.

ParameterTypeDescription
payee_contact_idrequiredstringPayee Contact Id
rationalerequiredstringRationale
rfx_vendor_invitation_idrequiredstringRfx Vendor Invitation Id
ramp_submit_draft_bill

Submit a DRAFT_READY bill draft so it becomes a bill and enters approval. Readiness requires at least one bill date, an active existing vendor with required bill-pay details, invoice currency, a positive amount, complete line items, required accounting fields, no duplicate vendor invoice number, and no submission-policy violation. The bill keeps the same ID as the draft. The call waits up to about 10 seconds for the bill to be created: creation_status is CREATED when the bill exists, or PENDING when creation is still running in the background. Some submissions require identity verification that agents cannot complete; in that case the error includes a redirect_url that the human user must open in a browser to finish submitting in the Ramp web app. This action does not schedule, release, or pay the bill.

Parameters and full description

Submit a DRAFT_READY bill draft so it becomes a bill and enters approval. Readiness requires at least one bill date, an active existing vendor with required bill-pay details, invoice currency, a positive amount, complete line items, required accounting fields, no duplicate vendor invoice number, and no submission-policy violation. The bill keeps the same ID as the draft. The call waits up to about 10 seconds for the bill to be created: creation_status is CREATED when the bill exists, or PENDING when creation is still running in the background. Some submissions require identity verification that agents cannot complete; in that case the error includes a redirect_url that the human user must open in a browser to finish submitting in the Ramp web app. This action does not schedule, release, or pay the bill. Submit only when the user has reviewed the draft and their current message clearly asks to submit that specific draft. A request to create, edit, or review a draft is not authorization to submit it.

ParameterTypeDescription
draft_bill_idrequiredstringUUID of the active DRAFT_READY bill draft to submit.
rationalerequiredstringRationale
ramp_update_draft_bill

Update a draft bill: its fields, line items, accounting category coding, and draft payment details. Requires the current draft version and returns the new version; stale updates are rejected with the current version. Omitted fields remain unchanged, while null intentionally clears a nullable field. A successful update returns whether the resulting draft is ready for submission and any missing required fields or submission-policy blockers. Tracking-category and option identifiers accept integer DB ids or resolvable UUID strings. Submitted drafts and drafts with retainage (withholding) are not supported.

Parameters and full description

Update a draft bill: its fields, line items, accounting category coding, and draft payment details. Requires the current draft version and returns the new version; stale updates are rejected with the current version. Omitted fields remain unchanged, while null intentionally clears a nullable field. A successful update returns whether the resulting draft is ready for submission and any missing required fields or submission-policy blockers. Tracking-category and option identifiers accept integer DB ids or resolvable UUID strings. Submitted drafts and drafts with retainage (withholding) are not supported.

ParameterTypeDescription
provisional_billrequiredobjectDraft bill fields to change, in the draft's `editable_payload` shape. Omitted fields are unchanged; null clears a nullable field. To change the payment method of a draft that has payments, also pass vendor_payments. An explicit payment_details.payment_date updates the single bank-transfer or check draft payment; null unschedules it. Changing other payment details or the bill total at the same time requires explicit vendor_payments. Split payments require explicit vendor_payments. When both date sources are supplied, their dates must agree.
provisional_bill_idrequiredstringUUID of the draft bill to update
rationalerequiredstringBriefly explain why you are calling this tool: what goal or workflow it serves and what you intend to do with the result.
versionrequiredstringExpected current draft version. A stale value is rejected and the error returns the latest version.
vendor_paymentsarray | nullDraft payments. Replaces all existing draft payments. Omit to leave them unchanged except for an explicit bill-level date edit. Null is accepted only alongside explicit payment_details.payment_date and does not remove payments.

Cards and funds

ramp_activate_card

Activate the acting user's own card by its last four digits.

Parameters and full description

Activate the acting user's own card by its last four digits. Only the cardholder can activate a card. Do not call this tool for another person's card (for example, an admin or manager asking to activate an employee's card, or a card listed with ListCards cardholder_user_uuid or can_activate=false); instead, tell the user the cardholder must activate it from their own Ramp account or the Ramp mobile app. If the card is a physical card awaiting delivery confirmation, call this tool first without confirm_delivery to detect the state, then call again with confirm_delivery=True after the user confirms the physical card has arrived.

ParameterTypeDescription
last_fourrequiredstringLast Four
rationalerequiredstringRationale
confirm_deliverybooleanConfirm Delivery
ramp_add_user_to_shared_fund

Add a human user or standalone agent to a shared fund as a member or co-owner. Provide user_email for a human or agent_id for a standalone agent; role defaults to MEMBER. Human users must finish joining Ramp before they can be added. Fund co-owners can add members, but cannot grant co-owner roles through co-owner access alone. Managers relying on management authority may only add users within their permitted scope. Enabling sharing is rejected without changes when approval is required.

Parameters and full description

Add a human user or standalone agent to a shared fund as a member or co-owner. Provide user_email for a human or agent_id for a standalone agent; role defaults to MEMBER. Human users must finish joining Ramp before they can be added. Fund co-owners can add members, but cannot grant co-owner roles through co-owner access alone. Managers relying on management authority may only add users within their permitted scope. Enabling sharing is rejected without changes when approval is required.

ParameterTypeDescription
rationalerequiredstringRationale
spend_allocation_uuidrequiredstringSpend Allocation Uuid
agent_idstring | nullAgent Id
enable_sharing_if_neededbooleanEnable Sharing If Needed
rolestringRole
user_emailstring | nullUser Email
ramp_archive_spend_allocation

Archive a fund to prevent spend and hide it from users. Use when an admin asks to

Parameters and full description

Archive a fund to prevent spend and hide it from users. Use when an admin asks to terminate, cancel, deactivate, shut off, close, delete, or remove funds or their vendor/virtual cards. Locks the fund's cards and stops spend; reversible.

ParameterTypeDescription
rationalerequiredstringRationale
spend_allocation_uuidrequiredstringSpend Allocation Uuid
ramp_edit_user_role_on_shared_fund

Change a shared-fund user's role between member and co-owner using user_email.

Parameters and full description

Change a shared-fund user's role between member and co-owner using user_email.

ParameterTypeDescription
new_rolerequiredstringNew Role
rationalerequiredstringRationale
spend_allocation_uuidrequiredstringSpend Allocation Uuid
user_emailrequiredstringUser Email
ramp_enable_shared_fund_access

Enable sharing on an existing fund so members can be added to it.

Parameters and full description

Enable sharing on an existing fund so members can be added to it. Use this when a user wants to turn an existing personal fund into a shared fund, or when adding a member requires sharing to be enabled first.

ParameterTypeDescription
rationalerequiredstringRationale
spend_allocation_uuidrequiredstringSpend Allocation Uuid
ramp_get_card_statement_balance

Get a snapshot of the business's most recent card statement balance —

Parameters and full description

Get a snapshot of the business's most recent card statement balance — how much was due, how much has been paid, what's still outstanding, and when the next payment is due. Use this when the user asks about their card statement balance, why they got a delinquency / outstanding balance notice after paying, what their remaining balance is, or how their last payment was applied. Common phrasings: "I paid X but still got an outstanding balance notice", "what's my statement balance", "why am I still showing a balance". Returns the most recent statement only. Doesn't include current-cycle (post-statement-close) charges — those are surfaced via separate transaction-listing tools when needed.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_get_funds

Retrieve funds (cards or budgets) and their balances, restrictions, locks, owners,

Parameters and full description

Retrieve funds (cards or budgets) and their balances, restrictions, locks, owners, or permitted spend. For a named person's funds, resolve their UUID with GetOrgChart and pass user_uuids. For the current user's funds, use MY_FUNDS. Search by fund name with search_by_fund_display_name or look up a known UUID with fund_uuid. Every fund includes balance_data. Treat its remaining amount as authoritative for cleared charges, pending authorizations, and applicable rollover. limit_amount excludes rollover; accrued_rollover_amount is the opening carry, already included in remaining_amount. Do not add rollover or subtract spending again. Never infer that a booking is included merely because it is confirmed: a postpaid booking with no charge or pending authorization is a future charge and has not yet reduced the remaining balance. A fund with a lock can't be spent from until it is unlocked, even though it is ACTIVE and keeps its remaining amount. Never present a locked fund as available; mention it separately with its lock reason, without quoting its remaining amount as money left unless the user asks what it holds once unlocked. A member lock blocks only that member.

ParameterTypeDescription
rationalerequiredstringRationale
agent_card_eligibleboolean | nullAgent Card Eligible
cursorstring | nullCursor
for_transaction_idstring | nullFor Transaction Id
fund_uuidstring | nullFund Uuid
fund_uuidsarray | nullFund Uuids
funds_to_retrievestring | nullScope of funds to retrieve. Use MY_FUNDS ONLY when the user explicitly asks about 'my funds'. Use ALL_FUNDS for general searches (e.g., searching by fund name) or when no specific owner is mentioned. NEVER use this parameter when the user mentions a specific person - use user_uuids instead.
include_membersbooleanInclude Members
include_restrictionsbooleanInclude Restrictions
is_sharedboolean | nullIs Shared
page_sizeintegerPage Size
primary_card_eligibleboolean | nullPrimary Card Eligible
search_by_fund_display_namestring | nullSearch By Fund Display Name
spend_intent_uuidsarray | nullSpend Intent Uuids
statestring | nullFilter funds by state. Use ACTIVE to show only active funds, TERMINATED for terminated funds, or ARCHIVED for archived funds. If not provided, returns funds in all states.
user_uuidsarray | nullUser Uuids
ramp_issue_one_off_funds

Issue one-off funds (spend allocations) directly, bypassing approval flows.

Parameters and full description

Issue one-off funds (spend allocations) directly, bypassing approval flows. Use this tool when an admin wants to create new funds for one or more users with a specific amount, interval, and optional restrictions. This creates virtual-card-only spend allocations outside of spend programs. The acting user must have the SPEND_ISSUE_SPEND_BYPASS_APPROVAL permission.

ParameterTypeDescription
amountrequiredstringAmount
display_namerequiredstringDisplay Name
rationalerequiredstringRationale
user_idsrequiredarrayUser Ids
categories_blacklistarray | nullCategories Blacklist
categories_whitelistarray | nullCategories Whitelist
default_member_limit_amountstring | nullDefault Member Limit Amount
department_idsarray | nullDepartment Ids
dynamic_user_group_idsarray | nullDynamic User Group Ids
entity_idstring | nullBusiness entity UUID to issue the funds under. The fund uses the entity's issuing currency. Defaults to each user's entity (or the business's primary entity) when omitted.
intervalstringInterval
is_shareablebooleanIs Shareable
location_idsarray | nullLocation Ids
lock_datestring | nullLock Date
member_idsarray | nullMember Ids
user_custom_field_idsarray | nullUser Custom Field Ids
vendor_blacklistarray | nullVendor Blacklist
vendor_whitelistarray | nullVendor Whitelist
ramp_limit_increase

Increase the spending limit on a fund (spend allocation) or card. Recurring funds support one time (resets at the next interval) and recurring increases. One-time funds always use permanent, even when temporary is supplied, without type confirmation. Does not support date-limited increases.

Parameters and full description

Increase the spending limit on a fund (spend allocation) or card. Recurring funds support one time (resets at the next interval) and recurring increases. One-time funds always use permanent, even when temporary is supplied, without type confirmation. Does not support date-limited increases. Call only when the user's current message clearly requests an increase for the specific fund or card and specifies temporary or permanent. A declined transaction, budget question, or currency correction is not authorization to increase a limit. Do not infer or default the increase type.

ParameterTypeDescription
amountrequirednumber | stringAmount
rationalerequiredstringRationale
actionstringAction
card_idstring | nullThe card ID whose limit should be increased. Must provide either this or spend_allocation_id, not both.
expected_current_limitnumber | string | nullExpected Current Limit
increase_typestringIncrease Type
reasonstring | nullReason
spend_allocation_idstring | nullThe spend allocation (fund) ID whose limit should be increased. Must provide either this or card_id, not both.
user_confirmed_increase_typebooleanUser Confirmed Increase Type
user_confirmed_limit_increasebooleanUser Confirmed Limit Increase
ramp_list_cards

List non-terminated cards for the current user or a visible target cardholder, including activation status, spendability, lock state, and shipping metadata. Results do not establish historical order cancellation.

Parameters and full description

List non-terminated cards for the current user or a visible target cardholder, including activation status, spendability, lock state, and shipping metadata. Results do not establish historical order cancellation.

ParameterTypeDescription
rationalerequiredstringRationale
cardholder_user_uuidstring | nullOptional user UUID for the cardholder whose cards should be listed. Provide this when an admin or manager asks about another employee's cards. Omit it to list the acting user's own cards.
ramp_lock_or_unlock_card

Lock or unlock a card the acting user is authorized to manage. Locking prevents all transactions on it until unlocked.

Parameters and full description

Lock or unlock a card the acting user is authorized to manage. Locking prevents all transactions on it until unlocked. Lock only when the user's current message clearly requests locking the specific card. Do not infer a lock request from suspicious activity. Unlocking does not require additional confirmation. If this returns FraudLockDetected, use UnlockFraudLockedCard instead.

ParameterTypeDescription
actionrequiredstringAction
idrequiredstringThe UUID of a card returned by ListCards with can_lock_or_unlock=true.
rationalerequiredstringRationale
ramp_lock_or_unlock_spend_allocation

Lock or unlock a fund (spend allocation) at the fund level, affecting all members.

Parameters and full description

Lock or unlock a fund (spend allocation) at the fund level, affecting all members. Lock only when the user's current message clearly requests locking the specific fund. Do not infer a fund lock from a declined transaction or budget discussion. Unlocking does not require additional confirmation.

ParameterTypeDescription
actionrequiredstringAction
idrequiredstringId
rationalerequiredstringRationale
ramp_lock_or_unlock_spend_allocation_member

Lock or unlock a specific member's access to a fund (spend allocation).

Parameters and full description

Lock or unlock a specific member's access to a fund (spend allocation). Lock only when the user's current message clearly requests locking the specific member's access to the specific fund. Do not infer a member lock from a declined transaction or suspicious activity. Unlocking does not require additional confirmation. If this returns FraudLockDetected, use UnlockFraudLockedCard instead.

ParameterTypeDescription
actionrequiredstringAction
idrequiredstringId
member_idrequiredstringMember Id
rationalerequiredstringRationale
ramp_remove_user_from_shared_fund

Remove a user from a shared fund using user_email.

Parameters and full description

Remove a user from a shared fund using user_email.

ParameterTypeDescription
rationalerequiredstringRationale
spend_allocation_uuidrequiredstringSpend Allocation Uuid
user_emailrequiredstringUser Email
ramp_submit_fund_request

Submit a new General Expenses or Virtual Card request for the signed-in user.

Parameters and full description

Submit a new General Expenses or Virtual Card request for the signed-in user. Requires a separate user confirmation after the assistant summarizes the request details and asks whether to submit. The initial request for funds is not confirmation. Never invent approval on the user's behalf. Returns the submitted request's detail URL, or the issued fund's URL when the request is automatically approved.

ParameterTypeDescription
amountrequiredstringAmount
descriptionrequiredstringDescription
frequencyrequiredstringHow often the spending limit resets. Prefer TOTAL (one-time, no reset) unless the user's request indicates recurring spending. Use a clearly specified recurring interval; clarify only when there is reason to suspect recurrence but its interval is unclear, or the context conflicts. Include the chosen frequency in the summary the user confirms.
namerequiredstringName
rationalerequiredstringRationale
user_confirmationrequiredstringUser Confirmation
currencystringISO 4217 currency code. Defaults to USD; do not ask the user to specify it unless they want a different currency.
request_typestringRequest Type
ramp_transfer_spend_allocation_ownership

Transfer ownership of a spend allocation using the current and new owners' emails. The new owner must be within the acting user's permitted scope. Transfers requiring approval are rejected without changes.

Parameters and full description

Transfer ownership of a spend allocation using the current and new owners' emails. The new owner must be within the acting user's permitted scope. Transfers requiring approval are rejected without changes.

ParameterTypeDescription
current_user_emailrequiredstringCurrent User Email
new_user_emailrequiredstringNew User Email
rationalerequiredstringRationale
spend_allocation_uuidrequiredstringSpend Allocation Uuid
ramp_unarchive_spend_allocation

Unarchive a fund so it becomes visible and spendable again.

Parameters and full description

Unarchive a fund so it becomes visible and spendable again.

ParameterTypeDescription
rationalerequiredstringRationale
spend_allocation_uuidrequiredstringSpend Allocation Uuid
ramp_unlock_fraud_locked_card

Unlock a card that was locked due to a suspicious transaction. Requires the user to confirm they recognize the flagged transaction.

Parameters and full description

Unlock a card that was locked due to a suspicious transaction. Requires the user to confirm they recognize the flagged transaction.

ParameterTypeDescription
idrequiredstringUUID of the fraud-locked card to unlock, e.g. from a card listing or the card_uuid in a decline remediation hint. Fund (spend allocation) UUIDs, transaction UUIDs, last-four digits, and placeholder values are not accepted.
rationalerequiredstringRationale
user_confirmed_fraud_whitelistbooleanUser Confirmed Fraud Whitelist
ramp_update_category_restrictions

Update spending category restrictions (whitelist or blacklist) on a single fund. Manages spend types (e.g., Restaurants, Travel), not individual merchants.

Parameters and full description

Update spending category restrictions (whitelist or blacklist) on a single fund. Manages spend types (e.g., Restaurants, Travel), not individual merchants.

ParameterTypeDescription
actionrequiredstringThe action to perform: 'add_to_whitelist' (restrict to only these categories), 'remove_from_whitelist', 'add_to_blacklist' (block these categories), or 'remove_from_blacklist'.
category_idsrequiredarrayCategory Ids
rationalerequiredstringRationale
spend_allocation_idrequiredstringSpend Allocation Id
ramp_update_fund_entity

Move existing funds (spend allocations) and their cards to a different business entity.

Parameters and full description

Move existing funds (spend allocations) and their cards to a different business entity. Each fund is updated independently and the result reports, per fund, the previous and new business entity or why the fund could not be moved, so partial failures are visible. Only future spend moves: past transactions stay on the previous business entity. The target business entity must issue in a currency compatible with the fund and its active cards, otherwise that fund is rejected. A fund already on the target business entity succeeds without changes. Applies the same permission and approval rules as editing the fund in Ramp; if the edit requires approval, the fund is reported as pending approval and is not moved yet.

ParameterTypeDescription
entity_idrequiredstringUUID of the business entity to move the funds to.
fund_idsrequiredarrayFund Ids
rationalerequiredstringRationale
ramp_update_merchant_restrictions

Update merchant restrictions (whitelist or blacklist) on a fund (spend allocation).

Parameters and full description

Update merchant restrictions (whitelist or blacklist) on a fund (spend allocation). - Add or remove merchants from the allowed merchants list (whitelist) - Add or remove merchants from the blocked merchants list (blacklist) Use this when a user wants to: - Allow specific merchants on a fund (add to whitelist) - Block specific merchants on a fund (add to blacklist) - Remove merchants from the allowed or blocked lists

ParameterTypeDescription
actionrequiredstringWhether to add or remove merchants from the list.
merchant_uuidsrequiredarrayMerchant Uuids
rationalerequiredstringRationale
restriction_typerequiredstringWhether to modify the allowed merchants (whitelist) or blocked merchants (blacklist).
spend_allocation_idrequiredstringSpend Allocation Id
ramp_update_spend_allocation_interval

Update only the spend interval for a spend allocation.

Parameters and full description

Update only the spend interval for a spend allocation.

ParameterTypeDescription
intervalrequiredstringNew spend interval (for example: DAILY, WEEKLY, MONTHLY, TOTAL)
rationalerequiredstringRationale
spend_allocation_uuidrequiredstringSpend Allocation Uuid

Other

ramp_agent_wallet_listEarly access

List policy versions for a standalone Agent Wallet

Parameters and full description

List policy versions for a standalone Agent Wallet

ParameterTypeDescription
agent_idrequiredstringStandalone agent ID returned by the list agents tool.
rationalerequiredstringWhy this MCP tool call is needed.
limitinteger | nullValue for limit.
ramp_api_key_spend

List provider API keys and their estimated spend

Parameters and full description

List provider API keys and their estimated spend

ParameterTypeDescription
from_daterequiredstringStart date of the requested period in UTC, inclusive. Must be on or after 2023-01-01. The period can span up to 365 days.
rationalerequiredstringWhy this MCP tool call is needed.
to_daterequiredstringEnd date of the requested period in UTC, exclusive. The period can span up to 365 days.
page_sizeinteger | nullNumber of results to return per page. Defaults to 20. Must be between 2 and 100.
providersarray | nullComma-separated providers to include. Omit to include all supported providers.
startstring | nullOpaque cursor returned in page.next from the previous page.
statusesarray | nullComma-separated current API key statuses to include. Omit to exclude terminated API keys.
ramp_askEarly access

Delegate a Ramp question or task to Ask Ramp, Ramp's own agent

Parameters and full description

Delegate a Ramp question or task to Ask Ramp, Ramp's own agent

ParameterTypeDescription
questionrequiredstringQuestion
rationalerequiredstringWhy this MCP tool call is needed.
idempotency_keystring | nullUnique idempotency key generated by the client. Must be a non-empty string of at most 255 characters.
wait_secondsintegerWait Seconds
ramp_audit_logs_list

Get audit log events

Parameters and full description

Get audit log events

ParameterTypeDescription
rationalerequiredstringWhy this MCP tool call is needed.
agent_namesarray | nullFilter by customer-visible agent labels that executed the action
event_actor_typesarray | nullFilter by audit log events of these actor types
event_typesarray | nullFilter by audit log events of these types
from_datestring | nullFilter by audit log events created at or after this date. start_time is accepted as a compatibility alias.
object_idstring | nullFilter by audit log events referencing this object ID (e.g. transaction_id, vendor_id, etc.). The resource name must also be provided when filtering by object ID.
page_sizeinteger | nullThe number of results to be returned in each page. The value must be between 2 and 100. If not specified, the default value 20 will be used.
resource_namestring | nullFilter by audit log events referencing this resource name. The object ID must also be provided when filtering by resource name.
startstring | nullThe ID of the last entity of the previous page, used for pagination to get the next page.
to_datestring | nullFilter by audit log events created at or before this date. end_time is accepted as a compatibility alias.
user_idsarray | nullFilter by audit log events attributed to these user IDs
ramp_award_sourcing_eventEarly access

Award the winning vendor for a sourcing event, deciding the event and

Parameters and full description

Award the winning vendor for a sourcing event, deciding the event and closing its current RFX. Prerequisites: grading must be complete on the current RFX, the event must not already be awarded or pending award approval, and the payee must be an active invited vendor on the RFX. When the business configures an award approval policy, the award routes through that approval workflow instead of awarding immediately (``submitted_for_approval`` is True and nothing is decided yet). After a direct award, use CreateDraftSpendRequestFromSourcingEvent to hand off into procurement.

ParameterTypeDescription
payee_uuidrequiredstringUUID of the winning vendor (payee) to award
rationalerequiredstringRationale
sourcing_event_idrequiredstringSourcing Event Id
ramp_close_sourcing_eventEarly access

Close (archive) a sourcing event without awarding a vendor.

Parameters and full description

Close (archive) a sourcing event without awarding a vendor. Closing cascades to every non-terminal child RFX: each is transitioned to CLOSED, which blocks further vendor submissions and grading and voids any outstanding e-sign envelopes. Closed events are hidden from default list views and become read-only. Use AwardSourcingEvent instead when a winning vendor should be selected.

ParameterTypeDescription
rationalerequiredstringRationale
sourcing_event_idrequiredstringSourcing Event Id
ramp_continueEarly access

Send a follow-up message to an Ask Ramp session

Parameters and full description

Send a follow-up message to an Ask Ramp session

ParameterTypeDescription
rationalerequiredstringWhy this MCP tool call is needed.
responserequiredstringResponse
session_idrequiredstringUnique identifier of the AskRamp session.
idempotency_keystring | nullUnique idempotency key generated by the client. Must be a non-empty string of at most 255 characters.
input_request_idstring | nullInput Request Id
wait_secondsintegerWait Seconds
ramp_create_client_financing_applicationEarly access

Create a new client business and a Ramp financing application that your accounting firm prepares on the client's behalf (an assisted application).

Parameters and full description

Create a new client business and a Ramp financing application that your accounting firm prepares on the client's behalf (an assisted application). Use this when an accounting firm wants to sign up a new client for Ramp. The firm is assigned to the new client business as Owner plus the requested roles, so the returned client business UUID can be used to act on that business when your firm has client data access through Ramp MCP. The client is not contacted and nothing is submitted: the application stays in preparation by the firm until the client is invited to review it. Before creating anything, the firm's existing clients are checked for a closely matching name; on a match, no client is created and the existing client's UUID is returned. Repeating a successful call therefore reports the client it created rather than creating another one.

ParameterTypeDescription
business_name_legalrequiredstringBusiness Name Legal
rationalerequiredstringRationale
allow_possible_duplicatebooleanAllow Possible Duplicate
ap_onlybooleanAp Only
business_emailstring | nullBusiness Email
business_websitestring | nullBusiness Website
firm_rolesarray | nullFirm Roles
idempotency_keystring | nullUnique idempotency key generated by the client. Must be a non-empty string of at most 255 characters.
ramp_create_draft_spend_request_from_sourcing_eventEarly access

Hand off an awarded sourcing event into procurement intake by drafting a

Parameters and full description

Hand off an awarded sourcing event into procurement intake by drafting a spend request pre-filled with the winning vendor's context. The draft is prefilled from the sourcing conversation, event details, and (when ``rfx_id`` is passed) the awarded vendor's RFX responses. The user reviews and submits the draft in procurement. ``payee_uuid`` defaults to the awarded vendor and ``spend_intent_uuid`` defaults to the backend's recommended spend program when omitted. This call runs LLM extraction and can take a while.

ParameterTypeDescription
rationalerequiredstringRationale
sourcing_event_idrequiredstringSourcing Event Id
payee_uuidstring | nullOptional vendor (payee) UUID for the spend request. Defaults to the sourcing event's awarded vendor.
rfx_idstring | nullRfx Id
spend_intent_uuidstring | nullOptional spend program UUID to draft under. Omit to let the backend pick the best-fit procurement spend program.
ramp_create_rfxEarly access

Create a DRAFT RFX questionnaire, optionally creating its parent sourcing

Parameters and full description

Create a DRAFT RFX questionnaire, optionally creating its parent sourcing event in the same call. Nothing is sent to vendors until the RFX is published. Use GetRFXDetail to review the created questionnaire and InviteVendorsToRFX to add vendors before publishing.

ParameterTypeDescription
namerequiredstringName
rationalerequiredstringRationale
sectionsrequiredarraySections
close_datestring | nullClose Date
descriptionstring | nullDescription
response_submission_deadlinestring | nullResponse Submission Deadline
rfx_typestringType of RFX: RFI (Request for Information), RFP (Request for Proposal), or RFQ (Request for Quotation)
sourcing_event_idstring | nullSourcing Event Id
sourcing_event_namestring | nullSourcing Event Name
ramp_daily_usage

List AI usage and estimated spend grouped by the requested dimensions

Parameters and full description

List AI usage and estimated spend grouped by the requested dimensions

ParameterTypeDescription
from_daterequiredstringStart date of the requested period in UTC, inclusive. The period can span up to 365 days.
rationalerequiredstringWhy this MCP tool call is needed.
to_daterequiredstringEnd date of the requested period in UTC, exclusive. The period can span up to 365 days.
group_byarray | nullComma-separated dimensions to group each day's rows by. Defaults to provider,model,product. Fields for dimensions that are not requested are null. When group_by includes user, the date range can span up to 31 days.
modelsarray | nullComma-separated exact provider model names to include. Omit to include all models.
page_sizeinteger | nullNumber of results to return per page. Defaults to 20. Must be between 2 and 100.
productsarray | nullComma-separated exact product names to include. Requires group_by to include product. Omit to include all products.
providersarray | nullComma-separated AI providers to include. Omit to include all providers.
startstring | nullOpaque cursor returned in page.next from the previous page.
ramp_delete_comment

Delete a comment you wrote on a Ramp object (transaction, bill, request, etc).

Parameters and full description

Delete a comment you wrote on a Ramp object (transaction, bill, request, etc). Only the comment's author can delete it. The comment is removed from the thread for everyone and cannot be restored.

ParameterTypeDescription
comment_uuidrequiredstringComment Uuid
rationalerequiredstringRationale
ramp_delete_spend_program

Delete (terminate) a spend program.

Parameters and full description

Delete (terminate) a spend program. Use this tool when an admin wants to permanently delete a spend program. If the program has linked funds (spend allocations), the caller must specify what to do with them via spend_intent_delete_action: - "terminate": Close all linked funds. - "transfer": Move funds to another spend program (requires transfer_to_spend_intent_uuid). - "detach": Unlink funds from the program but keep them active. - "bulk_lock": Lock all cards associated with linked funds (admin only). If the program has no linked funds, spend_intent_delete_action can be omitted.

ParameterTypeDescription
rationalerequiredstringRationale
spend_intent_uuidrequiredstringSpend Intent Uuid
spend_intent_delete_actionstring | nullAction to take for existing funds linked to this program. Required when the program has linked funds. Options: 'terminate' (close all funds), 'transfer' (move funds to another program — requires transfer_to_spend_intent_uuid), 'detach' (unlink funds but keep them active), 'bulk_lock' (lock all associated cards — admin only).
transfer_to_spend_intent_uuidstring | nullTransfer To Spend Intent Uuid
ramp_edit_comment

Replace the text of a comment you wrote on a Ramp object (transaction, bill, request, etc).

Parameters and full description

Replace the text of a comment you wrote on a Ramp object (transaction, bill, request, etc). Only the comment's author can edit it. The comment is marked as edited, and only newly mentioned users are notified.

ParameterTypeDescription
comment_uuidrequiredstringComment Uuid
messagerequiredstringMessage
rationalerequiredstringRationale
mention_user_uuidsarray | nullMention User Uuids
message_formatstringPLAIN_TEXT (default) saves the message as written. MARKDOWN renders standard Markdown: **bold**, *italic*, [link text](https://example.com), bullet and numbered lists; single line breaks are kept.
ramp_explain_spend_not_on_budget

Explain whether a transaction, bill, or reimbursement is counted on the acting user's active budget in Ramp Budgets and, if not, why. Returns the matched budget row when there is one, plus ranked reasons the spend is not (fully) counted, each with a suggested fix: no active budget, budget not started, spend dated outside the budget, a different period, uncoded spend, or coding that matches no budget row. Financial planning budgets are not included. This operation does not change data.

Parameters and full description

Explain whether a transaction, bill, or reimbursement is counted on the acting user's active budget in Ramp Budgets and, if not, why. Returns the matched budget row when there is one, plus ranked reasons the spend is not (fully) counted, each with a suggested fix: no active budget, budget not started, spend dated outside the budget, a different period, uncoded spend, or coding that matches no budget row. Financial planning budgets are not included. This operation does not change data.

ParameterTypeDescription
rationalerequiredstringRationale
spend_typerequiredstringWhich kind of spend item to check: transaction, bill, or reimbursement.
spend_uuidrequiredstringSpend Uuid
ramp_get

Fetch a statement

Parameters and full description

Fetch a statement

ParameterTypeDescription
rationalerequiredstringWhy this MCP tool call is needed.
statement_idrequiredstringValue for statement_id.
ramp_get_application_detailsEarly access

Get the Ramp financing application for the business you are acting on in more detail than its status: business and incorporation details, the applicant's name, and the completion status of each page and section.

Parameters and full description

Get the Ramp financing application for the business you are acting on in more detail than its status: business and incorporation details, the applicant's name, and the completion status of each page and section. The business can be your own, or a client business whose application your accounting firm prepares (an assisted application). Use this when the user asks what is incomplete. This does not change the application.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_get_application_invitesEarly access

List the pending and accepted invites to the Ramp financing application of the business you are acting on: who was invited as primary applicant or preparer, and whether they joined.

Parameters and full description

List the pending and accepted invites to the Ramp financing application of the business you are acting on: who was invited as primary applicant or preparer, and whether they joined. The business can be your own, or a client business whose application your accounting firm prepares (an assisted application). Use this when the user asks who has been invited or whether an invite is still pending. This does not send or change invites.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_get_application_statusEarly access

Get the status of the Ramp financing application for the business you are acting on: its stage, most recently saved step, and underwriting country.

Parameters and full description

Get the status of the Ramp financing application for the business you are acting on: its stage, most recently saved step, and underwriting country. The business can be your own, or a client business whose application your accounting firm prepares (an assisted application). Use this when the user asks where the application stands or what step comes next. This does not change the application.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_get_approval_chain_details

Fetch approval details for an approval instance or Blank Canvas execution.

Parameters and full description

Fetch approval details for an approval instance or Blank Canvas execution. Returns the recorded chain for one approval instance, not the policy template. It cannot answer policy-configuration or notification-delivery questions. Pass the selected workflow_execution_uuid for a Blank Canvas target. Blank Canvas nodes retain separate recorded approvals; projected future nodes may change, and the list does not imply sequential execution.

ParameterTypeDescription
rationalerequiredstringRationale
approval_instance_uuidstring | nullApproval Instance Uuid
workflow_execution_uuidstring | nullWorkflow Execution Uuid
ramp_get_authorized_businessesEarly access

Retrieve the list of businesses that the advisor console user is authorized to access.

Parameters and full description

Retrieve the list of businesses that the advisor console user is authorized to access. This tool returns all client businesses that the external firm (advisor console) user has been granted access to. Use this to understand which businesses the user can work with or to help them find a specific client. Supports filtering by business display name and pagination for large lists.

ParameterTypeDescription
rationalerequiredstringRationale
afterstring | nullAfter
business_name_filterstring | nullBusiness Name Filter
page_sizeintegerPage Size
ramp_get_bookings

Retrieve flight, hotel, and car rental booking summaries for the user. Optionally identify existing bookings by city, hotel name, flight airline, flight number, booking reference, or travel date. Filters for the same booking type combine with AND; mixed hotel- and flight-specific filters match each type independently. Matching entries are returned up to limit for caller disambiguation, except include_past may return up to limit upcoming and limit past entries per type. Returns confirmed bookings and pending requests ordered upcoming-first (soonest next booking first, then past most recent first), with unsuccessful requests available via include_failed; check the status field and call GetBookingDetails for one entry's detailed state.

Parameters and full description

Retrieve flight, hotel, and car rental booking summaries for the user. Optionally identify existing bookings by city, hotel name, flight airline, flight number, booking reference, or travel date. Filters for the same booking type combine with AND; mixed hotel- and flight-specific filters match each type independently. Matching entries are returned up to limit for caller disambiguation, except include_past may return up to limit upcoming and limit past entries per type. Returns confirmed bookings and pending requests ordered upcoming-first (soonest next booking first, then past most recent first), with unsuccessful requests available via include_failed; check the status field and call GetBookingDetails for one entry's detailed state.

ParameterTypeDescription
rationalerequiredstringRationale
booking_referencestring | nullBooking Reference
citystring | nullCity
flight_airlinestring | nullFlight Airline
flight_numberstring | nullFlight Number
hotel_namestring | nullHotel Name
include_carsbooleanInclude Cars
include_failedbooleanInclude Failed
include_flightsbooleanInclude Flights
include_hotelsbooleanInclude Hotels
include_pastbooleanInclude Past
limitintegerLimit
travel_datestring | nullTravel Date
traveler_user_idstring | nullOptional UUID of another user whose bookings to retrieve, such as a person the acting user is a delegate for. Defaults to the acting user. Results are scoped to bookings the acting user is authorized to view; an unauthorized lookup returns empty lists.
verification_modebooleanVerification Mode
ramp_get_business_statement_date

Get the business's statement billing schedule: the next statement close date, the configured statement close day of month, and the next card payment or autopay debit date

Parameters and full description

Get the business's statement billing schedule: the next statement close date, the configured statement close day of month, and the next card payment or autopay debit date

ParameterTypeDescription
rationalerequiredstringValue for rationale.
ramp_get_decline_explanation

Get a detailed explanation of why a card transaction was declined. Returns the reason, remediation actions, user notification, and transaction details. Only valid for already-declined transactions.

Parameters and full description

Get a detailed explanation of why a card transaction was declined. Returns the reason, remediation actions, user notification, and transaction details. Only valid for already-declined transactions.

ParameterTypeDescription
rationalerequiredstringRationale
transaction_uuidrequiredstringThe UUID of the declined transaction
ramp_get_delegated_travelers

List the people the acting user can book, cancel, and change travel for.

Parameters and full description

List the people the acting user can book, cancel, and change travel for. The same list Ramp Travel offers when booking for someone else: a travel manager can find anyone in the company; everyone else finds the people who made them their delegate (assistant). Returns each person's user UUID for booking, cancellation, modification, and booking lookups. Read-only. Use it to answer "who can I book travel for?" or "who am I a delegate or assistant for?" with the actual people, not general guidance.

ParameterTypeDescription
rationalerequiredstringRationale
name_searchstring | nullName Search
ramp_get_erp_connection_status

Get the current ERP/accounting integration connection status for the business.

Parameters and full description

Get the current ERP/accounting integration connection status for the business. Returns whether an ERP is connected, which provider it is, and what the business selected during onboarding. Use this to understand the user's ERP context before guiding them through setup or troubleshooting. Can be called multiple times to re-verify connection status after the user completes OAuth.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_get_expense_workflow_context

Resolve a transaction or reimbursement UUID to its approval workflow context: the expense summary, its approval chain steps and approvers, the attached approval and submission policies, any travel booking approval, and the latest Policy Agent review. Provide exactly one expense UUID. Current state and the latest review do not establish the original routing cause. Does not support bills.

Parameters and full description

Resolve a transaction or reimbursement UUID to its approval workflow context: the expense summary, its approval chain steps and approvers, the attached approval and submission policies, any travel booking approval, and the latest Policy Agent review. Provide exactly one expense UUID. Current state and the latest review do not establish the original routing cause. Does not support bills.

ParameterTypeDescription
rationalerequiredstringRationale
reimbursement_uuidstring | nullReimbursement UUID or reimbursement alias to inspect. Provide exactly one expense reference.
transaction_uuidstring | nullTransaction UUID or transaction alias to inspect. Provide exactly one expense reference.
ramp_get_missing_items_by_user

Get transactions with missing items (receipts or memos) grouped by user. Returns a paginated list of users you are allowed to view who have outstanding missing items, along with sample transactions. Use get-transaction-missing-items for per-transaction detail.

Parameters and full description

Get transactions with missing items (receipts or memos) grouped by user. Returns a paginated list of users you are allowed to view who have outstanding missing items, along with sample transactions. Use get-transaction-missing-items for per-transaction detail.

ParameterTypeDescription
rationalerequiredstringRationale
only_missing_receiptbooleanOnly Missing Receipt
page_cursorstring | nullPage Cursor
page_sizeintegerPage Size
user_limitintegerUser Limit
ramp_get_office_locations

Retrieve the company's office locations and addresses. Use this to find office addresses when searching for hotels near an office or determining travel destinations.

Parameters and full description

Retrieve the company's office locations and addresses. Use this to find office addresses when searching for hotels near an office or determining travel destinations. The two shapes are complementary: ``office_locations`` has coordinates but no street address, and ``company_address`` has a street address but no coordinates.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_get_pending_request_itemsEarly access

Get the follow-up items, such as documents, that Ramp requested for the financing application of the business you are acting on and that are not yet resolved.

Parameters and full description

Get the follow-up items, such as documents, that Ramp requested for the financing application of the business you are acting on and that are not yet resolved. The business can be your own, or a client business whose application your accounting firm prepares (an assisted application). Use this when the user asks what documents or follow-up items are outstanding. This does not change or submit any item.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_get_planning_budgetEarly access

Read the business's planning budget: its lines, dimensions, and owners.

Parameters and full description

Read the business's planning budget: its lines, dimensions, and owners. Optionally includes per-period amounts or totals over a month range. A business has one planning budget. Lines are grouped by their values in dimension order: each prefix is a group, a skipped dimension shows as "Unknown", and a line whose values are a group's is that group's "Other". Nodes are addressed by path, such as "Engineering > Software". Line owners come from their selected dimension values; they are not assigned directly to lines. Each line's amounts are its own; a group's amounts total the lines under it. Amounts are omitted unless requested, to keep large budgets small. Setting either totals month returns each line's planned, actual, committed, and remaining totals over that range, with an open side extending to the budget's edge. Filter to a group or line and everything under it, or to nodes with a dimension value, and page through large budgets; `total_lines` counts every match. Fails if the business has no planning budget yet.

ParameterTypeDescription
rationalerequiredstringRationale
cursorstring | nullCursor
dimension_valueobject | nullReturns only groups and lines whose own values include this value; nodes above and below them are not added. The dimension must be selected by the budget.
include_amountsbooleanInclude Amounts
line_path_prefixstring | nullLine Path Prefix
page_sizeintegerPage Size
totals_from_monthstring | nullTotals From Month
totals_to_monthstring | nullTotals To Month
ramp_get_planning_dimensionsEarly access

Read all active business-wide budget dimensions, values, rules, and owners.

Parameters and full description

Read all active business-wide budget dimensions, values, rules, and owners. Returns names and stable UUIDs, including the complete condition expressions. These definitions are shared across budgets, not inferred from line names. No planning budget is required. This operation does not change data.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_get_remaining_budget_amount

Get the budgeted, actual, committed, and remaining amounts for the acting user's active budget in Ramp Budgets, for either the whole budget (period_scope='full', the default) or only the current period (period_scope='current'). Pass entity to scope the answer to one budget row, such as a department or category. When the name matches several rows, the result lists candidate rows; call again with row_number set to the chosen row. Financial planning budgets are not included.

Parameters and full description

Get the budgeted, actual, committed, and remaining amounts for the acting user's active budget in Ramp Budgets, for either the whole budget (period_scope='full', the default) or only the current period (period_scope='current'). Pass entity to scope the answer to one budget row, such as a department or category. When the name matches several rows, the result lists candidate rows; call again with row_number set to the chosen row. Financial planning budgets are not included.

ParameterTypeDescription
rationalerequiredstringRationale
entitystring | nullEntity
period_scopestringTime scope to report remaining budget for. Pick exactly one scope per call. Use 'full' (default) for the entire budget across its whole duration, e.g. when the user asks generally 'what is remaining in my budget'. Use 'current' for only the current period (this month/quarter/year), e.g. when the user asks 'what's remaining this month'. Only issue a second call with the other scope when the user explicitly asks to compare the full budget and the current period.
row_numberinteger | nullRow Number
ramp_get_resultEarly access

Get the current result of an Ask Ramp session

Parameters and full description

Get the current result of an Ask Ramp session

ParameterTypeDescription
rationalerequiredstringWhy this MCP tool call is needed.
session_idrequiredstringUnique identifier of the AskRamp session.
wait_secondsinteger | nullValue for wait_seconds.
ramp_get_rfx_detailEarly access

Get the full configuration of one RFX: questionnaire sections and fields,

Parameters and full description

Get the full configuration of one RFX: questionnaire sections and fields, cover sheet, pricing sheet, dates, vendor invitations with contacts, and the actions the acting user can currently perform. Use this to inspect or review a specific RFX before editing, inviting vendors, or publishing. The ``available_actions`` block is the publish preflight: it reports whether publish (and every other lifecycle action) is currently allowed and why not, and the ``vendors`` block lists the exact contacts who would be notified on publish. For response contents or grading state, use GetRFXVendorResponses, GetRFXResponseSummary, or GetRFXGradingOverview instead.

ParameterTypeDescription
rationalerequiredstringRationale
rfx_idrequiredstringRfx Id
ramp_get_rfx_grading_overviewEarly access

Get grading outcomes for an RFX: AI-generated grading insights and

Parameters and full description

Get grading outcomes for an RFX: AI-generated grading insights and recommendations, per-vendor per-section grading status and aggregate scores, and any recorded field grades. Use this after grading wraps up to compare how vendors scored. The overview is only viewable once the RFX is GRADED or CLOSED; before that this tool reports it as unavailable. For the raw submitted answers, use GetRFXVendorResponses; for response and invitation progress counts, use GetRFXResponseSummary.

ParameterTypeDescription
rationalerequiredstringRationale
rfx_idrequiredstringRfx Id
ramp_get_rfx_response_summaryEarly access

Summarize vendor response and grading progress for a specific RFX.

Parameters and full description

Summarize vendor response and grading progress for a specific RFX.

ParameterTypeDescription
rationalerequiredstringRationale
rfx_idrequiredstringRfx Id
ramp_get_sourcing_event_contextEarly access

Get a compact summary of a sourcing event, its RFXs, and invited vendors.

Parameters and full description

Get a compact summary of a sourcing event, its RFXs, and invited vendors.

ParameterTypeDescription
rationalerequiredstringRationale
sourcing_event_idrequiredstringSourcing Event Id
ramp_get_user_trips

Fetch trips for the acting user with optional filters.

Parameters and full description

Fetch trips for the acting user with optional filters.

ParameterTypeDescription
rationalerequiredstringRationale
cursorstring | nullCursor
page_sizeinteger | nullPage Size
statusstring | nullStatus
ramp_hold

Place a hold on a vendor

Parameters and full description

Place a hold on a vendor

ParameterTypeDescription
rationalerequiredstringWhy this MCP tool call is needed.
vendor_idrequiredstringUnique identifier of the vendor.
reasonstring | nullReason
ramp_hold_release

Release Vendor Hold

Parameters and full description

Release Vendor Hold

ParameterTypeDescription
rationalerequiredstringWhy this MCP tool call is needed.
vendor_idrequiredstringUnique identifier of the vendor.
ramp_invite_client_to_review_financing_applicationEarly access

Email a client an invite to review the Ramp financing application your accounting firm prepared for it (an assisted application).

Parameters and full description

Email a client an invite to review the Ramp financing application your accounting firm prepared for it (an assisted application). Run this on the client business, not your firm's own business. The invite goes to the person who will be the client's primary applicant. After accepting, the client reviews and completes the application; until then it stays in preparation by your firm. An application has one primary applicant invite: if the client was already invited or has joined, no new invite is sent.

ParameterTypeDescription
first_namerequiredstringFirst Name
invitee_emailrequiredstringInvitee Email
last_namerequiredstringLast Name
partner_setup_enabledrequiredbooleanPartner Setup Enabled
rationalerequiredstringRationale
ramp_issue_from_spend_program

Issue spend allocations from an existing spend program.

Parameters and full description

Issue spend allocations from an existing spend program. Use this tool when an admin wants to issue allocations from a spend program to directly named users, or to users matched by location, department, user custom field, and dynamic user group targeting.

ParameterTypeDescription
rationalerequiredstringRationale
spend_intent_uuidrequiredstringSpend Intent Uuid
department_idsarray | nullDepartment Ids
display_namestring | nullDisplay Name
dynamic_user_group_idsarray | nullDynamic User Group Ids
issue_to_all_usersbooleanIssue To All Users
location_idsarray | nullLocation Ids
lock_datestring | nullLock Date
spend_amountstring | nullSpend Amount
spend_currencystring | nullCurrency code to use when issuing from a custom spend intent. Only required for custom spend intents; omit for fixed spend intents.
spend_intervalstring | nullCustom spend interval to use when issuing from a custom spend intent. Only required for custom spend intents; omit for fixed spend intents.
user_custom_field_idsarray | nullUser Custom Field Ids
user_idsarray | nullUser Ids
ramp_list_budgets

List the business's budgets in Ramp Budgets. Returns only the active budget by default; set include_inactive to also return historical budgets. Each budget includes its name, active state, time interval, and Ramp link. Financial planning budgets are not included.

Parameters and full description

List the business's budgets in Ramp Budgets. Returns only the active budget by default; set include_inactive to also return historical budgets. Each budget includes its name, active state, time interval, and Ramp link. Financial planning budgets are not included.

ParameterTypeDescription
rationalerequiredstringRationale
include_inactivebooleanInclude Inactive
ramp_list_business_entities

List business entities in the current business.

Parameters and full description

List business entities in the current business. Returns each entity's ID, name, primary flag, and registration country. Use this to resolve the current business's legal entity by name or to find a business entity ID. Pass name_filter when resolving entity references in requests and attachments.

ParameterTypeDescription
rationalerequiredstringRationale
name_filterstring | nullName Filter
ramp_list_planning_budget_spendEarly access

List the spend items behind the planning budget's actual and committed amounts.

Parameters and full description

List the spend items behind the planning budget's actual and committed amounts. Filter to a line, a group and every line under it, or to unassigned spend: spend in the budget's scope that no line matched. Reflects the last recalculation, so very recent spend may be missing. Items do not include tracking category selections. Fails if the business has no planning budget yet.

ParameterTypeDescription
rationalerequiredstringRationale
amount_typestring | null—
cursorstring | nullCursor
from_monthstring | nullFrom Month
line_pathstring | nullLine Path
page_sizeintegerPage Size
sort_bystring—
sort_directionstringSort Direction
to_monthstring | nullTo Month
unassigned_onlybooleanUnassigned Only
ramp_list_policies

List workflow-backed submission, approval, and spend-request policies for the business, with each policy's UUID, kind, spend type, default status, and workflow availability. Returns policy metadata only, not written policy document text. Call first when the target policy UUID isn't known, then use get-policy-details or get-policy-workflow-body.

Parameters and full description

List workflow-backed submission, approval, and spend-request policies for the business, with each policy's UUID, kind, spend type, default status, and workflow availability. Returns policy metadata only, not written policy document text. Call first when the target policy UUID isn't known, then use get-policy-details or get-policy-workflow-body.

ParameterTypeDescription
rationalerequiredstringRationale
kindsarray | nullKinds
ramp_list_sourcing_eventsEarly access

List sourcing events visible to the acting user.

Parameters and full description

List sourcing events visible to the acting user. Use this first when the user refers to an existing sourcing event but you do not yet know which one they mean. The output is intentionally compact so the model can match event names, owners, and current RFX details itself. Events in every lifecycle status are available across pages, including CLOSED events, so the agent can still find an event the user already finished running.

ParameterTypeDescription
rationalerequiredstringRationale
page_cursorstring | nullPage Cursor
page_sizeintegerPage Size
ramp_manage_rfx_collaboratorsEarly access

Add and/or remove collaborators on an existing RFX (RFI, RFP, or RFQ).

Parameters and full description

Add and/or remove collaborators on an existing RFX (RFI, RFP, or RFQ). Collaborators can edit the RFX form and vendor list while it is in DRAFT and grade vendor responses once it is PUBLISHED. Identify each collaborator by their user UUID — use `LookupUser` or `GetOrgChart` to resolve a person's name to their UUID first. Both `add_user_uuids` and `remove_user_uuids` are optional; supply either or both. Adding a user who is already a collaborator is a no-op. To apply the same collaborators across several RFXs (for example multiple RFIs in one sourcing event), call this tool once per RFX with the same user UUIDs.

ParameterTypeDescription
rationalerequiredstringRationale
rfx_idrequiredstringUUID of the RFX to modify collaborators on
add_user_uuidsarray | nullAdd User Uuids
remove_user_uuidsarray | nullRemove User Uuids
ramp_mark_rfx_gradedEarly access

Mark a PUBLISHED RFX as graded, which unlocks awarding.

Parameters and full description

Mark a PUBLISHED RFX as graded, which unlocks awarding. Requires at least one submitted vendor response. Moves the RFX from PUBLISHED to GRADED so the sourcing event can be awarded.

ParameterTypeDescription
rationalerequiredstringRationale
rfx_idrequiredstringRfx Id
ramp_merchant_list

List merchants

Parameters and full description

List merchants

ParameterTypeDescription
rationalerequiredstringWhy this MCP tool call is needed.
merchant_namestring | nullFilter merchants by a case-sensitive display name prefix.
merchant_urlstring | nullFilter merchants by URL or domain after normalization.
page_sizeinteger | nullThe number of results to be returned in each page. The value must be between 2 and 100. If not specified, the default value 20 will be used.
startstring | nullThe ID of the last entity of the previous page, used for pagination to get the next page.
transaction_from_datestring | nullFilter merchants by transactions occurring (`user_transaction_time`) on or after this date
transaction_to_datestring | nullFilter merchants by transactions occurring (`user_transaction_time`) on or before this date
ramp_mpp_creds

Issue or recover a Stripe MPP credential using an existing fund

Parameters and full description

Issue or recover a Stripe MPP credential using an existing fund

ParameterTypeDescription
fund_idrequiredstringUUID of the existing fund to pay from
rationalerequiredstringWhy this MCP tool call is needed.
www_authenticaterequiredarrayWww Authenticate
body_digeststring | nullBody Digest
idempotency_keystring | nullUnique idempotency key generated by the client. Must be a non-empty string of at most 255 characters.
selected_challenge_idstring | nullSelected Challenge Id
ramp_publish_rfxEarly access

Publish an RFX, sending it externally to every ACTIVE invitation contact.

Parameters and full description

Publish an RFX, sending it externally to every ACTIVE invitation contact. Publishing notifies vendors outside Ramp, so check GetRFXDetail first: its ``available_actions`` publish entry reports whether publish is currently allowed (and why not), and its ``vendors`` block lists the exact contacts who will be notified. When a publish approval policy is configured, the RFX moves to IN_REVIEW instead and nothing is sent to vendors yet — the approval then proceeds with the designated approvers in the Ramp app, and the RFX publishes automatically once approved. Calling publish again while pending approval or already published fails cleanly.

ParameterTypeDescription
rationalerequiredstringRationale
rfx_idrequiredstringRfx Id
ramp_reporting_describe_datasetEarly access

Describe one semantic reporting dataset in detail.

Parameters and full description

Describe one semantic reporting dataset in detail. Use this after selecting a dataset name to inspect its dimensions, measures, default time dimensions, sample questions, join-reachable fields, and related-record roles with their role-qualified fields (for example `spender.email`) before constructing a ReportQuery.

ParameterTypeDescription
namerequiredstringName
rationalerequiredstringRationale
ramp_reporting_get_skillEarly access

Return the Ramp reporting skill: the required workflow for answering analytical questions (totals, trends, top-N, comparisons, breakdowns) and canonical ERP balance sheets, income statements, and trial balances. Describes dataset-driven workflows; cached guidance does not establish dataset access or historical coverage.

Parameters and full description

Return the Ramp reporting skill: the required workflow for answering analytical questions (totals, trends, top-N, comparisons, breakdowns) and canonical ERP balance sheets, income statements, and trial balances. Describes dataset-driven workflows; cached guidance does not establish dataset access or historical coverage.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_reporting_list_datasetsEarly access

List semantic reporting datasets available to the current user. Use this before building a semantic reporting query when you need to know which datasets exist and how each dataset is described at a high level.

Parameters and full description

List semantic reporting datasets available to the current user. Use this before building a semantic reporting query when you need to know which datasets exist and how each dataset is described at a high level.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_reporting_lookup_search_tagsEarly access

Look up search tags for filtering reports.

Parameters and full description

Look up search tags for filtering reports. Search tags are used to filter report data by various criteria such as: - Users (employees) - Vendors/Merchants - Departments - Locations - Tracking category options (custom accounting dimensions) Use this tool when you need to find specific entities to use as filters in a report. This is typically used before creating or modifying a report to find the correct search tag IDs.

ParameterTypeDescription
lookup_requestsrequiredarrayLookup Requests
rationalerequiredstringRationale
contextstring | nullContext
data_sourcestring | nullThe report data source (e.g., SPEND_OLAP, CROSS_BUSINESS_OLAP), not the entity being searched: employee/fund lookups for spend reports still use SPEND_OLAP, not USERS or SPEND_PROGRAMS. Only AI-reporting sources accessible to the user are supported. Required for cross-business search tag lookups. When a lookup request omits `categories`, the default category set is resolved from this data source (SPEND_OLAP when omitted). Pass the data source of the report you are building.
ramp_reporting_queryEarly access

Query reporting data and return aggregate or individual-record rows.

Parameters and full description

Query reporting data and return aggregate or individual-record rows. Use for analysis or validation. Does not save reports. Use exact catalog dimension/measure names and kinds, not display labels. For SQL, groupable=false (also needs.groupable=false) detail fields need dimensions without measures; query totals separately. Catalog filters need filterable=true, ops from supported_filter_ops, and values matching filter_value_kind. Search tags need resolved IDs with original types, not names. Financial-statement datasets accept `statement.time_window`, optional provider-dimension `statement.filters`, and a response-size `limit`. They return fixed, canonically ordered account and calculated-total rows with provider currency and publication metadata. These overlapping rows must not be summed. SQL controls, comparisons, and top-N scope are unsupported; missing or changed ledger publications return a failed-precondition error. For SQL datasets, a `filters` clause whose `field` is a catalog field is a row predicate; one whose `field` is a selected measure output name (its `name` alias when present) is the preferred aggregate predicate and applies after grouping (HAVING), e.g. `{"field": "txn_count", "op": "gt", "value": 3}`. `having` and `aggregate_filters` remain supported equivalents, but are deprecated and migrated into `filters`; `result_metadata.predicate_migration` records the migration. Order by any selected orderable dimension or measure output. For complete SQL results, set `page_size` (1–1,000) to paginate. Pass `response.table.page.next` as `start` with the same `report_query`, `query_scope`, and `page_size` until it is null. Pages read live data, not a snapshot. Financial statements and `second_stage` / `post_aggregation` queries do not support pagination. A measure ref may carry its own `filters` plus a unique `name` to emit a conditional aggregate column ("sumIf"). Select the same measure several times with different filters for side-by-side cohort columns, e.g. one spend total per category grouped by user, including an "other" column via a NOT_IN filter. Measure filters use the same field/op/value shape as query filters but only base-dataset fields. A catalog entry with non-empty `aggregations` also accepts a ref with `agg` (`type` from `aggregations`) and a required `name`. If `covered_by` lists a measure for that agg, select that measure instead. Use `second_stage` whenever the question aggregates per-group results again (days/months/vendors per X, average monthly spend per X, highest or lowest month per X, users over $X per month): retain `dimensions` and compute `measures`, each `{"agg": SUM|AVG|MIN|MAX|COUNT, "of": <first-stage measure output name or null>, "name"}`, across the collapsed groups, instead of post-processing first-stage rows yourself. COUNT without `of` counts groups that survive the aggregate predicates (a measure-output `filters` clause or the deprecated forms, which migrate like any other query); only a stage made solely of such counts needs a predicate, so never add a threshold just to satisfy it when SUM/AVG/MIN/MAX or COUNT of an operand is present. For example, select user plus `{"field": "spend_date", "time_grain": "day"}`, filter daily_spend over $500, then use `{"dimensions": ["user"], "measures": [{"agg": "COUNT", "name": "days_over_limit"}]}`; retain `spend_date` instead to count users over the threshold per day or month. For average monthly spend per vendor, select vendor and month with `{"measure": "amount", "name": "monthly_spend"}` and use `{"agg": "AVG", "of": "monthly_spend", "name": "avg_monthly_spend"}`: an average of monthly totals over the months that have spend (a month with no rows is not a zero), so present it as an average per active month or add a COUNT of months; MIN/MAX of the same operand give each vendor's lowest and highest month. Operands must be selected first-stage measure outputs (aliases allowed), never window measures. Order by retained dimensions or stage names only; `limit` applies to the final rows; no `totals`. Use user with amount for employee spend; only per-diem or meal questions need attendee with amount_per_attendee, which allocates across Ramp employee attendees only (external attendees are excluded) and falls back to the spending employee when no attendee list exists. Keep the daily grain so day counts are by UTC calendar day. `post_aggregation` (`{"dimension", "name"}`) is the deprecated equivalent of a single COUNT stage; do not use it for new queries. Use `max_groups` for K named values plus Other independently on every selected non-time dimension, retaining all time buckets. Set `ranking_order_by` to selected first-stage measure scores. When the time range is omitted, ranking covers all authorized data. Display `order_by` is separate. Omit `limit`; without `page_size`, ranked results have a 1,000-row cap disclosed through result_metadata.is_truncated. Ranking cannot combine with aggregate predicates or second_stage. Covers Ramp data and canonical financial statements from authorized connected ERP books. Data is eventually consistent (may lag a few minutes).

ParameterTypeDescription
rationalerequiredstringRationale
report_queryrequiredobjectSemantic ReportQuery to execute using the dataset's catalog contract. SQL datasets require at least one dimension or measure. Canonical financial statements require statement parameters instead of field selections.
page_sizeinteger | nullPage Size
query_scopestring | nullResult-set scope. Use complete for all, each, every, or otherwise unrestricted results. Omit report_query.limit; complete overrides any supplied flat limit and uses 1000 rows per response unless page_size enables pagination. Use complete with max_groups; it preserves per-dimension ranking. Use top_n only when the user explicitly requested exactly N rows, and set report_query.limit to that N. Financial statements do not support top_n; complete preserves their canonical order. Omission preserves the query limit.
startstring | nullStart
ramp_reporting_search_catalogEarly access

Search the semantic reporting catalog with a natural-language query.

Parameters and full description

Search the semantic reporting catalog with a natural-language query. Use this when a user describes a reporting question in plain English and you need to choose the best semantic dataset and relevant fields.

ParameterTypeDescription
nl_queryrequiredstringNl Query
rationalerequiredstringRationale
limitintegerLimit
ramp_resolve_approval_target

Resolve and cross-check an approval UUID, entity reference, or Ramp URL.

Parameters and full description

Resolve and cross-check an approval UUID, entity reference, or Ramp URL. Every supplied locator is authoritative: each must independently parse and identify the same target, so omit incidental context. Pass full URLs without extracting their UUID. The resolver never fetches the page. It locates recorded approval-chain instances for a specific item; it does not look up policy configuration.

ParameterTypeDescription
rationalerequiredstringRationale
approval_instance_uuidstring | nullApproval Instance Uuid
entity_typestring | nullUNIFIED_REQUEST resolves a unified-request ID, falling back to a spend-request UUID. SPEND_REQUEST requires a spend-request UUID.
entity_uuidstring | nullEntity Uuid
history_requestedbooleanHistory Requested
page_urlstring | nullPage Url
workflow_execution_uuidstring | nullWorkflow Execution Uuid
ramp_return_rfx_to_draftEarly access

Return a REJECTED RFX to DRAFT so it can be edited and re-published.

Parameters and full description

Return a REJECTED RFX to DRAFT so it can be edited and re-published. Only valid after a publish approval was rejected. The rejected approval workflow is terminated and the RFX becomes editable again.

ParameterTypeDescription
rationalerequiredstringRationale
rfx_idrequiredstringRfx Id
ramp_roles

List custom roles

Parameters and full description

List custom roles

No parameters exposed in the tool schema.

ramp_search_flights

Searches flights for a route and dates. Returns policy-tagged offers, or a job_id while the search is still running. To book, use the selected offer's id.

Parameters and full description

Searches flights for a route and dates. Returns policy-tagged offers, or a job_id while the search is still running. To book, use the selected offer's id. Pass either route fields or job_id, not both. A job_id call reads the existing search without starting a new one. Round trips return outbound offers first; pass job_id with outbound_offer_id to get matching return offers. Preferences persist on the job until changed or cleared. When a flight credit may apply to the fare an offer's id books, the offer shows the largest such credit in top_airline_credit; fare options list their own eligible_credit_ids. Does not modify existing bookings.

ParameterTypeDescription
rationalerequiredstringRationale
additional_arrivalsarray | nullAdditional Arrivals
additional_departuresarray | nullAdditional Departures
airlinesarray | nullAirlines
arrivalstring | nullArrival
avoid_red_eye_flightsboolean | nullAvoid Red Eye Flights
cabin_classstring | array | nullCabin Class
clear_preferencesarray | nullClear Preferences
cursorstring | nullCursor
departurestring | nullDeparture
departure_datestring | nullDeparture Date
include_fare_optionsbooleanInclude Fare Options
include_recommendationsbooleanInclude Recommendations
job_idstring | nullID of an existing search, from a previous response. Use it to get results, page, re-rank, or fetch return flights. Omit it to start a new search.
limitintegerLimit
max_stopsinteger | nullMax Stops
only_airline_credit_eligibleboolean | nullOnly Airline Credit Eligible
only_split_ticketsboolean | nullOnly Split Tickets
outbound_offer_idstring | nullOutbound offer id, used with job_id to fetch matching return offers. A nested fare option's id may be passed as outbound_offer_id to preserve its cabin and fare on the returns; this needs include_fare_options=true. The chosen return offer's id books the full itinerary.
preferred_airlinesarray | nullPreferred Airlines
preferred_arrival_time_windowstring | nullArrival time preference for the current leg, such as morning, afternoon, or evening. On an outbound_offer_id read, it applies to return offers.
preferred_connectivitystring | nullSoft preference for 'wifi' or 'starlink'. Favors flights with stronger connectivity evidence among comparable recommendations (at most 10% more expensive and 30 minutes longer); never excludes flights with unknown connectivity. Historical Starlink is an estimate. Requires the flight connectivity feature.
preferred_departure_time_windowstring | nullDeparture time preference for the current leg, such as morning, afternoon, or evening. On an outbound_offer_id read, it applies to return offers.
presentationobject | nullOn a job_id read (outbound, or return with outbound_offer_id), returns exactly these offers from that view as the recommendations.
requested_weekdaystring | nullWeekday the traveler asked to depart, for a relative day like 'next Friday'. The search is rejected if departure_date does not fall on it.
required_upgrade_cabin_classstring | nullOnly return itineraries whose cached fare inventory shows at least one seat in this cabin on every segment. Reflects observed inventory, not a guaranteed upgrade; a count of 0 or a missing count does not qualify.
resume_job_idstring | nullLegacy alias for job_id when resuming or paging a search. Use job_id for new calls.
return_datestring | nullReturn Date
return_preferred_arrival_time_windowstring | nullReturn-leg arrival time preference for a round trip, saved on a new search or outbound read and applied to return offers. A new search requires return_date; a job_id read requires a round-trip job. Rejected with outbound_offer_id.
return_preferred_departure_time_windowstring | nullReturn-leg departure time preference for a round trip, saved on a new search or outbound read and applied to return offers. A new search requires return_date; a job_id read requires a round-trip job. Rejected with outbound_offer_id.
search_job_idstring | nullLegacy alias for job_id with outbound_offer_id. Use job_id for new calls.
sort_keystring | nullResult order, same keys as the flight search UI (e.g. LOWEST_TOTAL_AMOUNT, SHORTEST_DURATION). Defaults to WEIGHTED_SCORE. On a job_id read, re-sorts cached results; re-send it with cursor to page the sorted view.
traveler_user_idstring | nullUUID of the traveler when searching for someone else. Omit to search for the current user.
trip_idstring | nullOptional Ramp trip UUID to associate with this search.
wait_for_resultsbooleanWait For Results
ramp_search_merchants

Search for merchants by name. Returns matching merchant IDs, UUIDs, names, categories, and domains.

Parameters and full description

Search for merchants by name. Returns matching merchant IDs, UUIDs, names, categories, and domains.

ParameterTypeDescription
queryrequiredstringQuery
rationalerequiredstringRationale
limitintegerLimit
ramp_send_rfx_response_reminderEarly access

Send response reminder emails to invited vendors who have not yet

Parameters and full description

Send response reminder emails to invited vendors who have not yet submitted their RFX response. Only ACTIVE invitations on a published RFX whose vendor has not rejected the invitation and has not submitted are eligible. A per-vendor cooldown prevents spamming — recently reminded vendors are skipped and reported in ``skipped_due_to_cooldown_invitation_ids``. Omit ``rfx_vendor_invitation_ids`` to remind every eligible vendor.

ParameterTypeDescription
rationalerequiredstringRationale
rfx_idrequiredstringRfx Id
rfx_vendor_invitation_idsarray | nullRfx Vendor Invitation Ids
ramp_set_decline_buffer

Set or clear decline buffer percentages for business settings, spend programs, or funds.

Parameters and full description

Set or clear decline buffer percentages for business settings, spend programs, or funds. Decline buffers are stored as allowed overage percent. Use this purpose-built tool for decline/spend/overage buffer changes instead of generic endpoint tools. Always confirm the exact target and value with the user before calling this tool. Clear is distinct from 0%. Passing allowed_overage_percent=null removes the explicit value at the target level so it can inherit from the next level. Passing allowed_overage_percent=0 sets an explicit zero-percent buffer. Spend-program changes always propagate to existing linked allocations. For business-wide settings, buffer_application_mode is required when setting a non-null percent.

ParameterTypeDescription
allowed_overage_percentrequirednumber | string | nullAllowed Overage Percent
rationalerequiredstringRationale
target_typerequiredstringWhere to apply the decline buffer: business for the business-wide default, spend_program for a spend program override, or fund for an individual fund override.
buffer_application_modestring | nullFor business target only when setting a non-null percent: all_funds to apply to all existing and future funds, or from_enabled_date to apply only to newly-created funds going forward.
target_idstring | nullTarget Id
ramp_set_rfx_cover_sheetEarly access

Set or update the vendor-facing cover sheet on a DRAFT RFX. Pass body_markdown and/or attachment_ramp_document_ids, and get explicit user confirmation for the body and every attachment before calling.

Parameters and full description

Set or update the vendor-facing cover sheet on a DRAFT RFX. Pass body_markdown and/or attachment_ramp_document_ids, and get explicit user confirmation for the body and every attachment before calling.

ParameterTypeDescription
rationalerequiredstringRationale
rfx_idrequiredstringRfx Id
attachment_ramp_document_idsarray | nullAttachment Ramp Document Ids
body_markdownstring | nullBody Markdown
ramp_set_rfx_pricing_sheetEarly access

Set or update the pricing sheet on a DRAFT RFX during sourcing intake.

Parameters and full description

Set or update the pricing sheet on a DRAFT RFX during sourcing intake. The pricing sheet configures how vendors submit pricing in response to the RFX: the currency they must quote in, a rich-text guidance memo explaining pricing expectations (e.g. unit basis, term length, must include implementation), and optional background attachments (rate cards, SOW templates) for vendors to reference. The guidance memo and attachments are vendor-facing (sent on publish). The agent MUST get explicit user confirmation on the guidance wording and on every attachment before calling this tool. Never auto-attach files the user uploaded earlier in the thread — those may be internal/confidential and attaching them to a vendor-facing surface is a data-leak risk. Creating a pricing sheet implicitly enables vendor pricing on the RFX — once this tool succeeds, vendors will see a pricing step in their response flow. The very first call (when no pricing sheet exists yet) must include both `currency` and `guidance_markdown`. After that, partial updates are allowed. Patch semantics: - Pass `currency` to replace the currency. Omit (None) to leave unchanged. - Pass `guidance_markdown` to replace the guidance memo. Omit to leave unchanged. - Pass `attachment_ramp_document_ids=[id1, id2]` to replace the attachment set. Pass `[]` to clear all attachments. Omit (None) to leave unchanged. Requires the RFX to be in DRAFT state. The acting user must be an owner or collaborator on the RFX.

ParameterTypeDescription
rationalerequiredstringRationale
rfx_idrequiredstringRfx Id
attachment_ramp_document_idsarray | nullAttachment Ramp Document Ids
currencystring | nullCurrency
guidance_markdownstring | nullGuidance Markdown
ramp_statements_list

List statements

Parameters and full description

List statements

ParameterTypeDescription
rationalerequiredstringWhy this MCP tool call is needed.
from_datestring | nullFilter statements with end_date on or after this date (ISO8601 format).
page_sizeinteger | nullThe number of results to be returned in each page. The value must be between 2 and 100. If not specified, the default value 20 will be used.
startstring | nullThe ID of the last entity of the previous page, used for pagination to get the next page.
to_datestring | nullFilter statements with end_date on or before this date (ISO8601 format). Defaults to current time.
ramp_team_spend

List Ramp users with estimated AI spend during the requested period

Parameters and full description

List Ramp users with estimated AI spend during the requested period

ParameterTypeDescription
from_daterequiredstringStart date of the requested period in UTC, inclusive. The period can span up to 365 days.
rationalerequiredstringWhy this MCP tool call is needed.
to_daterequiredstringEnd date of the requested period in UTC, exclusive. The period can span up to 365 days.
is_anomalousboolean | nullFilter by whether Ramp detected anomalous AI spend during the requested period. Omit to include all users.
page_sizeinteger | nullNumber of results to return per page. Defaults to 20. Must be between 2 and 100.
providersarray | nullComma-separated AI providers to include. Omit to include all supported providers.
startstring | nullOpaque cursor returned in page.next from the previous page.
ramp_update_client_financing_applicationEarly access

Fill in or correct draft details on the Ramp financing application your accounting firm is preparing for a client (an assisted application): business and incorporation details, expected monthly spend, the controlling officer, and beneficial owners.

Parameters and full description

Fill in or correct draft details on the Ramp financing application your accounting firm is preparing for a client (an assisted application): business and incorporation details, expected monthly spend, the controlling officer, and beneficial owners. Run this on the client business, not your firm's own business; only the firm member preparing the application can use it, and only while the application can still be edited. Only the fields you provide are saved: omitted and null fields keep their current values, and saved values cannot be cleared. Beneficial owners are matched by email and added or updated, never removed. The update is all or nothing, and it does not submit the application or contact the client. Returns the application's saved details; dates of birth, SSN and passport digits, and the EIN are reported only as provided or not.

ParameterTypeDescription
rationalerequiredstringRationale
beneficial_ownersarray | nullBeneficial Owners
businessobject | nullBusiness details to save.
controlling_officerobject | nullThe person with significant responsibility for managing the business, such as the CEO or managing member. Updates the application's controlling officer, adding one if none is entered yet.
financial_detailsobject | nullExpected monthly spend to save.
ownership_acknowledgementstring | nullOwnership Acknowledgement
ramp_update_rfxEarly access

Update an RFX's name, description, dates, and questionnaire sections.

Parameters and full description

Update an RFX's name, description, dates, and questionnaire sections. ``sections`` is a complete replacement of the questionnaire — resubmit the full section list on every update. Use GetRFXDetail first to see the current structure. Optional scalar fields left unset are unchanged.

ParameterTypeDescription
rationalerequiredstringRationale
rfx_idrequiredstringRfx Id
sectionsrequiredarraySections
close_datestring | nullClose Date
descriptionstring | nullDescription
namestring | nullName
response_submission_deadlinestring | nullResponse Submission Deadline

People and organization

ramp_create_department

Create a new department in the company.

Parameters and full description

Create a new department in the company. Department names are unique within the business (case-insensitive). If a department with the requested name already exists, it is returned instead of creating a duplicate.

ParameterTypeDescription
department_namerequiredstringDepartment Name
rationalerequiredstringRationale
ramp_departments

List all departments in the company.

Parameters and full description

List all departments in the company. Returns the departments available in the user's business, which can be used as inputs to workflows that require department references. Each department includes organizational metadata: its owners (managers), active member count, and managing external firm, if any.

ParameterTypeDescription
rationalerequiredstringRationale
name_filterstring | nullName Filter
ramp_get_org_chart

Get org chart for a user, including reporting chain and direct reports.

Parameters and full description

Get org chart for a user, including reporting chain and direct reports. This tool provides comprehensive org chart visibility including: - The user's position in the organization - Their direct reports (team members) - Their reporting chain (managers up the hierarchy) Use this tool whenever the user asks anything about their manager, team, or direct reports.

ParameterTypeDescription
rationalerequiredstringRationale
user_idstring | nullRamp user UUID to get the org chart for. Omit this field or pass null to get the org chart for the current user.
ramp_get_simplified_user_detail

Get the current user's details.

Parameters and full description

Get the current user's details. Returns multiple results for users that are part of multiple businesses. When authenticated via an agent key, also returns the active agent key identity.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_list_users

List and search users across the entire business.

Parameters and full description

List and search users across the entire business. Returns all users in the organization matching the given filters. Supports searching by name (partial match, case-insensitive), filtering by department or location, and pagination. Results include active and inactive users — check the is_inactive field to distinguish. The role field is the primary role only: it does not include add-on roles such as Accounts Payable or evaluated bill, payment or card permissions. An Employee result is not evidence that AP access is missing or that credentials are denied. Department and location UUID filters narrow the results.

ParameterTypeDescription
rationalerequiredstringRationale
department_idsarray | nullDepartment Ids
include_agentsbooleanInclude Agents
location_idsarray | nullLocation Ids
name_searchstring | nullName Search
page_cursorstring | nullPage Cursor
page_sizeintegerPage Size
ramp_rename_department

Rename an existing department in the company.

Parameters and full description

Rename an existing department in the company. Department names must be unique within the business (case-insensitive).

ParameterTypeDescription
department_idrequiredstringDepartment Id
department_namerequiredstringDepartment Name
rationalerequiredstringRationale
ramp_search_user

Match a user name to a Ramp user in the context of a transaction, for adding as an attendee.

Parameters and full description

Match a user name to a Ramp user in the context of a transaction, for adding as an attendee. Returns business users ordered by text relevance, with exact-name match information and same-business manager names and UUIDs for the candidates and transaction cardholder, regardless of profile-read permissions. Manager chains are ordered from direct manager upward, exclude deleted users and may be truncated at 10 levels or broken links. Rank and shared ancestry do not prove identity or attendance. If no transaction ID is provided, the user's most recent transaction is used as context. Search is case-insensitive and matches partial names, email, department and location. Results may be incomplete; see has_more.

ParameterTypeDescription
rationalerequiredstringRationale
searchrequiredstringSearch
transaction_idstring | nullUUID of the transaction to use as context for the search. If not provided, uses the user's most recent transaction.

Policy and support

ramp_answer_policy_question

Get an answer to a question about the expense policy or funds (amount, restrictions, etc).

Parameters and full description

Get an answer to a question about the expense policy or funds (amount, restrictions, etc). Use this tool when the user asks about expense policy rules, spending limits, fund restrictions, or whether certain purchases are allowed under company policy.

ParameterTypeDescription
questionrequiredstringQuestion
rationalerequiredstringRationale
include_restrictionsbooleanInclude Restrictions
ramp_get_attention_feed

Return the authenticated user's homepage attention feed.

Parameters and full description

Return the authenticated user's homepage attention feed. Use this tool to see what needs the user's attention right now: pending approvals, missing receipts, overdue reviews, signatures, and similar action items that appear on the Ramp homepage. By default, the tool returns the default homepage sections with compact LIST-hydrated task rows. To fetch more from a section, pass that section's section_type and next_cursor back in sections. For own-card GET_ATTENTION_FEED remediation, use this as the canonical task feed. blocking_effects describes a task type's possible sanction, not proof that an item caused the active lock. Use browser_handoff for user action in Ramp. For an available CompleteTransactionRevision, inspect or edit the transaction and call it with a nonblank reason. Re-read both tools and continue relevant overdue tasks; success requires the task absent, blocking_task_count=0, and is_spendable=true. Pending verification is not an unlock.

ParameterTypeDescription
rationalerequiredstringRationale
fanout_timeout_secondsnumberFanout Timeout Seconds
sectionsarray | nullSections
ramp_get_employee_submission_policy_requirements

Get the employee-visible expense submission requirements for the caller's business, such as receipt, memo, attendee, fund, and accounting-field requirements per submission policy. Returns the same summaries shown in the employee handbook's transaction requirements.

Parameters and full description

Get the employee-visible expense submission requirements for the caller's business, such as receipt, memo, attendee, fund, and accounting-field requirements per submission policy. Returns the same summaries shown in the employee handbook's transaction requirements.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_get_more_tools

Report a capability that is missing from the available Ramp tools.

Parameters and full description

Report a capability that is missing from the available Ramp tools. Use this when the user's request cannot be completed with the available Ramp tools. Describe the user's goal and the capability that would be needed.

ParameterTypeDescription
contextrequiredstringContext
rationalerequiredstringRationale
ramp_get_policy_details

Fetch detailed metadata for one workflow-backed policy by UUID, including display name, spend type, default status, and separation-of-duties configuration, plus whether policy changes require approval. Accepts either the policy UUID or the backing product workflow UUID returned by list-policies.

Parameters and full description

Fetch detailed metadata for one workflow-backed policy by UUID, including display name, spend type, default status, and separation-of-duties configuration, plus whether policy changes require approval. Accepts either the policy UUID or the backing product workflow UUID returned by list-policies.

ParameterTypeDescription
kindrequiredstringWhich policy family to query. Must match the kind returned by ListPolicies for this UUID.
policy_uuidrequiredstringUUID of the policy to fetch. Accepts either the policy's own UUID or the UUID of its backing ProductWorkflow (the workflow builder URL path param).
rationalerequiredstringRationale
ramp_get_policy_workflow_body

Fetch the published (or a specific historical) workflow body for a workflow-backed policy, including compact branch structure, condition operands, and a workflow outline of the visible builder steps. Accepts the policy UUID or the backing product workflow UUID from list-policies. Use this for workflow routing and thresholds, not for written policy document guidance.

Parameters and full description

Fetch the published (or a specific historical) workflow body for a workflow-backed policy, including compact branch structure, condition operands, and a workflow outline of the visible builder steps. Accepts the policy UUID or the backing product workflow UUID from list-policies. Use this for workflow routing and thresholds, not for written policy document guidance.

ParameterTypeDescription
kindrequiredstringWhich policy family to query.
policy_uuidrequiredstringUUID of the policy whose workflow body to fetch. Accepts either the policy's own UUID or the backing ProductWorkflow UUID.
rationalerequiredstringRationale
workflow_uuidstring | nullOptional Workflow UUID belonging to this policy. Selects an exact published or historical version. Omit for the current body, which may include unpublished changes in editor sessions.
ramp_policyEarly access

Publish the active policy for a standalone Agent Wallet

Parameters and full description

Publish the active policy for a standalone Agent Wallet

ParameterTypeDescription
agent_idrequiredstringStandalone agent ID returned by the list agents tool.
configurationsrequiredarrayConfigurations
constraintsrequiredobject—
policy_versionrequiredstringPolicy Version
rationalerequiredstringWhy this MCP tool call is needed.
schema_versionrequiredintegerSchema Version
approval_modestring—
approval_validity_secondsintegerApproval Validity Seconds
ramp_post_comment

Post a comment on a Ramp object (transaction, bill, reimbursement, etc).

Parameters and full description

Post a comment on a Ramp object (transaction, bill, reimbursement, etc). If there is any ambiguity as to whether the user's message is meant to be posted to the thread, ask them for confirmation first: 'Do you want me to post that as a comment reply on your [XYZ] transaction/reimbursement/bill/etc?'. How can you determine if the user's message is meant to be a reply to a comment? - If the only other messages in the conversation history are notifications about comments or mentions in Ramp, that is a very strong signal that the user's most recent message is meant to be a reply to the comment thread. In this case, you may use this tool immediately to post the comment without confirmation. - If a recent assistant message is a notification about a comment or mention, that is a strong signal that the user's most recent message is meant to be a reply to that comment. Even if their reply seems irrelevant or unrelated to Ramp, you may ask "Would you like me to post that as a comment on your...?" - prefer asking the user instead of refusing to serve the request at all.

ParameterTypeDescription
messagerequiredstringMessage
ramp_object_typerequiredstringType of the Ramp object. Valid options are: 'reimbursement', 'transaction', 'bill', 'card', 'spend_request', 'spend_intent', 'ticket', 'payee', 'booking_request', 'provisional_bill', or 'vendor_payment'.
ramp_object_uuidrequiredstringRamp Object Uuid
rationalerequiredstringRationale
mention_user_uuidsarray | nullMention User Uuids
message_formatstringPLAIN_TEXT (default) posts the message as written. MARKDOWN renders standard Markdown: **bold**, *italic*, [link text](https://example.com), bullet and numbered lists; single line breaks are kept.
ramp_search_help_center_snippets

Search Ramp's authoritative Help Center documentation for product knowledge and guidance for users.

Parameters and full description

Search Ramp's authoritative Help Center documentation for product knowledge and guidance for users. Covers Ramp-specific information such as features, pricing, eligibility, policies, setup, how-to steps, and troubleshooting. These examples are not exhaustive; search other documented Ramp topics as needed. Returns ranked article text with titles, article keys, and source URLs when available.

ParameterTypeDescription
queryrequiredstringQuery
rationalerequiredstringRationale
exclude_article_keysarray | nullOn every search for the current user intent, MUST include cumulative, deduplicated article_key values already returned, including preloaded articles on the first call. Each parallel call uses all keys known before its batch; add new keys before the next batch. Rewording or changing subtopics does not reset exclusions; only a new user intent does. Reuse returned content directly, never remove exclusions to refetch it. Omit or pass [] when no keys are known. Matching ranked results are omitted without backfilling, so the search may return fewer than top_k results or no results.
query_variantsstring | array | nullQuery Variants
top_kintegerTop K
ramp_simulate_policy_workflow_for_expense

Simulate an approval or submission policy workflow against an existing transaction or reimbursement to preview how the published policy (or a specific historical workflow version) would route it. Approval policies return the simulated approval steps; submission policies return the required and visible expense fields. Provide exactly one expense UUID.

Parameters and full description

Simulate an approval or submission policy workflow against an existing transaction or reimbursement to preview how the published policy (or a specific historical workflow version) would route it. Approval policies return the simulated approval steps; submission policies return the required and visible expense fields. Provide exactly one expense UUID.

ParameterTypeDescription
kindrequiredstringPolicy family to simulate. Use approval_policy for post-spend approval routing, or submission_policy for required expense fields.
policy_uuidrequiredstringUUID of the policy to simulate. This may be the policy UUID or the backing ProductWorkflow UUID from page context.
rationalerequiredstringRationale
reimbursement_uuidstring | nullReimbursement UUID or reimbursement alias to simulate. Provide exactly one expense reference.
transaction_uuidstring | nullTransaction UUID or transaction alias to simulate. Provide exactly one expense reference.
workflow_uuidstring | nullOptional historical Workflow UUID to simulate instead of the latest published workflow or saved draft.

Procurement and purchase orders

ramp_delete_procurement_draft

Delete an abandoned procurement draft owned by the acting user.

Parameters and full description

Delete an abandoned procurement draft owned by the acting user.

ParameterTypeDescription
rationalerequiredstringRationale
spend_request_uuidrequiredstringDraft spend request UUID returned by draft_procurement_request.
ramp_find_procurement_deflection_matches

Find active procurement objects for one or more exact vendors.

Parameters and full description

Find active procurement objects for one or more exact vendors. Restricted matches intentionally contain only the object type and owner display names. Never infer, add, or disclose absent details, and never use another tool to recover them.

ParameterTypeDescription
payee_uuidsrequiredarrayPayee Uuids
rationalerequiredstringRationale
request_summarystring | nullRequest Summary
ramp_get_purchase_order_details

Get comprehensive details about a specific purchase order.

Parameters and full description

Get comprehensive details about a specific purchase order. Use this with the exact purchase order UUID from a tool result or page context. A unified_request_id or spend_request_uuid of a purchase-order request also resolves to its purchase order. Never pass a purchase order number, a bill or other entity's UUID, a placeholder, or a guessed value.

ParameterTypeDescription
purchase_order_idrequiredstringPurchase Order Id
rationalerequiredstringRationale
ramp_get_unified_request_details

Get one spend request the acting user can view.

Parameters and full description

Get one spend request the acting user can view. A unified request is Ramp's record of any request for approval to spend: a purchase or purchase-order request, a funds or card request, or a travel spend request. It is not a generic ID lookup: travel booking request IDs (booking_request_id), transaction, card, bill, invoice, contract, vendor, and approval task IDs will not resolve. Returns its status, approval chain, comments, activity timeline, custom fields, and agent-generated reports. With include_form_details, returns attachment IDs and authorized, short-lived original-file download URLs. Accepts a unified_request_id, its linked spend_request_uuid, wbp_request_id, or purchase_order_id, or the request's display number (for example REQ-123). Purchase-order numbers (PO-...) are not accepted. A purchase order issued directly has no request, so its purchase_order_id is rejected; read the purchase order itself instead. When the identifier matches no request visible to the user, returns found=false with a reason and how to continue; unknown and hidden requests are reported the same way.

ParameterTypeDescription
rationalerequiredstringRationale
unified_request_idrequiredstringUnified Request Id
include_form_detailsbooleanInclude Form Details
ramp_procurement_requests_draft

Create or update a procurement draft and return the current visible form state.

Parameters and full description

Create or update a procurement draft and return the current visible form state.

ParameterTypeDescription
rationalerequiredstringRationale
answersarray | nullAnswers
change_request_answersarray | nullChange Request Answers
clear_change_request_field_idsarray | nullClear Change Request Field Ids
clear_field_idsarray | nullClear Field Ids
currencystring | nullISO 4217 currency code, e.g. USD.
existing_spend_request_uuidstring | nullThe original approved purchase-order request's spend_request_uuid from unified request details; not the unified_request_id or purchase_order_id. Provide this when requesting a change to that purchase order. Mutually exclusive with spend_intent_uuid.
internal_memostring | nullInternal Memo
line_itemsarray | nullLine Items
request_namestring | nullRequest Name
request_virtual_cardboolean | nullRequest Virtual Card
spend_intent_uuidstring | nullSpend intent UUID returned by spend-intents. Provide this when starting a new procurement request. Mutually exclusive with existing_spend_request_uuid.
spend_request_uuidstring | nullDraft spend request UUID returned by this tool. Provide this to continue editing a draft.
ramp_procurement_requests_get

Refresh and canonically revalidate a procurement draft's visible form state

Parameters and full description

Refresh and canonically revalidate a procurement draft's visible form state

ParameterTypeDescription
rationalerequiredstringValue for rationale.
spend_request_uuidrequiredstringValue for spend_request_uuid.
ramp_procurement_spend_intents

List published procurement spend programs the agent can draft against.

Parameters and full description

List published procurement spend programs the agent can draft against.

ParameterTypeDescription
rationalerequiredstringRationale
page_sizeintegerPage Size
querystring | nullQuery
ramp_procurement_submit

Submit a procurement draft after explicit user confirmation.

Parameters and full description

Submit a procurement draft after explicit user confirmation.

ParameterTypeDescription
confirmedrequiredbooleanConfirmed
rationalerequiredstringRationale
spend_request_uuidrequiredstringDraft spend request UUID returned by draft.
ramp_ramp_bulk_close_purchase_ordersEarly access

Close one or more purchase orders with a specified reason.

Parameters and full description

Close one or more purchase orders with a specified reason. Use after confirming the user wants the listed POs closed. Purchase orders must not already be closed or archived. The user must have permission to close every purchase order in the request.

ParameterTypeDescription
close_reasonrequiredstringClose Reason
purchase_order_uuidsrequiredarrayPurchase Order Uuids
rationalerequiredstringRationale
ramp_ramp_bulk_reopen_purchase_ordersEarly access

Reopen multiple closed purchase orders.

Parameters and full description

Reopen multiple closed purchase orders. Use only after confirming the user wants the listed POs reopened. This does not archive or delete POs; reopening restores each PO to its computed active lifecycle status when allowed. The user must have permission to reopen every purchase order in the request.

ParameterTypeDescription
purchase_order_uuidsrequiredarrayPurchase Order Uuids
rationalerequiredstringRationale
ramp_search_purchase_orders

Search for purchase orders using structured purchase order filters.

Parameters and full description

Search for purchase orders using structured purchase order filters.

ParameterTypeDescription
rationalerequiredstringRationale
filtersobject | nullCompact purchase order filters. Use search for PO numbers, request names, or owner names; for vendor/payee queries, resolve the vendor first and pass payee_uuids. Then narrow by PO status, spend request status, owner, or approval queue when needed.
include_progressbooleanInclude Progress
limitintegerLimit
page_cursorstring | nullPage Cursor
ramp_search_unified_requests

Search for unified requests using free-text and structured request filters.

Parameters and full description

Search for unified requests using free-text and structured request filters. Use this to find existing purchase orders, fund requests, procurement requests, policy-backed requests, or approval-only requests by vendor, request name, spend program, owner UUID, requester UUID, status, type, exact request number, approval date, department, workflow-backed policy, or whether they require action. Only requests the acting user owns, requested, can approve, or is otherwise permitted to view are searchable. Use GetRequestsToReview when the user is specifically asking what they need to approve right now. Use GetUnifiedRequestDetails once one request has been identified. For a draft policy-backed request, pass the result's exact wbp_request_id to ResumeWbxRequest, not its unified_request_id.

ParameterTypeDescription
rationalerequiredstringRationale
filtersobject | nullCompact filters for unified request search. Use filters.search for free text, request_numbers for exact REQ-* identifiers, payee_ids for an exact vendor match, and the other fields to narrow by category, status, type, approval date, department, owner, requester, or approval queue.
limitintegerLimit
page_cursorstring | nullPage Cursor
ramp_update_purchase_order_ownerEarly access

Update the owner for one existing purchase order.

Parameters and full description

Update the owner for one existing purchase order. Use this only after the user has identified a single purchase order and the new owner. For multiple purchase orders, search for the affected POs first and ask the user to confirm each one; do not perform unbounded bulk owner changes.

ParameterTypeDescription
new_owner_uuidrequiredstringNew Owner Uuid
purchase_order_uuidrequiredstringPurchase Order Uuid
rationalerequiredstringRationale

Reimbursements

ramp_cancel_reimbursement_payment

Request cancellation of an eligible reimbursement payment and reject the claim.

Parameters and full description

Request cancellation of an eligible reimbursement payment and reject the claim. Does not delete the expense or establish recovery of settled funds. Payment cancellation/reversal may still be processing after the request succeeds. On an uncertain result, reconcile payment and claim state before retrying.

ParameterTypeDescription
rationalerequiredstringRationale
reimbursement_uuidrequiredstring | nullUUID of the reimbursement in the current business whose payment should be canceled.
notesstring | nullNotes
ramp_create_mileage_reimbursement

Create the acting employee's mileage reimbursement draft from actual business-driving distance.

Parameters and full description

Create the acting employee's mileage reimbursement draft from actual business-driving distance. The company calculates the amount and currency for the trip date; no rate or amount override is accepted. Requires enabled mileage, cleared OFAC checks and company permission to request reimbursements. Saves a draft only, never submits. Supply user-confirmed distance and start/end addresses; this does not map routes or track GPS. Not for estimates, per diem, or out-of-pocket purchases. Returns the saved claim, remaining requirements, validation errors, and a review link. A retry of the same logical call returns the same draft without changing it.

ParameterTypeDescription
distancerequirednumber | stringDistance
distance_unitsrequiredstringUnit of the supplied distance: MILES or KILOMETERS.
end_locationrequiredstringEnd Location
memorequiredstringMemo
rationalerequiredstringRationale
start_locationrequiredstringStart Location
transaction_daterequiredstringTransaction Date
idempotency_keystring | nullUnique idempotency key generated by the client. Must be a non-empty string of at most 255 characters.
vehicle_mileage_classstring | nullVehicle class when required by the mileage country; omit when not applicable.
ramp_create_reimbursement_from_receipt

Create a draft reimbursement from a receipt UUID. Pass amount/currency_code/transaction_date/merchant to skip OCR.

Parameters and full description

Create a draft reimbursement from a receipt UUID. Pass amount/currency_code/transaction_date/merchant to skip OCR.

ParameterTypeDescription
rationalerequiredstringRationale
receipt_uuidrequiredstringReal Ramp Receipt UUID (not a chat file_id). Must come from Ramp/context; no placeholders. If unknown, call list-unmatched-receipts to find receipts the user already sent in (e.g. by email to [email protected]); ask the user to upload a receipt only if none match.
amountnumber | string | nullAmount
currency_codestring | nullCurrency Code
merchantstring | nullMerchant
transaction_datestring | nullTransaction Date
ramp_delete_reimbursement

Delete a reimbursement by UUID.

Parameters and full description

Delete a reimbursement by UUID. Deletion is permanent and only allowed for reimbursements the acting user is permitted to delete (their own drafts, or others' if they have write access). Only draft, pending or rejected claims without initiated or queued payments can be deleted here. Payment-linked claims must be reviewed in the app; this action cannot cancel, reverse or rebatch a payment.

ParameterTypeDescription
rationalerequiredstringRationale
reimbursement_uuidrequiredstring | nullReimbursement Uuid
ramp_duplicate_reimbursement

Copy an existing reimbursement into a distinct new draft; never submits it.

Parameters and full description

Copy an existing reimbursement into a distinct new draft; never submits it. Each call can create another draft. If the outcome is unknown or the new UUID is missing, do not repeat the request: reconcile the existing drafts first.

ParameterTypeDescription
rationalerequiredstringRationale
reimbursement_uuidrequiredstring | nullUUID of the source reimbursement in the current business to copy into a new draft.
ramp_edit_reimbursement

Edit reimbursement fields (amount, currency, date, merchant, memo, funds, accounting categories, split line items, custom records, trip, attendees). Send only fields being changed, not existing values or a full-state copy. For a memo-only edit, send only reimbursement_uuid and memo. Merchant and attendees are draft-only; accounting categories cannot be sent after sync, even if unchanged. Omitted fields stay unchanged; null and empty-list fields are ignored. This tool cannot clear existing values. Mileage drafts containing tolls require editing in Ramp; this tool leaves them unchanged.

Parameters and full description

Edit reimbursement fields (amount, currency, date, merchant, memo, funds, accounting categories, split line items, custom records, trip, attendees). Send only fields being changed, not existing values or a full-state copy. For a memo-only edit, send only reimbursement_uuid and memo. Merchant and attendees are draft-only; accounting categories cannot be sent after sync, even if unchanged. Omitted fields stay unchanged; null and empty-list fields are ignored. This tool cannot clear existing values. Mileage drafts containing tolls require editing in Ramp; this tool leaves them unchanged.

ParameterTypeDescription
rationalerequiredstringRationale
reimbursement_uuidrequiredstring | nullUUID of the reimbursement to modify. Look up the reimbursement to determine the UUID if it cannot be obtained from context.
accounting_split_requestobject | nullComplete replacement for every split line on a draft. Omit for ordinary edits; null is treated as omitted and preserves existing split lines. A non-null payload must include every line with its amount, memo, and line-level tracking category selections. Required when changing the amount or currency of an existing split draft.
amountnumber | string | nullAmount
attendee_user_uuidsarray | nullAttendee User Uuids
currency_codestring | nullCurrency Code
custom_record_valuesarray | nullCustom Record Values
fund_uuidstring | nullUUID of the fund (spend allocation) to charge this reimbursement to. Null is ignored.
memostring | nullMemo
merchant_namestring | nullMerchant Name
merchant_uuidstring | nullCanonical merchant UUID. Omit unless changing it on a DRAFT reimbursement. Resending the saved value outside DRAFT is rejected. Null is ignored.
reimbursement_datestring | nullReimbursement Date
tracking_category_selectionsarray | nullTracking Category Selections
trip_uuidstring | nullTrip UUID to associate. Null is ignored.
ramp_estimate_mileage_reimbursement

Estimate the reimbursement amount for a given mileage distance based on the user's company rates.

Parameters and full description

Estimate the reimbursement amount for a given mileage distance based on the user's company rates.

ParameterTypeDescription
distancerequirednumber | stringDistance
rationalerequiredstringRationale
distance_unitsstringThe distance unit: MILES or KILOMETERS. Defaults to MILES.
transaction_datestring | nullTransaction Date
vehicle_mileage_classstring | nullThe vehicle mileage class, required for some countries (e.g. France, Finland).
ramp_estimate_per_diem_amount

Estimate the per diem reimbursement amount for an existing trip over a date range.

Parameters and full description

Estimate the per diem reimbursement amount for an existing trip over a date range. The rate comes from the trip's locations and the business's per diem settings; optional meal and lodging details adjust the estimate. Dates after today are accepted only when the business allows advance per diem payments. Read-only: no reimbursement is created.

ParameterTypeDescription
end_daterequiredstringEnd Date
rationalerequiredstringRationale
start_daterequiredstringStart Date
trip_uuidrequiredstringTrip Uuid
day_dataarray | nullDay Data
deduct_weekendsboolean | nullDeduct Weekends
meals_providedboolean | nullMeals Provided
ramp_get_outstanding_reimbursements_by_currency

Get approved and failed reimbursements that would be affected by a bank account currency change.

Parameters and full description

Get approved and failed reimbursements that would be affected by a bank account currency change.

ParameterTypeDescription
new_currencyrequiredstringNew Currency
rationalerequiredstringRationale
entity_uuidstring | nullEntity Uuid
ramp_get_reimbursement_receipts

Retrieve receipts attached to a reimbursement.

Parameters and full description

Retrieve receipts attached to a reimbursement.

ParameterTypeDescription
rationalerequiredstringRationale
reimbursement_uuidrequiredstring | nullReimbursement Uuid
ramp_get_reimbursements

List reimbursement history and current statuses, including older paid requests.

Parameters and full description

List reimbursement history and current statuses, including older paid requests. Search all visible reimbursements or filter by user, text, amount, tags, dates, approval status, and policy assessments. Omitting date filters searches history without a time cutoff. Results are paginated; continue with each returned next_page_cursor until it is null before treating the matching history as complete, preserving scope and filters.

ParameterTypeDescription
rationalerequiredstringRationale
from_datestring | nullFrom Date
include_commentsbooleanInclude Comments
include_policy_assessmentbooleanInclude Policy Assessment
include_suggestionsbooleanInclude Suggestions
next_page_cursorstring | nullNext Page Cursor
page_sizeintegerPage Size
reimbursement_uuidsarray | nullReimbursement Uuids
reimbursements_to_retrievestringWhich set of reimbursements to search: your own reimbursements, reimbursements awaiting your approval, or all reimbursements across the business
search_stringstring | nullSearch String
tagsarray | nullTags
to_datestring | nullTo Date
ramp_get_user_recent_reimbursements

Get the current user's recent reimbursements within a rolling date window.

Parameters and full description

Get the current user's recent reimbursements within a rolling date window. This date-bounded lookup does not cover lifetime history. Results and `total_count` cover only the returned rows. `up_to_days` always restricts the time frame; `limit` caps the number of results within it. Set `limit` to null to return all reimbursements within the time frame. `include_rejected` controls whether to include rejected reimbursements in the results. By default, rejected reimbursements are excluded. `include_drafts` controls whether to include draft reimbursements in the results. By default, drafts are excluded. `use_submitted_date_ordering` controls the ordering of results. By default (False), results are ordered by transaction_date. Set to True to order by submitted_date instead. By default, returns up to 10 reimbursements from the last 30 days. Read each amount from `amount_decimal`, which is already in `currency`'s major unit and needs no arithmetic. Ignore `amount_cents`; it is the same amount in minor units, kept only for backwards compatibility.

ParameterTypeDescription
rationalerequiredstringRationale
include_draftsbooleanInclude Drafts
include_rejectedbooleanInclude Rejected
limitinteger | nullLimit
up_to_daysintegerUp To Days
use_submitted_date_orderingbooleanUse Submitted Date Ordering
ramp_resubmit_reimbursement

Revert a rejected reimbursement back to draft state so it can be edited and resubmitted.

Parameters and full description

Revert a rejected reimbursement back to draft state so it can be edited and resubmitted. This does NOT submit the reimbursement — it only moves it from REJECTED to DRAFT.

ParameterTypeDescription
rationalerequiredstringRationale
reimbursement_uuidrequiredstring | nullUUID of the rejected reimbursement in the current business to reopen as a draft.
ramp_search_reimbursements

Search reimbursements across a business, optionally filtering to a specific user's reimbursements.

Parameters and full description

Search reimbursements across a business, optionally filtering to a specific user's reimbursements.

ParameterTypeDescription
rationalerequiredstringRationale
accounting_sync_statusstring | nullFilter by accounting sync status: UNSYNCED (not yet synced), NOT_SYNC_READY (unsynced and not marked ready to sync), SYNC_READY (unsynced and marked ready to sync), or SYNCED (already synced or exported).
filtersobject | nullText-based filters to search by. Provide human-readable names for tracking categories, merchants, or spend allocations and they will be resolved to the correct IDs automatically.
from_datestring | nullFrom Date
from_submitted_datestring | nullFrom Submitted Date
include_commentsbooleanInclude Comments
include_policy_assessmentbooleanInclude Policy Assessment
include_suggestionsbooleanInclude Suggestions
next_page_cursorstring | nullNext Page Cursor
page_sizeintegerPage Size
reimbursement_statusarray | nullReimbursement Status
reimbursement_typesarray | nullReimbursement Types
reimbursement_uuidsarray | nullReimbursement Uuids
reimbursements_to_retrievestring | nullWhich reimbursements to search: the acting user's own, those awaiting the acting user's approval, or all. When omitted, searches all reimbursements in the business (narrowed by user_id if given). my_reimbursements ignores any user filter; with reimbursements_awaiting_my_approval, a user filter narrows by submitter.
search_stringstring | nullSearch String
to_datestring | nullTo Date
to_submitted_datestring | nullTo Submitted Date
user_idinteger | nullUser Id
ramp_search_user_reimbursements

View all reimbursements and their current statuses, or search past requests.

Parameters and full description

View all reimbursements and their current statuses, or search past requests. Includes older paid and rejected requests in the user's reimbursement history. Omitting date filters applies no time cutoff. Results are paginated: for the complete matching set, continue with each returned next_page_cursor until it is null, preserving scope and filters. Supports filtering by: - Specific reimbursement UUIDs - Scope: the current user's own reimbursements, reimbursements awaiting their approval, or every reimbursement they can see - User name (e.g., 'John Smith'), merchant name, and spend allocation name, resolved from text automatically - Accounting coding selections (tracking categories) like Department, Cost Center, Class, GL Account - One or more reimbursement statuses (DRAFT, PENDING, APPROVED, etc.) - One or more reimbursement types (out of pocket, mileage, per diem) - Accounting sync status (unsynced, sync ready, not sync ready, synced) - Record creation date range, submission date range, and text search Optionally includes comment threads, autofill suggestions for missing items, and AI policy assessments. All filters are combined with AND logic. This tool does not support filtering by expense transaction date or ranking employees by period totals.

ParameterTypeDescription
rationalerequiredstringRationale
accounting_sync_statusstring | nullFilter by accounting sync status: UNSYNCED (not yet synced), NOT_SYNC_READY (unsynced and not marked ready to sync), SYNC_READY (unsynced and marked ready to sync), or SYNCED (already synced or exported).
filtersobject | nullText-based filters to search by. Provide human-readable names for tracking categories, merchants, or spend allocations and they will be resolved to the correct IDs automatically.
from_datestring | nullFrom Date
from_submitted_datestring | nullFrom Submitted Date
include_commentsbooleanInclude Comments
include_policy_assessmentbooleanInclude Policy Assessment
include_suggestionsbooleanInclude Suggestions
next_page_cursorstring | nullNext Page Cursor
page_sizeintegerPage Size
reimbursement_statusarray | nullReimbursement Status
reimbursement_typesarray | nullReimbursement Types
reimbursement_uuidsarray | nullReimbursement Uuids
reimbursements_to_retrievestring | nullWhich reimbursements to search: the current user's own, those awaiting the current user's approval, or all reimbursements the current user can see. When omitted, searches the current user's own reimbursements unless a user filter or reimbursement_uuids is given. my_reimbursements ignores any user filter; with reimbursements_awaiting_my_approval, a user filter narrows by submitter.
search_stringstring | nullSearch String
to_datestring | nullTo Date
to_submitted_datestring | nullTo Submitted Date
ramp_submit_reimbursement

Submit an existing out-of-pocket or mileage reimbursement draft for approval.

Parameters and full description

Submit an existing out-of-pocket or mileage reimbursement draft for approval. Enforces the saved claim's permissions and required fields; does not create a claim. Repeated submission of an already-pending reimbursement returns success. Unmet requirements are returned as structured validation errors. Pending processing is distinguished from completed submission; neither means approval or payment. Requirements that cannot be resolved here may require the reimbursement link.

ParameterTypeDescription
rationalerequiredstringRationale
reimbursement_uuidrequiredstring | nullUUID of the existing reimbursement draft to submit for approval. Look up the reimbursement if the UUID is not available from context.

Transactions and expenses

ramp_attach_receipt_to_transaction

Attach an existing receipt (by receipt_uuid) to a card transaction. Use it for receipts automatic matching left unmatched, or when the user wants a receipt on a specific charge, including moving it off the wrong one. Not a routine step after uploading a new receipt. Confirm the pairing with the user first; if the receipt is on another card transaction, say it will be moved. Fails if the receipt is on a reimbursement or the transaction is declined. Safe to retry.

Parameters and full description

Attach an existing receipt (by receipt_uuid) to a card transaction. Use it for receipts automatic matching left unmatched, or when the user wants a receipt on a specific charge, including moving it off the wrong one. Not a routine step after uploading a new receipt. Confirm the pairing with the user first; if the receipt is on another card transaction, say it will be moved. Fails if the receipt is on a reimbursement or the transaction is declined. Safe to retry.

ParameterTypeDescription
rationalerequiredstringRationale
receipt_uuidrequiredstringUUID of the receipt to attach, e.g. from CreateReceipt or a receipt listing. Not the upload file_id or internal receipt_id.
transaction_uuidrequiredstringUUID of the transaction to attach the receipt to.
ramp_complete_transaction_revision

Complete a revision-requested transaction as its cardholder.

Parameters and full description

Complete a revision-requested transaction as its cardholder. Use this after the cardholder has addressed the requested changes and explicitly asks to mark the transaction revision complete. The completion refreshes the corresponding task and starts Task Platform's sanction-lifting workflow.

ParameterTypeDescription
rationalerequiredstringRationale
reasonrequiredstringReason
transaction_uuidrequiredstringUUID of the revision-requested transaction to complete.
ramp_edit_transaction

Edit a transaction field (memo, funds, accounting categories, trip, attendees). Returns the updated transaction, remaining missing items, and a transaction_link for fields the API cannot edit.

Parameters and full description

Edit a transaction field (memo, funds, accounting categories, trip, attendees). Returns the updated transaction, remaining missing items, and a transaction_link for fields the API cannot edit.

ParameterTypeDescription
rationalerequiredstringRationale
transaction_uuidrequiredstring | nullUUID of the transaction to modify. Call GetUserTransactions to determine the UUID if it cannot be obtained from context.
attendee_selectionsobject | nullAttendee selections: attendee_uuids (Ramp users; must be valid UUIDs, never integer IDs), non_ramp_attendees (external people), include_self_as_attendee (acting user is added automatically when include_self_as_attendee is True). This is an upsert - provide the complete set of attendees. Only provide this field when Attendees is in incomplete items, or when the user directly provides attendee values or asks to change attendees; a memo or business-purpose answer is not an attendee change by itself unless it directly identifies attendee names or an attendee change.
fund_uuidstring | nullFund Uuid
memostring | nullMemo
tracking_category_selectionsarray | nullTracking Category Selections
trip_selectionobject | nullTrip selection configuration. Provide a trip_uuid to assign/change the transaction. Set trip_uuid=None to detach a wrong trip while leaving the transaction eligible for another trip. Set mark_not_part_of_trip=True only when the transaction genuinely is not part of any trip.
user_submitted_fieldsarray | nullUser Submitted Fields
ramp_get_candidate_trips_for_transaction

Fetch relevant trips for the acting user, with names, dates, status, and locations.

Parameters and full description

Fetch relevant trips for the acting user, with names, dates, status, and locations. Returns up to 10 ongoing, upcoming, and recently completed trips. Supports general trip lookups as well as expense matching; no transaction is required.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_get_full_transaction_metadata

View all details, memos, funds, and receipts for a specific transaction.

Parameters and full description

View all details, memos, funds, and receipts for a specific transaction. Read the amount from `amount_decimal`, which is already in `currency`'s major unit and needs no arithmetic. Ignore `amount_cents`; it is the same amount in minor units, kept only for backwards compatibility.

ParameterTypeDescription
idrequiredstring | nullTransaction id (from tool calls or metadata)
rationalerequiredstringRationale
ramp_get_receipt_details

Get structured extraction data for one or more receipts the caller can read by receipt UUID: merchant, date, amounts, taxes, fees, discounts, line items, and travel, delivery, or hotel details when extracted. Existing receipt and expense permissions apply within the authenticated business. Coworker receipts require receipt keyword search to be enabled; otherwise only own receipts are returned. Raw OCR text is not included.

Parameters and full description

Get structured extraction data for one or more receipts the caller can read by receipt UUID: merchant, date, amounts, taxes, fees, discounts, line items, and travel, delivery, or hotel details when extracted. Existing receipt and expense permissions apply within the authenticated business. Coworker receipts require receipt keyword search to be enabled; otherwise only own receipts are returned. Raw OCR text is not included.

ParameterTypeDescription
rationalerequiredstringRationale
receipt_uuidsrequiredarrayReceipt Uuids
ramp_get_transaction_missing_items

Check what receipts, memos, or accounting items are missing from a specific transaction.

Parameters and full description

Check what receipts, memos, or accounting items are missing from a specific transaction.

ParameterTypeDescription
idrequiredstring | nullTransaction UUID or transaction alias.
rationalerequiredstringRationale
ramp_get_transaction_suggested_memos

Get AI-suggested memo/note options for a specific transaction.

Parameters and full description

Get AI-suggested memo/note options for a specific transaction.

ParameterTypeDescription
idrequiredstring | nullThe ID of the transaction to retrieve suggested memos for.
rationalerequiredstringRationale
ramp_get_transactions

Search and retrieve individual card transactions and workflow details for the user's business, including reconciliation dates (cleared_at, settlement_date, accounting_date, synced_at) and, via details_to_include_in_response=['submitted_items'], the selected accounting categories. For aggregate spend totals, trends, or group-bys, use the reporting tools instead (ramp_reporting_get_skill, then ramp_reporting_query). Declined transactions are excluded by default; pass state='declined' to include them.

Parameters and full description

Search and retrieve individual card transactions and workflow details for the user's business, including reconciliation dates (cleared_at, settlement_date, accounting_date, synced_at) and, via details_to_include_in_response=['submitted_items'], the selected accounting categories. For aggregate spend totals, trends, or group-bys, use the reporting tools instead (ramp_reporting_get_skill, then ramp_reporting_query). Declined transactions are excluded by default; pass state='declined' to include them.

ParameterTypeDescription
rationalerequiredstringRationale
transactions_to_retrieverequiredstringWhich set of transactions to search.
card_uuidstring | nullRestrict results to this exact card, within the selected transaction scope.
details_to_include_in_responsearray | nullDetails To Include In Response
end_atstring | nullEnd At
filtersobject | nullStructured filters by merchant, category, spend allocation, trip, or tracking category.
include_countbooleanInclude Count
next_page_cursorstring | nullNext Page Cursor
only_missing_itemsbooleanOnly Missing Items
page_sizeintegerPage Size
reason_memo_merchant_or_user_name_text_searchstring | nullReason Memo Merchant Or User Name Text Search
sortobject | nullSort order. Defaults to transaction_date desc.
start_atstring | nullStart At
statestring | nullFilter by state. Defaults to non-declined; 'all' returns every non-declined state but never declines; set 'declined' for declined/failed.
ramp_list_unmatched_receipts

List the user's unmatched receipts (emailed, uploaded, etc.) with receipt UUIDs.

Parameters and full description

List the user's unmatched receipts (emailed, uploaded, etc.) with receipt UUIDs.

ParameterTypeDescription
rationalerequiredstringRationale
from_transaction_datestring | nullFrom Transaction Date
merchantstring | nullMerchant
offsetintegerOffset
page_sizeintegerPage Size
to_transaction_datestring | nullTo Transaction Date
ramp_mark_transaction_missing_receipt

Flag a transaction as having no receipt.

Parameters and full description

Flag a transaction as having no receipt. Should be called whenever the user says "OOPS" or if the user says something along the lines of "I did not receive a receipt ...". If the user already flagged the transaction as having no receipt, then you may need to call the ProvideNoReceiptReason tool.

ParameterTypeDescription
rationalerequiredstringRationale
transaction_uuidrequiredstring | nullTransaction Uuid
ramp_merchant_categories

List Ramp merchant categories and IDs for Agent Wallet and spend controls.

Parameters and full description

List Ramp merchant categories and IDs for Agent Wallet and spend controls. Each category expands to its configured MCC allowlist.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_provide_no_receipt_reason

Submit a reason explaining why a transaction has no receipt.

Parameters and full description

Submit a reason explaining why a transaction has no receipt.

ParameterTypeDescription
rationalerequiredstringRationale
reasonrequiredstringReason
transaction_uuidrequiredstring | nullTransaction Uuid
ramp_request_receipt_upload_link

Create a one-time URL to upload a receipt file, for a card transaction or out-of-pocket spend.

Parameters and full description

Create a one-time URL to upload a receipt file, for a card transaction or out-of-pocket spend. Only use this for transactions where a receipt is missing. If your client shows an in-chat receipt uploader (an upload card), prefer it for files the user has, even if already attached to the chat. Use this when you have a local shell with normal network access (such as Claude Code, Cursor or Codex) or no uploader, and the receipt file is on local disk; then run the curl command from the response. Never give the URL to the user, as it does not work in a browser. Otherwise, ask the user to upload the receipt in the Ramp web or mobile app, or by email. For a card transaction, confirm a 201 response with get-transaction-missing-items. For out-of-pocket or reimbursement receipts, omit transaction_uuid, then pass the receipt_uuid from the 201 response to create-reimbursement-from-receipt.

ParameterTypeDescription
rationalerequiredstringRationale
transaction_uuidstring | nullID of the card transaction that needs a receipt. Omit for out-of-pocket or reimbursement receipts to create an unattached receipt.
ramp_request_transaction_repayment

Request that a cardholder repay a transaction.

Parameters and full description

Request that a cardholder repay a transaction. This is the REVIEWER / APPROVER action: the acting user must be an approver or manager for the transaction, not the cardholder themselves. The tool marks the transaction as repayment-required and notifies the cardholder, who can then accept, reject, or complete repayment through their own flow. This tool does NOT execute payment (ACH, payroll, debit-card, etc.). It only creates the repayment request so the cardholder sees an actionable task. Use when a reviewer or manager says things like: - "Request repayment on this transaction" - "Mark this as needing repayment" - "Require the employee to pay back this charge" - "Flag this transaction for repayment" If the user is the cardholder wanting to repay their OWN transaction, use RepayTransaction instead — that tool provides the self-service repayment URL.

ParameterTypeDescription
rationalerequiredstringRationale
reasonrequiredstringReason
thoughtsrequiredstringThoughts
transaction_idrequiredstringThe UUID of the transaction to request repayment for.
ramp_search_receiptsEarly access

Search receipts by natural-language intent and/or OCR keywords, returning receipts and owners.

Parameters and full description

Search receipts by natural-language intent and/or OCR keywords, returning receipts and owners. Only includes receipts attached to a transaction or reimbursement. Requires receipt keyword search to be enabled for the caller's business. Company-wide discovery is limited to receipts the caller can currently read under existing receipt/expense permissions. Combines independent keyword and semantic retrieval, not exact phrases or verified category classification. Falls back to OCR word matches if embedding is unavailable; retrieval_mode reports this even for empty results. Semantic relevance is provisional. Search is bounded and index coverage may be incomplete; results are evidence, not exhaustive spending analytics. Does not search bill/invoice documents.

ParameterTypeDescription
rationalerequiredstringRationale
keywordsarray | nullKeywords
offsetintegerOffset
page_sizeintegerPage Size
querystring | nullQuery
received_afterstring | nullReceived After
received_beforestring | nullReceived Before
scopestringScope
ramp_split

Split a transaction into line items, or update an existing split

Parameters and full description

Split a transaction into line items, or update an existing split

ParameterTypeDescription
rationalerequiredstringWhy this MCP tool call is needed.
transaction_idrequiredstringValue for transaction_id.
ramp_update_transaction_amount_limit

Set a fund's maximum amount for one transaction. Use this for decline action

Parameters and full description

Set a fund's maximum amount for one transaction. Use this for decline action INCREASE_TRANSACTION_AMOUNT_LIMIT or requests about a per-transaction, single-transaction, or max-expense limit. Use LimitIncrease for the period total. Set any positive value to raise or lower the cap. AP-card and bill-pay funds are unsupported. Provide exactly one of spend_allocation_id or card_id.

ParameterTypeDescription
new_transaction_amount_limitrequirednumber | stringNew Transaction Amount Limit
rationalerequiredstringRationale
card_idstring | nullCard Id
spend_allocation_idstring | nullSpend Allocation Id
ramp_upload_receipt_file

Upload a receipt from base64-encoded file content.

Parameters and full description

Upload a receipt from base64-encoded file content. Use this tool to create a receipt from raw file data (PNG, JPEG, PDF, HEIC, WEBP). Optionally attach it to a transaction by providing a transaction UUID. This tool is designed for CLI callers that have the file content directly.

ParameterTypeDescription
content_typerequiredstringContent Type
file_content_base64requiredstringFile Content Base64
filenamerequiredstringFilename
rationalerequiredstringRationale
transaction_uuidstring | nullOptional UUID of a transaction to auto-attach the receipt to.

Travel

ramp_booking_cancellation_detailsEarly access

Check cancellation options for an existing flight, hotel, or car reservation.

Parameters and full description

Check cancellation options for an existing flight, hotel, or car reservation. Returns a qualitative cancellation message, an available self-service link, and booking-specific support routing. It does not return refund, credit, or fee amounts, cancel a reservation, withdraw a request, or contact support. Requires a reservation visible to the acting user; an unfulfilled booking request returns a failed-precondition error.

ParameterTypeDescription
booking_idrequiredstringParent or sub-booking UUID, or a booking-request UUID linked to an existing reservation. A processing request is valid only when it already has a reservation.
rationalerequiredstringRationale
ramp_booking_modification_detailsEarly access

Check change options for an existing flight, hotel, or car reservation.

Parameters and full description

Check change options for an existing flight, hotel, or car reservation. Supply exactly one booking identifier; omit or leave the others null. Returns current modifiability, an available self-service action, a rendered explanation, and booking-specific support routing. Echoes the supplied identifier to match results to bookings. Requires a reservation visible to the acting user. It does not modify, cancel, rebook, or contact support.

ParameterTypeDescription
rationalerequiredstringRationale
booking_idstring | nullParent reservation UUID, including a car rental's booking UUID.
booking_request_idstring | nullBooking-request UUID linked to an existing reservation.
flight_booking_idstring | nullFlight sub-booking UUID, not the parent reservation UUID.
flight_leg_indexinteger | nullFlight Leg Index
hotel_room_booking_idstring | nullHotel room sub-booking UUID, not the parent reservation UUID.
ramp_create_trip

Create a new trip for the acting user.

Parameters and full description

Create a new trip for the acting user. Creates a trip when the user asks for one, not as a prerequisite for booking travel. Returns the trip UUID and dates. Requires both start and end dates. Overlaps of less than 48 hours are allowed. Overlaps of 48 hours or more with existing trips or pending travel requests fail with the conflicting trip or request identified.

ParameterTypeDescription
are_trip_dates_from_booking_receipt_or_user_inputrequiredbooleanAre Trip Dates From Booking Receipt Or User Input
namerequiredstringName
rationalerequiredstringRationale
calendar_timezonestring | nullCalendar Timezone
destinationsarray | nullDestinations
end_datestring | nullEnd Date
idempotency_keystring | nullUnique idempotency key generated by the client. Must be a non-empty string of at most 255 characters.
start_datestring | nullStart Date
trip_purposestring | nullTrip Purpose
ramp_get_booking_details

Get itinerary, stay, or rental details plus request status, amount, payment timing, cancellation state, supplier confirmation numbers, associated spend, error, approval information, and optional booking-specific partner support channels for one flight, hotel, car booking, or travel booking request UUID. Trip and transaction UUIDs are not booking IDs. Approval details concern travel booking requests, not card or spend-limit requests. Use booking status for routine lookups. Optional provider_status supplies stored Atlas hotel or per-segment flight evidence for check-in trouble or missing reservations, not a live provider check, proof of hotel receipt, flight ticket validity, or provider fault. Its observation time is unknown; do not let it override a completed cancellation.

Parameters and full description

Get itinerary, stay, or rental details plus request status, amount, payment timing, cancellation state, supplier confirmation numbers, associated spend, error, approval information, and optional booking-specific partner support channels for one flight, hotel, car booking, or travel booking request UUID. Trip and transaction UUIDs are not booking IDs. Approval details concern travel booking requests, not card or spend-limit requests. Use booking status for routine lookups. Optional provider_status supplies stored Atlas hotel or per-segment flight evidence for check-in trouble or missing reservations, not a live provider check, proof of hotel receipt, flight ticket validity, or provider fault. Its observation time is unknown; do not let it override a completed cancellation.

ParameterTypeDescription
rationalerequiredstringRationale
booking_idstring | nullParent booking UUID, such as a car rental's booking_id or a booking_id returned by another travel tool.
booking_request_idstring | nullTravel booking request UUID (GetBookings booking_request_id).
flight_booking_idstring | nullFlight booking UUID (GetBookings flight_booking_id).
hotel_room_booking_idstring | nullHotel room booking UUID (GetBookings hotel_room_booking_id).
include_provider_statusbooleanInclude Provider Status
ramp_get_booking_service_status

Get the current booking-service availability for flights, hotels, and cars.

Parameters and full description

Get the current booking-service availability for flights, hotels, and cars. Returns current disruptions and advisories for the acting user's flight and hotel providers, plus car booking. A booking type's is_down flag identifies a temporary outage; its message and note can also describe nonblocking advisories. This does not establish the user's booking eligibility or inventory availability.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_get_flight_booking_locations

Resolves locations (airports/cities) available for booking a flight from user intent.

Parameters and full description

Resolves locations (airports/cities) available for booking a flight from user intent. Preserve the user's location wording in ``query``. When the user names a city or metro area such as "NYC", set ``location_type=city``. A returned city ``search_code`` searches all supported airports in that metro; do not ask the user to choose one airport when a city result is available. Use this to answer which airports or cities are bookable for a place, or to list the candidates when a place name is ambiguous. If the results contain multiple plausible locations, present the choices and wait for the user to clarify; never choose a location on their behalf. Do not infer a location from profile data, an area code, or a broad description such as "somewhere warm." Returns locations where flights can be booked from or to, which may include: - Individual airports (e.g., JFK, SFO, LAX) - City groups with multiple airports (e.g., NYC includes JFK, LGA, EWR) - Major travel destinations with flight availability Each result carries a ``search_code`` usable as a flight search departure or arrival. Cities search every airport in the metro area; airports search just that airport.

ParameterTypeDescription
queryrequiredstringQuery
rationalerequiredstringRationale
limitintegerLimit
location_typestringLocation Type
ramp_get_hotel_ratesEarly access

Fetch available room-rate options for one selected hotel from SearchHotels. Use this after the user picks a hotel from SearchHotels results and before booking. Every current room group and its rates for the stay are returned in all_rates; the returned rate.id values are the exact IDs to pass to SubmitHotelBooking. These rates are current options, not quotes - wait for the traveler to select one exact rate. When the result's all_rates_out_of_policy is true, every rate at this hotel is out of policy for the stay: tell the traveler, prefer offering an in-policy hotel from the SearchHotels results, and proceed with this hotel only if the traveler explicitly chooses to - booking will then require an oop_reason at SubmitHotelBooking.

Parameters and full description

Fetch available room-rate options for one selected hotel from SearchHotels. Use this after the user picks a hotel from SearchHotels results and before booking. Every current room group and its rates for the stay are returned in all_rates; the returned rate.id values are the exact IDs to pass to SubmitHotelBooking. These rates are current options, not quotes - wait for the traveler to select one exact rate. When the result's all_rates_out_of_policy is true, every rate at this hotel is out of policy for the stay: tell the traveler, prefer offering an in-policy hotel from the SearchHotels results, and proceed with this hotel only if the traveler explicitly chooses to - booking will then require an oop_reason at SubmitHotelBooking.

ParameterTypeDescription
check_in_daterequiredstringCheck In Date
check_out_daterequiredstringCheck Out Date
hotel_idrequiredstringHotel UUID from SearchHotels results.
rationalerequiredstringRationale
filtersobject | nullOptional rate-level preferences from the traveler's saved or current-trip preferences. Rates meeting more preferences rank higher in recommended_rates, but best-available fallbacks are still returned when nothing matches (see each group's unmet_preferences); all_rates remains the complete selectable inventory.
max_recommended_ratesintegerMax Recommended Rates
num_adultsintegerNum Adults
search_idstring | nullSearch Id
traveler_user_idstring | nullTraveler UUID when retrieving rates on behalf of another user.
ramp_get_pending_travel_requestsEarly access

Retrieves travel/booking requests that are pending approval from the current user.

Parameters and full description

Retrieves travel/booking requests that are pending approval from the current user. Use this when a user asks about travel requests they need to approve. Returns pending flight, hotel, and car rental booking requests that require action.

ParameterTypeDescription
rationalerequiredstringRationale
next_page_cursorstring | nullNext Page Cursor
page_sizeintegerPage Size
ramp_get_traveler_profile

Retrieve a traveler profile and saved free-text flight and hotel preferences.

Parameters and full description

Retrieve a traveler profile and saved free-text flight and hotel preferences. Includes identity, contact details, travel documents, and loyalty programs. Defaults to the acting user. Reading another traveler's profile requires their user UUID and delegate or travel-manager permission; sensitive document fields are masked on delegated reads. Does not change saved preferences.

ParameterTypeDescription
rationalerequiredstringRationale
traveler_user_idstring | nullTraveler user UUID when reading another person's profile for delegated booking. Requires delegate or travel-manager permission. Omit for self-booking.
ramp_list_traveler_loyalty_programs

List saved loyalty programs from the user's traveler profile. Use this directly for loyalty-only list/show/check requests; do not call GetTravelerProfile first.

Parameters and full description

List saved loyalty programs from the user's traveler profile. Use this directly for loyalty-only list/show/check requests; do not call GetTravelerProfile first.

ParameterTypeDescription
rationalerequiredstringRationale
ramp_remove_traveler_loyalty_program

Remove a saved loyalty program from the user's traveler profile.

Parameters and full description

Remove a saved loyalty program from the user's traveler profile.

ParameterTypeDescription
rationalerequiredstringRationale
traveler_loyalty_program_idrequiredstringTraveler Loyalty Program Id
ramp_search_flight_modificationsEarly access

Search replacement flights for an existing booking.

Parameters and full description

Search replacement flights for an existing booking. Identify the booking with exactly one booking identifier field and leave the others null; passing several IDs for the same booking is rejected. First inspect the booking itinerary and ask which leg, date, or route the traveler wants to change. Pass one entry per changed leg, identified by its 0-based ``leg_index``. Unspecified date and airport fields retain the original leg values. When changing both legs of a single-ticket round trip, first search with both leg modifications, present the outbound offers, then call again with the chosen ``selected_outbound_offer_id`` and the same modifications to retrieve matching returns. Split-ticket bookings change one leg per exchange: when several legs are passed, only the earliest requested leg is searched and ``deferred_leg_indexes`` lists the others to change afterwards in their own searches. ``selected_outbound_offer_id`` is rejected for split-ticket bookings. Some bookings support the first search but not this second step, and return an unsupported-provider result with support details; route the traveler to that support rather than retrying. Search prices are estimates; call SubmitFlightModification to re-quote the selected offer with the airline before asking the traveler to confirm. ``recommended_offers`` is always present, ranked from this page of ``offers``; each surface presents those entries in the format it supports, and ``assistant_note`` states which presentation applies. Preference fields (``cabin_class``, ``max_stops``, ``airlines``, timing windows, ``avoid_red_eye_flights``) become this booking's cumulative modification preference state: they carry across the outbound and return steps and later re-searches of the same booking. Omitted preferences retain their prior values; use ``clear_preferences`` only when the traveler removes one. ``applied_preferences`` reports what each response used.

ParameterTypeDescription
rationalerequiredstringRationale
slice_modificationsrequiredarraySlice Modifications
airlinesarray | nullAirlines
avoid_red_eye_flightsboolean | nullAvoid Red Eye Flights
booking_idstring | nullParent booking UUID returned by a travel tool
booking_request_idstring | nullBooking request UUID of an already fulfilled flight booking
cabin_classstring | nullCabin to search replacement flights in; set it to request an upgrade or downgrade. Applies to every leg being changed, not per leg, and is retained for this booking's later modification calls. Omit to keep the prior value or search without a cabin filter.
clear_preferencesarray | nullClear Preferences
cursorstring | nullCursor
flight_booking_idstring | nullFlight booking UUID from GetBookings
limitintegerLimit
max_stopsinteger | nullMax Stops
preferred_arrival_time_windowstring | nullBroad arrival time preference from saved traveler defaults or the request for this change, such as morning, afternoon, or evening. On a selected_outbound_offer_id call it applies to the return options only.
preferred_departure_time_windowstring | nullBroad departure time preference from saved traveler defaults or the request for this change, such as morning, afternoon, or evening. On a selected_outbound_offer_id call it applies to the return options only.
selected_outbound_offer_idstring | nullSelected Outbound Offer Id
ramp_search_hotelEarly access

Search hotels using the canonical Ramp web inventory and policy flow. Before first use in a conversation, load and follow the ramp-book-hotel skill when available.

Parameters and full description

Search hotels using the canonical Ramp web inventory and policy flow. Before first use in a conversation, load and follow the ramp-book-hotel skill when available. Provide location_query (city, neighborhood, address, or landmark) plus check_in_date and check_out_date. location_query text containing 'office', 'HQ', or 'headquarters' is rejected unless latitude and longitude are also passed; to search near an office without coordinates, pass its street address as location_query. API calls run synchronously by default and return ranked hotels - each with at most one summary rate - plus policy_summary, total_count, and web_search_url. Results are paginated from a cached result set: pass the returned next_cursor as cursor to fetch more hotels without triggering a new provider search; never construct or edit a cursor. Put chain requests in filters.chain_names and reserve hotel_name for one exact property; a specific hotel_name uses the targeted direct-hotel path. Passing wait_for_results=false explicitly opts into an asynchronous kickoff that returns status='searching' with a search_id to resume by passing that search_id on a later call. To book from these results, pass the selected hotel id to GetHotelRates, then the selected rate id to SubmitHotelBooking with the same traveler and stay dates.

ParameterTypeDescription
rationalerequiredstringRationale
check_in_datestring | nullCheck In Date
check_out_datestring | nullCheck Out Date
cursorstring | nullCursor
filtersobject | nullOptional filters applied to fresh or cached results. Put chain requests in filters.chain_names; do not pass a chain name as hotel_name.
hotel_namestring | nullHotel Name
latitudenumber | string | nullLatitude
limitintegerLimit
location_querystring | nullLocation Query
longitudenumber | string | nullLongitude
num_adultsintegerNum Adults
preferencesstring | nullPreferences
search_idstring | nullSearch Id
sortobject | nullOptional sort configuration that mirrors web static hotel search.
traveler_user_idstring | nullTraveler UUID when searching on behalf of another user.
wait_for_resultsboolean | nullWait For Results
ramp_set_traveler_loyalty_program

Set one loyalty program on the user's traveler profile by program name and loyalty number.

Parameters and full description

Set one loyalty program on the user's traveler profile by program name and loyalty number. If it already exists, update its loyalty number. After success, continue the active workflow when it requires refreshed data; otherwise tell the user it is saved.

ParameterTypeDescription
loyalty_numberrequiredstringLoyalty Number
program_namerequiredstringProgram Name
rationalerequiredstringRationale
ramp_submit_flight_booking

Book a selected flight offer.

Parameters and full description

Book a selected flight offer. Three explicit actions: use action=preview for an authoritative preview, action=save_seats to update a persisted quote's seats and return a refreshed preview, and action=confirm only after a new, explicit user-authored approval of that latest preview. The legacy confirm input remains supported for existing clients but new callers must use action. The preview (itinerary, price, in-policy status, and required approvals) without booking. When no fund is supplied, the preview uses the recommended eligible fund, if one exists, to determine required approvals. action=confirm requires the previewed expected_total_amount (copied verbatim, digits and decimal point only, no currency symbol) only after a new, explicit user-authored response approves that latest preview. If the fare changes, preview the new total and obtain fresh approval before confirming. flight_offer_uuid is the literal id from search: the outbound flight for one-way, the return flight for round trips (it carries both legs), or a fare option's id to book that fare. Alternatively pass a previous preview's flight_quote_uuid (never both) to preview or confirm that exact persisted quote. On confirmation, pass exactly one funding choice: spend_allocation_id with an eligible fund UUID from the preview, or request_new_fund=true with reason set to the trip purpose. Fares paid only by a business UATP card take no funding choice: United PassPlus fares, and published fares on PassPlus airlines when the company has a PassPlus card (the preview names the card). If the chosen flight is out of policy, you MUST collect an oop_reason from the traveler and pass it here. Before previewing or confirming, call GetTravelerProfile (passing the same traveler_user_id from search for delegated booking); if has_profile is false, collect the traveler's identity details and call UpdateTravelerProfile first. This always creates a new booking and never changes or cancels an existing one; to replace an existing flight with a new booking, follow the ramp-rebook-flight skill.

ParameterTypeDescription
rationalerequiredstringRationale
actionstringAction
airline_credit_surface_call_idstring | nullAirline Credit Surface Call Id
confirmbooleanConfirm
expected_total_amountinteger | number | string | nullExpected Total Amount
flight_offer_uuidstring | nullLiteral 'id' of the chosen flight offer from search (the return flight id for round trips; a fare option's id to book that fare). Pass exactly one of flight_offer_uuid or flight_quote_uuid.
flight_quote_uuidstring | nullflight_quote_uuid from an earlier preview result. Previews or confirms that exact persisted quote instead of creating a fresh quote from the offer, preserving quote-specific state. Pass exactly one of flight_offer_uuid or flight_quote_uuid.
include_seat_optionsboolean | nullInclude Seat Options
oop_reasonstring | nullOop Reason
reasonstring | nullReason
request_new_fundbooleanRequest New Fund
seat_positionstring | nullThe traveler's seat position for this booking ('window', 'aisle', or 'middle'), taken from this conversation or interpreted from their saved preferences text. Returned as traveler_seat_preference on previews that include seat_options so matching seats can be recommended. Never authorizes a paid seat.
seat_selection_surface_call_idstring | nullSeat Selection Surface Call Id
seat_selectionsarray | nullSeat Selections
selection_surface_call_idstring | nullSelection Surface Call Id
spend_allocation_idstring | nullEligible fund UUID to pay with. A preview without one uses the recommended eligible fund when available. On confirmation, provide this or set request_new_fund=true, except for fares paid only by a UATP card (such as United PassPlus fares, or published fares the company's PassPlus card pays), which take no fund and ignore this.
traveler_user_idstring | nullTraveler UUID when booking for someone else; use the value from search. Requires delegate or travel-manager permission. Omit for self-booking.
trip_idstring | nullTrip to attach the booking to. Omit to auto-select or create one.
ramp_submit_flight_cancellationEarly access

Preview or confirm cancellation of an existing flight booking.

Parameters and full description

Preview or confirm cancellation of an existing flight booking. Identify the booking with exactly one booking identifier field and leave the others null; passing several IDs for the same booking is rejected. Always call with ``confirm=false`` first. That call is read-only and returns the complete itinerary, fresh authoritative terms, and a ``preview_id``. Only after a new, explicit user-authored approval of that latest preview may you call again with ``confirm=true`` and the exact ``preview_id``. Earlier cancellation intent, standing approval, or instructions not to ask questions are not confirmation. Atlas- and Duffel-booked flights are supported. Confirmation refetches the canonical details used by the Ramp web flow and refuses to cancel if any term changed. The action always cancels the entire booking; partial passenger or leg cancellation is not supported. Preview ``rendered_response`` contains authoritative plain-text copy to display verbatim. Booking identifiers and the HTTPS ``booking_url`` are separate metadata for client presentation; they are not embedded in that copy.

ParameterTypeDescription
rationalerequiredstringRationale
booking_idstring | nullParent booking UUID returned by a travel tool
booking_request_idstring | nullBooking request UUID from GetBookings or the booking result
confirmbooleanConfirm
flight_booking_idstring | nullFlight booking UUID from GetBookings
preview_idstring | nullPreview Id
ramp_submit_flight_modificationEarly access

Preview or confirm replacement flights for an existing booking.

Parameters and full description

Preview or confirm replacement flights for an existing booking. Identify the booking with exactly one booking identifier field and leave the others null; passing several IDs for the same booking is rejected. Always call with ``confirm=false`` first. The returned preview contains the authoritative itinerary, policy results, and exchange economics; search prices are only estimates. Present the complete preview and request explicit user confirmation before submitting. When ``economics.pricing_is_final`` is false, the airline still reports these amounts as estimates that can change when the ticket is reissued; say so before asking for confirmation. After explicit confirmation, call again with ``confirm=true`` and the exact, unchanged ``preview_id`` from that preview. Confirmation re-quotes the offer and submits only when the terms still match. If the tool returns changed terms, do not auto-confirm: present the new preview and wait for a new explicit confirmation. If the user changes any requested terms, search and preview again.

ParameterTypeDescription
offer_idrequiredstringOffer Id
rationalerequiredstringRationale
booking_idstring | nullParent booking UUID returned by a travel tool
booking_request_idstring | nullBooking request UUID of an already fulfilled flight booking
confirmbooleanConfirm
flight_booking_idstring | nullFlight booking UUID from GetBookings
oop_reasonstring | nullOop Reason
preview_idstring | nullPreview Id
ramp_submit_hotel_bookingEarly access

Book a selected hotel rate.

Parameters and full description

Book a selected hotel rate. Two-step flow: call without confirm for the authoritative preview (price, policy, and required approvals) without creating a booking. When no fund is supplied, the preview uses the recommended eligible fund, if one exists, to determine required approvals. Then call with confirm=true and the previewed expected_total_amount (copied verbatim, digits and decimal point only, no currency symbol) only after a new, explicit user-authored response approves that latest preview. If the rate changes, preview the new total and obtain fresh approval before confirming. Use the exact hotel_id from SearchHotels and rate_id from GetHotelRates. On confirmation, pass exactly one funding choice: spend_allocation_id with an eligible fund UUID from the preview, or request_new_fund=true with reason set to the trip purpose. If the chosen hotel rate is out of policy, you MUST collect an oop_reason from the traveler and pass it here. Before previewing or confirming, call GetTravelerProfile (passing the same traveler_user_id for delegated booking); if has_profile is false, collect the traveler's identity details and call UpdateTravelerProfile first. This always creates a new booking; it never changes or cancels an existing one.

ParameterTypeDescription
check_in_daterequiredstringCheck In Date
check_out_daterequiredstringCheck Out Date
hotel_idrequiredstringHotel UUID from SearchHotels results.
rate_idrequiredstringRate UUID from GetHotelRates for the selected hotel.
rationalerequiredstringRationale
confirmbooleanConfirm
expected_total_amountinteger | number | string | nullExpected Total Amount
oop_reasonstring | nullOop Reason
reasonstring | nullReason
request_new_fundbooleanRequest New Fund
selection_surface_call_idstring | nullSelection Surface Call Id
spend_allocation_idstring | nullEligible fund UUID to pay with. A preview without one uses the recommended eligible fund when available. On confirmation, provide this or set request_new_fund=true.
traveler_user_idstring | nullTraveler UUID when booking for someone else.
trip_idstring | nullTrip UUID to attach this booking to. Omit to auto-select or create.
ramp_submit_hotel_cancellationEarly access

Preview or confirm cancellation of an existing hotel booking.

Parameters and full description

Preview or confirm cancellation of an existing hotel booking. Identify the booking with exactly one booking identifier field and leave the others null; passing several IDs for the same booking is rejected. Always call with ``confirm=false`` first. That call is read-only and returns fresh authoritative terms plus a ``preview_id``. Only after a new, explicit user-authored approval of that latest preview may you call again with ``confirm=true`` and the exact ``preview_id``. Earlier cancellation intent, standing approval, or instructions not to ask questions are not confirmation. Confirmation refetches the canonical details and refuses to cancel if any material hotel cancellation term changed. This tool always cancels the entire hotel booking; use the flight cancellation tool for flights. Preview ``rendered_response`` contains authoritative plain-text copy to display verbatim. Booking identifiers and the HTTPS ``booking_url`` are separate metadata for client presentation; they are not embedded in that copy.

ParameterTypeDescription
rationalerequiredstringRationale
booking_idstring | nullParent booking UUID returned by a travel tool
booking_request_idstring | nullBooking request UUID from GetBookings or the booking result
confirmbooleanConfirm
hotel_room_booking_idstring | nullHotel room booking UUID from GetBookings
preview_idstring | nullPreview Id
ramp_travel_request_actionEarly access

Approve or reject a travel request, or withdraw your own request still awaiting approval.

Parameters and full description

Approve or reject a travel request, or withdraw your own request still awaiting approval. Cancel requires a standalone REQUESTED request with a PENDING approval and no reservation, soft approval, bundle, or modification. APPROVED requests cannot be withdrawn, even with no linked reservation; absent linkage does not establish whether purchase or ticketing has started. Only the request's traveler can withdraw it, not an arranger, administrator, or approver acting for someone else. It never deletes records or cancels reservations. Already cancelled/rejected requests are unchanged. Only act when the user's current instruction explicitly identifies this request or unambiguously refers to this exact request from the immediately preceding assistant preview. Never infer another pending or remaining request after completing an action.

ParameterTypeDescription
actionrequiredstringAction
booking_request_idrequiredstringThe UUID of the booking request to take action on.
rationalerequiredstringRationale
rejection_reasonstring | nullRejection Reason
ramp_update_travel_preferences

Save, change, or remove the acting user's free-text flight and hotel preferences.

Parameters and full description

Save, change, or remove the acting user's free-text flight and hotel preferences. Returns save status, the traveler's UUID, a summary, and the updated preference text. Requires an existing traveler profile; does not update another traveler. Unrelated saved preferences are preserved. An explicit airline, seat-position, or hotel-chain answer, or a flight Starlink request (not general Wi-Fi), can initialize a missing preference, and explicit hotel amenities can be added, without save wording. Replacing one, or saving another category, requires a lasting preference or a request to save. Inferred preferences require the user's confirmation before saving. Do not save one-trip constraints, company policy, fund choices, or sensitive identity, payment, or loyalty account numbers.

ParameterTypeDescription
rationalerequiredstringRationale
requestrequiredstringRequest
ramp_update_traveler_profile

Create or update traveler identity, contact details, and travel document numbers.

Parameters and full description

Create or update traveler identity, contact details, and travel document numbers. Profile-detail updates preserve saved preference text. Legacy structured flight defaults remain accepted and are converted to free text. Does not accept free-text preference changes or natural-language loyalty requests. Defaults to the acting user; another traveler requires their user UUID and delegate or travel-manager permission. Creating a profile requires its identity and contact fields.

ParameterTypeDescription
rationalerequiredstringRationale
avoid_red_eye_flightsboolean | nullAvoid Red Eye Flights
date_of_birthstring | nullDate Of Birth
emailstring | nullEmail
first_namestring | nullFirst Name
home_airport_codestring | nullHome Airport Code
id_genderstring | nullId Gender
known_traveler_numberstring | nullKnown Traveler Number
last_namestring | nullLast Name
loyalty_programsarray | nullLoyalty Programs
max_stopsinteger | nullMax Stops
middle_namestring | nullMiddle Name
name_prefixstring | nullName Prefix
name_suffixstring | nullName Suffix
phone_country_codestring | nullPhone Country Code
phone_numberstring | nullPhone Number
preferred_airlinesarray | nullPreferred Airlines
preferred_arrival_time_windowstring | nullPreferred Arrival Time Window
preferred_cabin_classstring | nullPreferred Cabin Class
preferred_departure_time_windowstring | nullPreferred Departure Time Window
redress_numberstring | nullRedress Number
seat_preferencestring | nullSeat Preference
traveler_user_idstring | nullTraveler user UUID for delegated profile updates. Requires delegate or travel-manager permission. Omit for self-booking.

For the product-level choice, see Connecting.