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_syncGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
sync_typerequired | string | Sync 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_detailsGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
sync_commit_uuidrequired | string | Sync Commit Uuid |
ramp_get_tracking_categoriesRetrieve 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
include_hidden | boolean | Include Hidden |
transaction_uuid | string | null | Actual 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_optionsList 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
tracking_category_uuidrequired | string | UUID 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_hidden | boolean | Include Hidden |
next_page_cursor | integer | null | Next Page Cursor |
page_size | integer | Page Size |
query_string | string | null | Query String |
reimbursement_uuid | string | null | Optional. UUID of the reimbursement being coded; applies conditional filtering by the reimbursement's user/department/etc. |
transaction_uuid | string | null | Optional. UUID of the transaction being coded; applies conditional filtering by the transaction's user/department/etc. |
ramp_mark_ready_to_syncMark objects as ready to sync to your accounting provider
Parameters and full description
Mark objects as ready to sync to your accounting provider
| Parameter | Type | Description |
|---|---|---|
object_idsrequired | array | IDs 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_typerequired | string | The type of object to mark ready to sync. Supported values are TRANSACTION and REIMBURSEMENT. |
Agent cards and x402
ramp_fund_x402_walletFund 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.
| Parameter | Type | Description |
|---|---|---|
amountrequired | number | string | Amount |
rationalerequired | string | Rationale |
source_wallet_account_uuidrequired | string | Source Wallet Account Uuid |
idempotency_key | string | null | Idempotency Key |
ramp_get_agent_card_credsGet 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.
| Parameter | Type | Description |
|---|---|---|
amountrequired | string | Amount |
currency_coderequired | string | Currency Code |
fund_idrequired | string | Fund Id |
merchant_country_coderequired | string | Merchant Country Code |
merchant_namerequired | string | Merchant Name |
merchant_urlrequired | string | Merchant Url |
rationalerequired | string | Rationale |
idempotency_key | string | null | Optional 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_fundsList 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_pay_with_x402Pay 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.
| Parameter | Type | Description |
|---|---|---|
acceptedrequired | object | Exact chosen entry from the challenge's accepts array |
idempotency_keyrequired | string | Idempotency Key |
rationalerequired | string | Rationale |
resourcerequired | object | Resource object from the merchant's 402 challenge |
extensions | object | null | Extensions |
ramp_provision_x402_walletProvision 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.
| Parameter | Type | Description |
|---|---|---|
confirmedrequired | boolean | Confirmed |
rationalerequired | string | Rationale |
ramp_withdraw_x402_walletWithdraw 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.
| Parameter | Type | Description |
|---|---|---|
amountrequired | number | string | Amount |
destination_wallet_account_uuidrequired | string | Destination Wallet Account Uuid |
rationalerequired | string | Rationale |
idempotency_key | string | null | Idempotency Key |
Analytics and AI spend
ramp_get_ai_token_spend_aggregatesAggregate 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).
| Parameter | Type | Description |
|---|---|---|
end_atrequired | string | End At |
metricrequired | string | Metric |
rationalerequired | string | Rationale |
start_atrequired | string | Start At |
configuration_ids | array | null | Configuration Ids |
department_uuids | array | null | Department Uuids |
group_by | array | null | Group By |
model_compute_tier | array | null | Model Compute Tier |
model_context_window | array | null | Model Context Window |
model_families | array | null | Model Families |
model_fine_tune_source | array | null | Model Fine Tune Source |
model_speed | array | null | Model Speed |
model_thinking | array | null | Model Thinking |
models | array | null | Models |
providers | array | null | Providers |
rollup | string | Time bucketing. 'all' returns a single bucket per group; 'daily'/'weekly'/'monthly' return one row per bucket per group. |
tag_definition_id | string | null | Tag Definition Id |
user_uuids | array | null | User Uuids |
ramp_get_ai_token_spend_connectionsSummarize 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_get_ai_token_spend_current_spendReport 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_get_ai_token_spend_filter_optionsList 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_get_my_ai_token_spend_aggregatesAggregate 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.
| Parameter | Type | Description |
|---|---|---|
end_atrequired | string | End At |
rationalerequired | string | Rationale |
start_atrequired | string | Start At |
group_by | array | null | Group By |
model_compute_tier | array | null | Model Compute Tier |
model_context_window | array | null | Model Context Window |
model_families | array | null | Model Families |
model_fine_tune_source | array | null | Model Fine Tune Source |
model_speed | array | null | Model Speed |
model_thinking | array | null | Model Thinking |
models | array | null | Models |
providers | array | null | Providers |
rollup | string | Time 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_billApprove 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.
| Parameter | Type | Description |
|---|---|---|
action_typerequired | string | Action Type |
bill_idrequired | string | Bill Id |
rationalerequired | string | Rationale |
reason | string | null | Reason |
ramp_approve_or_reject_reimbursementApprove 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).
| Parameter | Type | Description |
|---|---|---|
actionrequired | string | The action to take on the reimbursement: approve or reject. |
rationalerequired | string | Rationale |
reimbursement_idrequired | string | Reimbursement Id |
thoughts | string | null | Thoughts |
user_reason | string | null | User Reason |
ramp_approve_or_reject_requestApprove 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.
| Parameter | Type | Description |
|---|---|---|
actionrequired | string | The action to perform: APPROVE or REJECT. ADMIN_APPROVE is unsupported; use the app for admin approval. |
rationalerequired | string | Rationale |
thoughtsrequired | string | Thoughts |
unified_request_idrequired | string | null | Unified Request Id |
approval_instance_uuid | string | null | Approval Instance Uuid |
reason | string | null | Reason |
user_confirmed_admin_approval | boolean | User Confirmed Admin Approval |
ramp_approve_or_reject_transactionApprove 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.
| Parameter | Type | Description |
|---|---|---|
actionrequired | string | Action to perform: APPROVE, REJECT_AND_REQUEST_CHANGES (send back to cardholder with requested revisions), or REJECT_AND_REQUEST_FULL_REPAYMENT (require employee repayment). |
rationalerequired | string | Rationale |
thoughtsrequired | string | Thoughts |
transaction_idrequired | string | The transaction to act on |
user_reason | string | null | User Reason |
ramp_get_bills_for_approvalGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
limit | integer | Limit |
page_cursor | string | null | Page Cursor |
ramp_get_reimbursements_for_approvalGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
limit | integer | Limit |
ramp_get_requests_to_reviewGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
thoughtsrequired | string | Thoughts |
page_size | integer | Page Size |
request_types | array | null | Request Types |
start | string | null | Start |
ramp_remind_bill_approversRemind 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.
| Parameter | Type | Description |
|---|---|---|
bill_uuidsrequired | array | Bill Uuids |
rationalerequired | string | Rationale |
Banking and treasury
ramp_account_numbersList agent account numbers
Parameters and full description
List agent account numbers
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Why this MCP tool call is needed. |
page_size | integer | null | The 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. |
start | string | null | The ID of the last entity of the previous page, used for pagination to get the next page. |
ramp_accountsList bank accounts
Parameters and full description
List bank accounts
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Why this MCP tool call is needed. |
connection_provider | string | null | Filter bank accounts by connection provider. |
page_size | integer | null | The 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. |
start | string | null | The ID of the last entity of the previous page, used for pagination to get the next page. |
ramp_createCreate a manually connected bank account
Parameters and full description
Create a manually connected bank account
| Parameter | Type | Description |
|---|---|---|
account_numberrequired | string | Bank account number. |
account_subtyperequired | string | Bank account subtype. |
rationalerequired | string | Why this MCP tool call is needed. |
routing_numberrequired | string | ABA routing number used for ACH transfers. |
account_name | string | null | Optional display name for the bank account. |
idempotency_key | string | null | Unique idempotency key generated by the client. Must be a non-empty string of at most 255 characters. |
wire_details | object | null | Optional wire-transfer details for the account. |
ramp_get_account_balance_historyGet 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.
| Parameter | Type | Description |
|---|---|---|
account_uuidrequired | string | Account Uuid |
rationalerequired | string | Rationale |
end_date | string | null | End Date |
start_date | string | null | Start Date |
ramp_get_investment_account_balanceGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_get_managed_portfolio_account_balanceGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_get_ramp_business_account_balanceGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_get_treasury_balance_historyGet 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.
| Parameter | Type | Description |
|---|---|---|
end_daterequired | string | End Date |
rationalerequired | string | Rationale |
start_daterequired | string | Start Date |
ramp_get_treasury_document_linkGet 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
| Parameter | Type | Description |
|---|---|---|
document_typerequired | string | Value for document_type. |
document_uuidrequired | string | Value for document_uuid. |
rationalerequired | string | Value for rationale. |
ramp_get_treasury_documents_download_linkGet 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.
| Parameter | Type | Description |
|---|---|---|
documentsrequired | array | Documents |
rationalerequired | string | Rationale |
ramp_list_business_accountsList 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_list_treasury_accountsList 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).
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_list_treasury_documentsList 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
| Parameter | Type | Description |
|---|---|---|
document_typerequired | string | Value for document_type. |
rationalerequired | string | Value for rationale. |
cursor | string | null | Value for cursor. |
end_date | string | null | Value for end_date. |
start_date | string | null | Value for start_date. |
ramp_list_wallet_transfersList 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
cursor | string | null | Cursor 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_date | string | null | From Date |
page_size | integer | Page Size |
to_date | string | null | To Date |
wallet_account_uuid | string | null | Filter transfers to this Ramp wallet account UUID. Omit to list transfers across accessible wallet accounts. |
ramp_request_fundsRequest funds for a banking account
Parameters and full description
Request funds for a banking account
| Parameter | Type | Description |
|---|---|---|
amountrequired | object | Amount to request in minor currency units |
banking_account_idrequired | string | Unique identifier of the banking account. |
external_bank_account_idrequired | string | External bank account to request funds from |
rationalerequired | string | Why this MCP tool call is needed. |
agent_account_number_id | string | null | Agent account number to receive the funds. If omitted, the banking account's primary account number is used |
idempotency_key | string | null | Unique idempotency key generated by the client. Must be a non-empty string of at most 255 characters. |
memo | string | null | Optional reason for the funding request |
Bills and vendor payments
ramp_create_draft_billCreate 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.
| Parameter | Type | Description |
|---|---|---|
draft_billrequired | object | Draft bill fields to set at creation. Do not include vendor fields; vendor_uuid is the only vendor input. |
rationalerequired | string | Briefly explain why you are calling this tool: what goal or workflow it serves and what you intend to do with the result. |
vendor_uuidrequired | string | UUID 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_key | string | null | Unique idempotency key generated by the client. Must be a non-empty string of at most 255 characters. |
ramp_create_payeeCreate 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.
| Parameter | Type | Description |
|---|---|---|
contactrequired | object | Required primary vendor contact with an email explicitly provided by the user. Never infer or invent an email. |
countryrequired | string | Required vendor country as an ISO 3166-1 alpha-2 code, explicitly provided by the user; never assume US. |
namerequired | string | Name |
rationalerequired | string | Rationale |
owner_user_uuids | array | null | Owner User Uuids |
state | string | null | State |
website | string | null | Website |
ramp_get_bill_amount_summaryGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
due_date_from | string | null | Due Date From |
due_date_to | string | null | Due Date To |
max_amount | number | null | Max Amount |
min_amount | number | null | Min Amount |
payment_status | string | null | Payment Status |
vendor_name | string | null | Vendor Name |
ramp_get_bill_commentsRetrieve 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.
| Parameter | Type | Description |
|---|---|---|
bill_idrequired | string | Bill Id |
rationalerequired | string | Rationale |
ramp_get_bill_detailsGet 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.
| Parameter | Type | Description |
|---|---|---|
bill_idrequired | string | Bill Id |
rationalerequired | string | Rationale |
ramp_get_bill_historyRetrieve 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.
| Parameter | Type | Description |
|---|---|---|
bill_idrequired | string | Bill Id |
rationalerequired | string | Rationale |
ramp_get_bill_invoicesRetrieve 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.
| Parameter | Type | Description |
|---|---|---|
bill_idrequired | string | Bill Id |
rationalerequired | string | Rationale |
ramp_get_bill_metricsReturns 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
approval_status | string | null | Approval Status |
from_due_date | string | null | From Due Date |
is_draft | boolean | null | Is Draft |
payment_status | string | null | Payment Status |
status_summary | string | null | Status Summary |
to_due_date | string | null | To Due Date |
vendor_name | string | null | Vendor Name |
ramp_get_bill_statusGet 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.
| Parameter | Type | Description |
|---|---|---|
bill_idrequired | string | Bill Id |
rationalerequired | string | Rationale |
ramp_get_draft_bill_detailsGet 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.
| Parameter | Type | Description |
|---|---|---|
bill_idrequired | string | The UUID of an active, unsubmitted draft bill. Pass only the UUID, not a full URL, invoice number, or payment ID. |
rationalerequired | string | Rationale |
return_line_items | boolean | Return Line Items |
ramp_get_recurring_billRetrieve 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
recurring_bill_idrequired | string | Recurring Bill Id |
ramp_get_rfx_vendor_responsesReturn all submitted vendor responses for an RFX.
Parameters and full description
Return all submitted vendor responses for an RFX.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
rfx_idrequired | string | Rfx Id |
ramp_get_vendor_agreementRetrieve 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.
| Parameter | Type | Description |
|---|---|---|
payee_agreement_uuidrequired | string | Payee Agreement Uuid |
rationalerequired | string | Rationale |
ramp_get_vendor_banking_detailsList 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.
| Parameter | Type | Description |
|---|---|---|
payee_uuidrequired | string | Payee Uuid |
rationalerequired | string | Rationale |
ramp_get_vendor_document_bulk_statusGet 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.
| Parameter | Type | Description |
|---|---|---|
batch_idrequired | string | Batch Id |
rationalerequired | string | Rationale |
is_w_document | boolean | null | Is W Document |
ramp_invite_vendors_to_rfxInvite 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
rfx_idrequired | string | Rfx Id |
vendorsrequired | array | Vendors |
ramp_list_billsList 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
include_archived | boolean | Include Archived |
include_paid | boolean | Include Paid |
limit | integer | Limit |
page_cursor | string | null | Page Cursor |
query | string | null | Query |
ramp_list_vendor_agreementsList 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
auto_renews | boolean | null | Auto Renews |
contract_owner_ids | array | null | Contract Owner Ids |
department_ids | array | null | Department Ids |
evaluate_price_benchmarks | boolean | Evaluate Price Benchmarks |
has_end_date | boolean | null | Has End Date |
include_archived | boolean | Include Archived |
include_vendor_spend | boolean | Include Vendor Spend |
is_active | boolean | null | Is Active |
is_up_for_renewal | boolean | null | Is Up For Renewal |
limit | integer | Limit |
max_days_remaining | integer | null | Max Days Remaining |
max_end_date | string | null | Max End Date |
max_last_date_to_terminate | string | null | Max Last Date To Terminate |
max_start_date | string | null | Max Start Date |
max_total_value | number | string | null | Max Total Value |
min_days_remaining | integer | null | Min Days Remaining |
min_end_date | string | null | Min End Date |
min_last_date_to_terminate | string | null | Min Last Date To Terminate |
min_start_date | string | null | Min Start Date |
min_total_value | number | string | null | Min Total Value |
payee_agreement_ids | array | null | Payee Agreement Ids |
payee_owner_ids | array | null | Payee Owner Ids |
payee_uuid | string | null | Payee Uuid |
renewal_status | array | null | Renewal Status |
sort_ascending | boolean | null | Sort Ascending |
sort_by | string | null | Sort results by: TOTAL_AMOUNT, NUM_DAYS_REMAINING, or END_DATE. Default: NUM_DAYS_REMAINING ascending. |
vendor_name | string | null | Vendor Name |
ramp_request_bill_invoice_upload_linkCreate 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.
| Parameter | Type | Description |
|---|---|---|
draft_bill_idrequired | string | UUID of the unsubmitted draft bill to attach the invoice to. |
rationalerequired | string | Rationale |
ramp_revoke_rfx_vendor_invitationRemove 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
rfx_vendor_invitation_idrequired | string | Rfx Vendor Invitation Id |
ramp_search_billsSearch 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
accrual_year_month | string | null | Accrual Year Month |
exact_amount | object | null | Optional 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_date | string | null | From Due Date |
from_payment_date | string | null | From Payment Date |
include_archived | boolean | Include Archived |
include_drafts | boolean | null | Include Drafts |
include_paid | boolean | null | Include Paid |
invoice_number | string | null | Invoice Number |
limit | integer | Limit |
page_cursor | string | null | Page Cursor |
query | string | Query |
status_summaries | array | null | Status Summaries |
to_due_date | string | null | To Due Date |
to_payment_date | string | null | To Payment Date |
ramp_search_vendorsSearch 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
include_draft | boolean | Include Draft |
is_1099_tracking_enabled | boolean | null | Is 1099 Tracking Enabled |
limit | integer | Limit |
search_term | string | null | Search Term |
search_terms | array | null | Search Terms |
tax_1099_year | integer | null | Tax 1099 Year |
ramp_set_rfx_vendor_invitation_contactSet 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.
| Parameter | Type | Description |
|---|---|---|
payee_contact_idrequired | string | Payee Contact Id |
rationalerequired | string | Rationale |
rfx_vendor_invitation_idrequired | string | Rfx Vendor Invitation Id |
ramp_submit_draft_billSubmit 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.
| Parameter | Type | Description |
|---|---|---|
draft_bill_idrequired | string | UUID of the active DRAFT_READY bill draft to submit. |
rationalerequired | string | Rationale |
ramp_update_draft_billUpdate 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.
| Parameter | Type | Description |
|---|---|---|
provisional_billrequired | object | Draft 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_idrequired | string | UUID of the draft bill to update |
rationalerequired | string | Briefly explain why you are calling this tool: what goal or workflow it serves and what you intend to do with the result. |
versionrequired | string | Expected current draft version. A stale value is rejected and the error returns the latest version. |
vendor_payments | array | null | Draft 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_cardActivate 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.
| Parameter | Type | Description |
|---|---|---|
last_fourrequired | string | Last Four |
rationalerequired | string | Rationale |
confirm_delivery | boolean | Confirm Delivery |
ramp_add_user_to_shared_fundAdd 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
spend_allocation_uuidrequired | string | Spend Allocation Uuid |
agent_id | string | null | Agent Id |
enable_sharing_if_needed | boolean | Enable Sharing If Needed |
role | string | Role |
user_email | string | null | User Email |
ramp_archive_spend_allocationArchive 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
spend_allocation_uuidrequired | string | Spend Allocation Uuid |
ramp_edit_user_role_on_shared_fundChange 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.
| Parameter | Type | Description |
|---|---|---|
new_rolerequired | string | New Role |
rationalerequired | string | Rationale |
spend_allocation_uuidrequired | string | Spend Allocation Uuid |
user_emailrequired | string | User Email |
ramp_enable_shared_fund_accessEnable 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
spend_allocation_uuidrequired | string | Spend Allocation Uuid |
ramp_get_card_statement_balanceGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_get_fundsRetrieve 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
agent_card_eligible | boolean | null | Agent Card Eligible |
cursor | string | null | Cursor |
for_transaction_id | string | null | For Transaction Id |
fund_uuid | string | null | Fund Uuid |
fund_uuids | array | null | Fund Uuids |
funds_to_retrieve | string | null | Scope 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_members | boolean | Include Members |
include_restrictions | boolean | Include Restrictions |
is_shared | boolean | null | Is Shared |
page_size | integer | Page Size |
primary_card_eligible | boolean | null | Primary Card Eligible |
search_by_fund_display_name | string | null | Search By Fund Display Name |
spend_intent_uuids | array | null | Spend Intent Uuids |
state | string | null | Filter 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_uuids | array | null | User Uuids |
ramp_issue_one_off_fundsIssue 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.
| Parameter | Type | Description |
|---|---|---|
amountrequired | string | Amount |
display_namerequired | string | Display Name |
rationalerequired | string | Rationale |
user_idsrequired | array | User Ids |
categories_blacklist | array | null | Categories Blacklist |
categories_whitelist | array | null | Categories Whitelist |
default_member_limit_amount | string | null | Default Member Limit Amount |
department_ids | array | null | Department Ids |
dynamic_user_group_ids | array | null | Dynamic User Group Ids |
entity_id | string | null | Business 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. |
interval | string | Interval |
is_shareable | boolean | Is Shareable |
location_ids | array | null | Location Ids |
lock_date | string | null | Lock Date |
member_ids | array | null | Member Ids |
user_custom_field_ids | array | null | User Custom Field Ids |
vendor_blacklist | array | null | Vendor Blacklist |
vendor_whitelist | array | null | Vendor Whitelist |
ramp_limit_increaseIncrease 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.
| Parameter | Type | Description |
|---|---|---|
amountrequired | number | string | Amount |
rationalerequired | string | Rationale |
action | string | Action |
card_id | string | null | The card ID whose limit should be increased. Must provide either this or spend_allocation_id, not both. |
expected_current_limit | number | string | null | Expected Current Limit |
increase_type | string | Increase Type |
reason | string | null | Reason |
spend_allocation_id | string | null | The spend allocation (fund) ID whose limit should be increased. Must provide either this or card_id, not both. |
user_confirmed_increase_type | boolean | User Confirmed Increase Type |
user_confirmed_limit_increase | boolean | User Confirmed Limit Increase |
ramp_list_cardsList 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
cardholder_user_uuid | string | null | Optional 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_cardLock 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.
| Parameter | Type | Description |
|---|---|---|
actionrequired | string | Action |
idrequired | string | The UUID of a card returned by ListCards with can_lock_or_unlock=true. |
rationalerequired | string | Rationale |
ramp_lock_or_unlock_spend_allocationLock 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.
| Parameter | Type | Description |
|---|---|---|
actionrequired | string | Action |
idrequired | string | Id |
rationalerequired | string | Rationale |
ramp_lock_or_unlock_spend_allocation_memberLock 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.
| Parameter | Type | Description |
|---|---|---|
actionrequired | string | Action |
idrequired | string | Id |
member_idrequired | string | Member Id |
rationalerequired | string | Rationale |
ramp_remove_user_from_shared_fundRemove a user from a shared fund using user_email.
Parameters and full description
Remove a user from a shared fund using user_email.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
spend_allocation_uuidrequired | string | Spend Allocation Uuid |
user_emailrequired | string | User Email |
ramp_submit_fund_requestSubmit 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.
| Parameter | Type | Description |
|---|---|---|
amountrequired | string | Amount |
descriptionrequired | string | Description |
frequencyrequired | string | How 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. |
namerequired | string | Name |
rationalerequired | string | Rationale |
user_confirmationrequired | string | User Confirmation |
currency | string | ISO 4217 currency code. Defaults to USD; do not ask the user to specify it unless they want a different currency. |
request_type | string | Request Type |
ramp_transfer_spend_allocation_ownershipTransfer 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.
| Parameter | Type | Description |
|---|---|---|
current_user_emailrequired | string | Current User Email |
new_user_emailrequired | string | New User Email |
rationalerequired | string | Rationale |
spend_allocation_uuidrequired | string | Spend Allocation Uuid |
ramp_unarchive_spend_allocationUnarchive a fund so it becomes visible and spendable again.
Parameters and full description
Unarchive a fund so it becomes visible and spendable again.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
spend_allocation_uuidrequired | string | Spend Allocation Uuid |
ramp_unlock_fraud_locked_cardUnlock 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.
| Parameter | Type | Description |
|---|---|---|
idrequired | string | UUID 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. |
rationalerequired | string | Rationale |
user_confirmed_fraud_whitelist | boolean | User Confirmed Fraud Whitelist |
ramp_update_category_restrictionsUpdate 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.
| Parameter | Type | Description |
|---|---|---|
actionrequired | string | The 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_idsrequired | array | Category Ids |
rationalerequired | string | Rationale |
spend_allocation_idrequired | string | Spend Allocation Id |
ramp_update_fund_entityMove 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.
| Parameter | Type | Description |
|---|---|---|
entity_idrequired | string | UUID of the business entity to move the funds to. |
fund_idsrequired | array | Fund Ids |
rationalerequired | string | Rationale |
ramp_update_merchant_restrictionsUpdate 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
| Parameter | Type | Description |
|---|---|---|
actionrequired | string | Whether to add or remove merchants from the list. |
merchant_uuidsrequired | array | Merchant Uuids |
rationalerequired | string | Rationale |
restriction_typerequired | string | Whether to modify the allowed merchants (whitelist) or blocked merchants (blacklist). |
spend_allocation_idrequired | string | Spend Allocation Id |
ramp_update_spend_allocation_intervalUpdate only the spend interval for a spend allocation.
Parameters and full description
Update only the spend interval for a spend allocation.
| Parameter | Type | Description |
|---|---|---|
intervalrequired | string | New spend interval (for example: DAILY, WEEKLY, MONTHLY, TOTAL) |
rationalerequired | string | Rationale |
spend_allocation_uuidrequired | string | Spend Allocation Uuid |
Other
ramp_agent_wallet_listList policy versions for a standalone Agent Wallet
Parameters and full description
List policy versions for a standalone Agent Wallet
| Parameter | Type | Description |
|---|---|---|
agent_idrequired | string | Standalone agent ID returned by the list agents tool. |
rationalerequired | string | Why this MCP tool call is needed. |
limit | integer | null | Value for limit. |
ramp_api_key_spendList provider API keys and their estimated spend
Parameters and full description
List provider API keys and their estimated spend
| Parameter | Type | Description |
|---|---|---|
from_daterequired | string | Start date of the requested period in UTC, inclusive. Must be on or after 2023-01-01. The period can span up to 365 days. |
rationalerequired | string | Why this MCP tool call is needed. |
to_daterequired | string | End date of the requested period in UTC, exclusive. The period can span up to 365 days. |
page_size | integer | null | Number of results to return per page. Defaults to 20. Must be between 2 and 100. |
providers | array | null | Comma-separated providers to include. Omit to include all supported providers. |
start | string | null | Opaque cursor returned in page.next from the previous page. |
statuses | array | null | Comma-separated current API key statuses to include. Omit to exclude terminated API keys. |
ramp_askDelegate 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
| Parameter | Type | Description |
|---|---|---|
questionrequired | string | Question |
rationalerequired | string | Why this MCP tool call is needed. |
idempotency_key | string | null | Unique idempotency key generated by the client. Must be a non-empty string of at most 255 characters. |
wait_seconds | integer | Wait Seconds |
ramp_audit_logs_listGet audit log events
Parameters and full description
Get audit log events
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Why this MCP tool call is needed. |
agent_names | array | null | Filter by customer-visible agent labels that executed the action |
event_actor_types | array | null | Filter by audit log events of these actor types |
event_types | array | null | Filter by audit log events of these types |
from_date | string | null | Filter by audit log events created at or after this date. start_time is accepted as a compatibility alias. |
object_id | string | null | Filter 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_size | integer | null | The 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_name | string | null | Filter by audit log events referencing this resource name. The object ID must also be provided when filtering by resource name. |
start | string | null | The ID of the last entity of the previous page, used for pagination to get the next page. |
to_date | string | null | Filter by audit log events created at or before this date. end_time is accepted as a compatibility alias. |
user_ids | array | null | Filter by audit log events attributed to these user IDs |
ramp_award_sourcing_eventAward 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.
| Parameter | Type | Description |
|---|---|---|
payee_uuidrequired | string | UUID of the winning vendor (payee) to award |
rationalerequired | string | Rationale |
sourcing_event_idrequired | string | Sourcing Event Id |
ramp_close_sourcing_eventClose (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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
sourcing_event_idrequired | string | Sourcing Event Id |
ramp_continueSend a follow-up message to an Ask Ramp session
Parameters and full description
Send a follow-up message to an Ask Ramp session
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Why this MCP tool call is needed. |
responserequired | string | Response |
session_idrequired | string | Unique identifier of the AskRamp session. |
idempotency_key | string | null | Unique idempotency key generated by the client. Must be a non-empty string of at most 255 characters. |
input_request_id | string | null | Input Request Id |
wait_seconds | integer | Wait Seconds |
ramp_create_client_financing_applicationCreate 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.
| Parameter | Type | Description |
|---|---|---|
business_name_legalrequired | string | Business Name Legal |
rationalerequired | string | Rationale |
allow_possible_duplicate | boolean | Allow Possible Duplicate |
ap_only | boolean | Ap Only |
business_email | string | null | Business Email |
business_website | string | null | Business Website |
firm_roles | array | null | Firm Roles |
idempotency_key | string | null | Unique idempotency key generated by the client. Must be a non-empty string of at most 255 characters. |
ramp_create_draft_spend_request_from_sourcing_eventHand 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
sourcing_event_idrequired | string | Sourcing Event Id |
payee_uuid | string | null | Optional vendor (payee) UUID for the spend request. Defaults to the sourcing event's awarded vendor. |
rfx_id | string | null | Rfx Id |
spend_intent_uuid | string | null | Optional spend program UUID to draft under. Omit to let the backend pick the best-fit procurement spend program. |
ramp_create_rfxCreate 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.
| Parameter | Type | Description |
|---|---|---|
namerequired | string | Name |
rationalerequired | string | Rationale |
sectionsrequired | array | Sections |
close_date | string | null | Close Date |
description | string | null | Description |
response_submission_deadline | string | null | Response Submission Deadline |
rfx_type | string | Type of RFX: RFI (Request for Information), RFP (Request for Proposal), or RFQ (Request for Quotation) |
sourcing_event_id | string | null | Sourcing Event Id |
sourcing_event_name | string | null | Sourcing Event Name |
ramp_daily_usageList 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
| Parameter | Type | Description |
|---|---|---|
from_daterequired | string | Start date of the requested period in UTC, inclusive. The period can span up to 365 days. |
rationalerequired | string | Why this MCP tool call is needed. |
to_daterequired | string | End date of the requested period in UTC, exclusive. The period can span up to 365 days. |
group_by | array | null | Comma-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. |
models | array | null | Comma-separated exact provider model names to include. Omit to include all models. |
page_size | integer | null | Number of results to return per page. Defaults to 20. Must be between 2 and 100. |
products | array | null | Comma-separated exact product names to include. Requires group_by to include product. Omit to include all products. |
providers | array | null | Comma-separated AI providers to include. Omit to include all providers. |
start | string | null | Opaque cursor returned in page.next from the previous page. |
ramp_delete_commentDelete 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.
| Parameter | Type | Description |
|---|---|---|
comment_uuidrequired | string | Comment Uuid |
rationalerequired | string | Rationale |
ramp_delete_spend_programDelete (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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
spend_intent_uuidrequired | string | Spend Intent Uuid |
spend_intent_delete_action | string | null | Action 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_uuid | string | null | Transfer To Spend Intent Uuid |
ramp_edit_commentReplace 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.
| Parameter | Type | Description |
|---|---|---|
comment_uuidrequired | string | Comment Uuid |
messagerequired | string | Message |
rationalerequired | string | Rationale |
mention_user_uuids | array | null | Mention User Uuids |
message_format | string | PLAIN_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_budgetExplain 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
spend_typerequired | string | Which kind of spend item to check: transaction, bill, or reimbursement. |
spend_uuidrequired | string | Spend Uuid |
ramp_getFetch a statement
Parameters and full description
Fetch a statement
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Why this MCP tool call is needed. |
statement_idrequired | string | Value for statement_id. |
ramp_get_application_detailsGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_get_application_invitesList 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_get_application_statusGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_get_approval_chain_detailsFetch 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
approval_instance_uuid | string | null | Approval Instance Uuid |
workflow_execution_uuid | string | null | Workflow Execution Uuid |
ramp_get_authorized_businessesRetrieve 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
after | string | null | After |
business_name_filter | string | null | Business Name Filter |
page_size | integer | Page Size |
ramp_get_bookingsRetrieve 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
booking_reference | string | null | Booking Reference |
city | string | null | City |
flight_airline | string | null | Flight Airline |
flight_number | string | null | Flight Number |
hotel_name | string | null | Hotel Name |
include_cars | boolean | Include Cars |
include_failed | boolean | Include Failed |
include_flights | boolean | Include Flights |
include_hotels | boolean | Include Hotels |
include_past | boolean | Include Past |
limit | integer | Limit |
travel_date | string | null | Travel Date |
traveler_user_id | string | null | Optional 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_mode | boolean | Verification Mode |
ramp_get_business_statement_dateGet 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
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Value for rationale. |
ramp_get_decline_explanationGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
transaction_uuidrequired | string | The UUID of the declined transaction |
ramp_get_delegated_travelersList 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
name_search | string | null | Name Search |
ramp_get_erp_connection_statusGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_get_expense_workflow_contextResolve 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
reimbursement_uuid | string | null | Reimbursement UUID or reimbursement alias to inspect. Provide exactly one expense reference. |
transaction_uuid | string | null | Transaction UUID or transaction alias to inspect. Provide exactly one expense reference. |
ramp_get_missing_items_by_userGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
only_missing_receipt | boolean | Only Missing Receipt |
page_cursor | string | null | Page Cursor |
page_size | integer | Page Size |
user_limit | integer | User Limit |
ramp_get_office_locationsRetrieve 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_get_pending_request_itemsGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_get_planning_budgetRead 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
cursor | string | null | Cursor |
dimension_value | object | null | Returns 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_amounts | boolean | Include Amounts |
line_path_prefix | string | null | Line Path Prefix |
page_size | integer | Page Size |
totals_from_month | string | null | Totals From Month |
totals_to_month | string | null | Totals To Month |
ramp_get_planning_dimensionsRead 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_get_remaining_budget_amountGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
entity | string | null | Entity |
period_scope | string | Time 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_number | integer | null | Row Number |
ramp_get_resultGet the current result of an Ask Ramp session
Parameters and full description
Get the current result of an Ask Ramp session
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Why this MCP tool call is needed. |
session_idrequired | string | Unique identifier of the AskRamp session. |
wait_seconds | integer | null | Value for wait_seconds. |
ramp_get_rfx_detailGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
rfx_idrequired | string | Rfx Id |
ramp_get_rfx_grading_overviewGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
rfx_idrequired | string | Rfx Id |
ramp_get_rfx_response_summarySummarize vendor response and grading progress for a specific RFX.
Parameters and full description
Summarize vendor response and grading progress for a specific RFX.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
rfx_idrequired | string | Rfx Id |
ramp_get_sourcing_event_contextGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
sourcing_event_idrequired | string | Sourcing Event Id |
ramp_get_user_tripsFetch trips for the acting user with optional filters.
Parameters and full description
Fetch trips for the acting user with optional filters.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
cursor | string | null | Cursor |
page_size | integer | null | Page Size |
status | string | null | Status |
ramp_holdPlace a hold on a vendor
Parameters and full description
Place a hold on a vendor
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Why this MCP tool call is needed. |
vendor_idrequired | string | Unique identifier of the vendor. |
reason | string | null | Reason |
ramp_hold_releaseRelease Vendor Hold
Parameters and full description
Release Vendor Hold
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Why this MCP tool call is needed. |
vendor_idrequired | string | Unique identifier of the vendor. |
ramp_invite_client_to_review_financing_applicationEmail 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.
| Parameter | Type | Description |
|---|---|---|
first_namerequired | string | First Name |
invitee_emailrequired | string | Invitee Email |
last_namerequired | string | Last Name |
partner_setup_enabledrequired | boolean | Partner Setup Enabled |
rationalerequired | string | Rationale |
ramp_issue_from_spend_programIssue 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
spend_intent_uuidrequired | string | Spend Intent Uuid |
department_ids | array | null | Department Ids |
display_name | string | null | Display Name |
dynamic_user_group_ids | array | null | Dynamic User Group Ids |
issue_to_all_users | boolean | Issue To All Users |
location_ids | array | null | Location Ids |
lock_date | string | null | Lock Date |
spend_amount | string | null | Spend Amount |
spend_currency | string | null | Currency code to use when issuing from a custom spend intent. Only required for custom spend intents; omit for fixed spend intents. |
spend_interval | string | null | Custom 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_ids | array | null | User Custom Field Ids |
user_ids | array | null | User Ids |
ramp_list_budgetsList 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
include_inactive | boolean | Include Inactive |
ramp_list_business_entitiesList 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
name_filter | string | null | Name Filter |
ramp_list_planning_budget_spendList 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
amount_type | string | null | — |
cursor | string | null | Cursor |
from_month | string | null | From Month |
line_path | string | null | Line Path |
page_size | integer | Page Size |
sort_by | string | — |
sort_direction | string | Sort Direction |
to_month | string | null | To Month |
unassigned_only | boolean | Unassigned Only |
ramp_list_policiesList 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
kinds | array | null | Kinds |
ramp_list_sourcing_eventsList 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
page_cursor | string | null | Page Cursor |
page_size | integer | Page Size |
ramp_manage_rfx_collaboratorsAdd 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
rfx_idrequired | string | UUID of the RFX to modify collaborators on |
add_user_uuids | array | null | Add User Uuids |
remove_user_uuids | array | null | Remove User Uuids |
ramp_mark_rfx_gradedMark 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
rfx_idrequired | string | Rfx Id |
ramp_merchant_listList merchants
Parameters and full description
List merchants
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Why this MCP tool call is needed. |
merchant_name | string | null | Filter merchants by a case-sensitive display name prefix. |
merchant_url | string | null | Filter merchants by URL or domain after normalization. |
page_size | integer | null | The 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. |
start | string | null | The ID of the last entity of the previous page, used for pagination to get the next page. |
transaction_from_date | string | null | Filter merchants by transactions occurring (`user_transaction_time`) on or after this date |
transaction_to_date | string | null | Filter merchants by transactions occurring (`user_transaction_time`) on or before this date |
ramp_mpp_credsIssue 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
| Parameter | Type | Description |
|---|---|---|
fund_idrequired | string | UUID of the existing fund to pay from |
rationalerequired | string | Why this MCP tool call is needed. |
www_authenticaterequired | array | Www Authenticate |
body_digest | string | null | Body Digest |
idempotency_key | string | null | Unique idempotency key generated by the client. Must be a non-empty string of at most 255 characters. |
selected_challenge_id | string | null | Selected Challenge Id |
ramp_publish_rfxPublish 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
rfx_idrequired | string | Rfx Id |
ramp_reporting_describe_datasetDescribe 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.
| Parameter | Type | Description |
|---|---|---|
namerequired | string | Name |
rationalerequired | string | Rationale |
ramp_reporting_get_skillReturn 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_reporting_list_datasetsList 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_reporting_lookup_search_tagsLook 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.
| Parameter | Type | Description |
|---|---|---|
lookup_requestsrequired | array | Lookup Requests |
rationalerequired | string | Rationale |
context | string | null | Context |
data_source | string | null | The 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_queryQuery 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).
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
report_queryrequired | object | Semantic 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_size | integer | null | Page Size |
query_scope | string | null | Result-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. |
start | string | null | Start |
ramp_reporting_search_catalogSearch 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.
| Parameter | Type | Description |
|---|---|---|
nl_queryrequired | string | Nl Query |
rationalerequired | string | Rationale |
limit | integer | Limit |
ramp_resolve_approval_targetResolve 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
approval_instance_uuid | string | null | Approval Instance Uuid |
entity_type | string | null | UNIFIED_REQUEST resolves a unified-request ID, falling back to a spend-request UUID. SPEND_REQUEST requires a spend-request UUID. |
entity_uuid | string | null | Entity Uuid |
history_requested | boolean | History Requested |
page_url | string | null | Page Url |
workflow_execution_uuid | string | null | Workflow Execution Uuid |
ramp_return_rfx_to_draftReturn 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
rfx_idrequired | string | Rfx Id |
ramp_rolesList custom roles
Parameters and full description
List custom roles
No parameters exposed in the tool schema.
ramp_search_flightsSearches 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
additional_arrivals | array | null | Additional Arrivals |
additional_departures | array | null | Additional Departures |
airlines | array | null | Airlines |
arrival | string | null | Arrival |
avoid_red_eye_flights | boolean | null | Avoid Red Eye Flights |
cabin_class | string | array | null | Cabin Class |
clear_preferences | array | null | Clear Preferences |
cursor | string | null | Cursor |
departure | string | null | Departure |
departure_date | string | null | Departure Date |
include_fare_options | boolean | Include Fare Options |
include_recommendations | boolean | Include Recommendations |
job_id | string | null | ID 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. |
limit | integer | Limit |
max_stops | integer | null | Max Stops |
only_airline_credit_eligible | boolean | null | Only Airline Credit Eligible |
only_split_tickets | boolean | null | Only Split Tickets |
outbound_offer_id | string | null | Outbound 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_airlines | array | null | Preferred Airlines |
preferred_arrival_time_window | string | null | Arrival time preference for the current leg, such as morning, afternoon, or evening. On an outbound_offer_id read, it applies to return offers. |
preferred_connectivity | string | null | Soft 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_window | string | null | Departure time preference for the current leg, such as morning, afternoon, or evening. On an outbound_offer_id read, it applies to return offers. |
presentation | object | null | On a job_id read (outbound, or return with outbound_offer_id), returns exactly these offers from that view as the recommendations. |
requested_weekday | string | null | Weekday 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_class | string | null | Only 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_id | string | null | Legacy alias for job_id when resuming or paging a search. Use job_id for new calls. |
return_date | string | null | Return Date |
return_preferred_arrival_time_window | string | null | Return-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_window | string | null | Return-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_id | string | null | Legacy alias for job_id with outbound_offer_id. Use job_id for new calls. |
sort_key | string | null | Result 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_id | string | null | UUID of the traveler when searching for someone else. Omit to search for the current user. |
trip_id | string | null | Optional Ramp trip UUID to associate with this search. |
wait_for_results | boolean | Wait For Results |
ramp_search_merchantsSearch 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.
| Parameter | Type | Description |
|---|---|---|
queryrequired | string | Query |
rationalerequired | string | Rationale |
limit | integer | Limit |
ramp_send_rfx_response_reminderSend 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
rfx_idrequired | string | Rfx Id |
rfx_vendor_invitation_ids | array | null | Rfx Vendor Invitation Ids |
ramp_set_decline_bufferSet 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.
| Parameter | Type | Description |
|---|---|---|
allowed_overage_percentrequired | number | string | null | Allowed Overage Percent |
rationalerequired | string | Rationale |
target_typerequired | string | Where 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_mode | string | null | For 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_id | string | null | Target Id |
ramp_set_rfx_cover_sheetSet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
rfx_idrequired | string | Rfx Id |
attachment_ramp_document_ids | array | null | Attachment Ramp Document Ids |
body_markdown | string | null | Body Markdown |
ramp_set_rfx_pricing_sheetSet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
rfx_idrequired | string | Rfx Id |
attachment_ramp_document_ids | array | null | Attachment Ramp Document Ids |
currency | string | null | Currency |
guidance_markdown | string | null | Guidance Markdown |
ramp_statements_listList statements
Parameters and full description
List statements
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Why this MCP tool call is needed. |
from_date | string | null | Filter statements with end_date on or after this date (ISO8601 format). |
page_size | integer | null | The 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. |
start | string | null | The ID of the last entity of the previous page, used for pagination to get the next page. |
to_date | string | null | Filter statements with end_date on or before this date (ISO8601 format). Defaults to current time. |
ramp_team_spendList 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
| Parameter | Type | Description |
|---|---|---|
from_daterequired | string | Start date of the requested period in UTC, inclusive. The period can span up to 365 days. |
rationalerequired | string | Why this MCP tool call is needed. |
to_daterequired | string | End date of the requested period in UTC, exclusive. The period can span up to 365 days. |
is_anomalous | boolean | null | Filter by whether Ramp detected anomalous AI spend during the requested period. Omit to include all users. |
page_size | integer | null | Number of results to return per page. Defaults to 20. Must be between 2 and 100. |
providers | array | null | Comma-separated AI providers to include. Omit to include all supported providers. |
start | string | null | Opaque cursor returned in page.next from the previous page. |
ramp_update_client_financing_applicationFill 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
beneficial_owners | array | null | Beneficial Owners |
business | object | null | Business details to save. |
controlling_officer | object | null | The 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_details | object | null | Expected monthly spend to save. |
ownership_acknowledgement | string | null | Ownership Acknowledgement |
ramp_update_rfxUpdate 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
rfx_idrequired | string | Rfx Id |
sectionsrequired | array | Sections |
close_date | string | null | Close Date |
description | string | null | Description |
name | string | null | Name |
response_submission_deadline | string | null | Response Submission Deadline |
People and organization
ramp_create_departmentCreate 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.
| Parameter | Type | Description |
|---|---|---|
department_namerequired | string | Department Name |
rationalerequired | string | Rationale |
ramp_departmentsList 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
name_filter | string | null | Name Filter |
ramp_get_org_chartGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
user_id | string | null | Ramp 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_detailGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_list_usersList 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
department_ids | array | null | Department Ids |
include_agents | boolean | Include Agents |
location_ids | array | null | Location Ids |
name_search | string | null | Name Search |
page_cursor | string | null | Page Cursor |
page_size | integer | Page Size |
ramp_rename_departmentRename 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).
| Parameter | Type | Description |
|---|---|---|
department_idrequired | string | Department Id |
department_namerequired | string | Department Name |
rationalerequired | string | Rationale |
ramp_search_userMatch 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
searchrequired | string | Search |
transaction_id | string | null | UUID 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_questionGet 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.
| Parameter | Type | Description |
|---|---|---|
questionrequired | string | Question |
rationalerequired | string | Rationale |
include_restrictions | boolean | Include Restrictions |
ramp_get_attention_feedReturn 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
fanout_timeout_seconds | number | Fanout Timeout Seconds |
sections | array | null | Sections |
ramp_get_employee_submission_policy_requirementsGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_get_more_toolsReport 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.
| Parameter | Type | Description |
|---|---|---|
contextrequired | string | Context |
rationalerequired | string | Rationale |
ramp_get_policy_detailsFetch 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.
| Parameter | Type | Description |
|---|---|---|
kindrequired | string | Which policy family to query. Must match the kind returned by ListPolicies for this UUID. |
policy_uuidrequired | string | UUID 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). |
rationalerequired | string | Rationale |
ramp_get_policy_workflow_bodyFetch 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.
| Parameter | Type | Description |
|---|---|---|
kindrequired | string | Which policy family to query. |
policy_uuidrequired | string | UUID of the policy whose workflow body to fetch. Accepts either the policy's own UUID or the backing ProductWorkflow UUID. |
rationalerequired | string | Rationale |
workflow_uuid | string | null | Optional 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_policyPublish the active policy for a standalone Agent Wallet
Parameters and full description
Publish the active policy for a standalone Agent Wallet
| Parameter | Type | Description |
|---|---|---|
agent_idrequired | string | Standalone agent ID returned by the list agents tool. |
configurationsrequired | array | Configurations |
constraintsrequired | object | — |
policy_versionrequired | string | Policy Version |
rationalerequired | string | Why this MCP tool call is needed. |
schema_versionrequired | integer | Schema Version |
approval_mode | string | — |
approval_validity_seconds | integer | Approval Validity Seconds |
ramp_post_commentPost 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.
| Parameter | Type | Description |
|---|---|---|
messagerequired | string | Message |
ramp_object_typerequired | string | Type 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_uuidrequired | string | Ramp Object Uuid |
rationalerequired | string | Rationale |
mention_user_uuids | array | null | Mention User Uuids |
message_format | string | PLAIN_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_snippetsSearch 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.
| Parameter | Type | Description |
|---|---|---|
queryrequired | string | Query |
rationalerequired | string | Rationale |
exclude_article_keys | array | null | On 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_variants | string | array | null | Query Variants |
top_k | integer | Top K |
ramp_simulate_policy_workflow_for_expenseSimulate 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.
| Parameter | Type | Description |
|---|---|---|
kindrequired | string | Policy family to simulate. Use approval_policy for post-spend approval routing, or submission_policy for required expense fields. |
policy_uuidrequired | string | UUID of the policy to simulate. This may be the policy UUID or the backing ProductWorkflow UUID from page context. |
rationalerequired | string | Rationale |
reimbursement_uuid | string | null | Reimbursement UUID or reimbursement alias to simulate. Provide exactly one expense reference. |
transaction_uuid | string | null | Transaction UUID or transaction alias to simulate. Provide exactly one expense reference. |
workflow_uuid | string | null | Optional historical Workflow UUID to simulate instead of the latest published workflow or saved draft. |
Procurement and purchase orders
ramp_delete_procurement_draftDelete an abandoned procurement draft owned by the acting user.
Parameters and full description
Delete an abandoned procurement draft owned by the acting user.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
spend_request_uuidrequired | string | Draft spend request UUID returned by draft_procurement_request. |
ramp_find_procurement_deflection_matchesFind 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.
| Parameter | Type | Description |
|---|---|---|
payee_uuidsrequired | array | Payee Uuids |
rationalerequired | string | Rationale |
request_summary | string | null | Request Summary |
ramp_get_purchase_order_detailsGet 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.
| Parameter | Type | Description |
|---|---|---|
purchase_order_idrequired | string | Purchase Order Id |
rationalerequired | string | Rationale |
ramp_get_unified_request_detailsGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
unified_request_idrequired | string | Unified Request Id |
include_form_details | boolean | Include Form Details |
ramp_procurement_requests_draftCreate 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
answers | array | null | Answers |
change_request_answers | array | null | Change Request Answers |
clear_change_request_field_ids | array | null | Clear Change Request Field Ids |
clear_field_ids | array | null | Clear Field Ids |
currency | string | null | ISO 4217 currency code, e.g. USD. |
existing_spend_request_uuid | string | null | The 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_memo | string | null | Internal Memo |
line_items | array | null | Line Items |
request_name | string | null | Request Name |
request_virtual_card | boolean | null | Request Virtual Card |
spend_intent_uuid | string | null | Spend intent UUID returned by spend-intents. Provide this when starting a new procurement request. Mutually exclusive with existing_spend_request_uuid. |
spend_request_uuid | string | null | Draft spend request UUID returned by this tool. Provide this to continue editing a draft. |
ramp_procurement_requests_getRefresh 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
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Value for rationale. |
spend_request_uuidrequired | string | Value for spend_request_uuid. |
ramp_procurement_spend_intentsList published procurement spend programs the agent can draft against.
Parameters and full description
List published procurement spend programs the agent can draft against.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
page_size | integer | Page Size |
query | string | null | Query |
ramp_procurement_submitSubmit a procurement draft after explicit user confirmation.
Parameters and full description
Submit a procurement draft after explicit user confirmation.
| Parameter | Type | Description |
|---|---|---|
confirmedrequired | boolean | Confirmed |
rationalerequired | string | Rationale |
spend_request_uuidrequired | string | Draft spend request UUID returned by draft. |
ramp_ramp_bulk_close_purchase_ordersClose 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.
| Parameter | Type | Description |
|---|---|---|
close_reasonrequired | string | Close Reason |
purchase_order_uuidsrequired | array | Purchase Order Uuids |
rationalerequired | string | Rationale |
ramp_ramp_bulk_reopen_purchase_ordersReopen 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.
| Parameter | Type | Description |
|---|---|---|
purchase_order_uuidsrequired | array | Purchase Order Uuids |
rationalerequired | string | Rationale |
ramp_search_purchase_ordersSearch for purchase orders using structured purchase order filters.
Parameters and full description
Search for purchase orders using structured purchase order filters.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
filters | object | null | Compact 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_progress | boolean | Include Progress |
limit | integer | Limit |
page_cursor | string | null | Page Cursor |
ramp_search_unified_requestsSearch 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
filters | object | null | Compact 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. |
limit | integer | Limit |
page_cursor | string | null | Page Cursor |
ramp_update_purchase_order_ownerUpdate 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.
| Parameter | Type | Description |
|---|---|---|
new_owner_uuidrequired | string | New Owner Uuid |
purchase_order_uuidrequired | string | Purchase Order Uuid |
rationalerequired | string | Rationale |
Reimbursements
ramp_cancel_reimbursement_paymentRequest 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
reimbursement_uuidrequired | string | null | UUID of the reimbursement in the current business whose payment should be canceled. |
notes | string | null | Notes |
ramp_create_mileage_reimbursementCreate 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.
| Parameter | Type | Description |
|---|---|---|
distancerequired | number | string | Distance |
distance_unitsrequired | string | Unit of the supplied distance: MILES or KILOMETERS. |
end_locationrequired | string | End Location |
memorequired | string | Memo |
rationalerequired | string | Rationale |
start_locationrequired | string | Start Location |
transaction_daterequired | string | Transaction Date |
idempotency_key | string | null | Unique idempotency key generated by the client. Must be a non-empty string of at most 255 characters. |
vehicle_mileage_class | string | null | Vehicle class when required by the mileage country; omit when not applicable. |
ramp_create_reimbursement_from_receiptCreate 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
receipt_uuidrequired | string | Real 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. |
amount | number | string | null | Amount |
currency_code | string | null | Currency Code |
merchant | string | null | Merchant |
transaction_date | string | null | Transaction Date |
ramp_delete_reimbursementDelete 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
reimbursement_uuidrequired | string | null | Reimbursement Uuid |
ramp_duplicate_reimbursementCopy 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
reimbursement_uuidrequired | string | null | UUID of the source reimbursement in the current business to copy into a new draft. |
ramp_edit_reimbursementEdit 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
reimbursement_uuidrequired | string | null | UUID of the reimbursement to modify. Look up the reimbursement to determine the UUID if it cannot be obtained from context. |
accounting_split_request | object | null | Complete 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. |
amount | number | string | null | Amount |
attendee_user_uuids | array | null | Attendee User Uuids |
currency_code | string | null | Currency Code |
custom_record_values | array | null | Custom Record Values |
fund_uuid | string | null | UUID of the fund (spend allocation) to charge this reimbursement to. Null is ignored. |
memo | string | null | Memo |
merchant_name | string | null | Merchant Name |
merchant_uuid | string | null | Canonical merchant UUID. Omit unless changing it on a DRAFT reimbursement. Resending the saved value outside DRAFT is rejected. Null is ignored. |
reimbursement_date | string | null | Reimbursement Date |
tracking_category_selections | array | null | Tracking Category Selections |
trip_uuid | string | null | Trip UUID to associate. Null is ignored. |
ramp_estimate_mileage_reimbursementEstimate 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.
| Parameter | Type | Description |
|---|---|---|
distancerequired | number | string | Distance |
rationalerequired | string | Rationale |
distance_units | string | The distance unit: MILES or KILOMETERS. Defaults to MILES. |
transaction_date | string | null | Transaction Date |
vehicle_mileage_class | string | null | The vehicle mileage class, required for some countries (e.g. France, Finland). |
ramp_estimate_per_diem_amountEstimate 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.
| Parameter | Type | Description |
|---|---|---|
end_daterequired | string | End Date |
rationalerequired | string | Rationale |
start_daterequired | string | Start Date |
trip_uuidrequired | string | Trip Uuid |
day_data | array | null | Day Data |
deduct_weekends | boolean | null | Deduct Weekends |
meals_provided | boolean | null | Meals Provided |
ramp_get_outstanding_reimbursements_by_currencyGet 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.
| Parameter | Type | Description |
|---|---|---|
new_currencyrequired | string | New Currency |
rationalerequired | string | Rationale |
entity_uuid | string | null | Entity Uuid |
ramp_get_reimbursement_receiptsRetrieve receipts attached to a reimbursement.
Parameters and full description
Retrieve receipts attached to a reimbursement.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
reimbursement_uuidrequired | string | null | Reimbursement Uuid |
ramp_get_reimbursementsList 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
from_date | string | null | From Date |
include_comments | boolean | Include Comments |
include_policy_assessment | boolean | Include Policy Assessment |
include_suggestions | boolean | Include Suggestions |
next_page_cursor | string | null | Next Page Cursor |
page_size | integer | Page Size |
reimbursement_uuids | array | null | Reimbursement Uuids |
reimbursements_to_retrieve | string | Which set of reimbursements to search: your own reimbursements, reimbursements awaiting your approval, or all reimbursements across the business |
search_string | string | null | Search String |
tags | array | null | Tags |
to_date | string | null | To Date |
ramp_get_user_recent_reimbursementsGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
include_drafts | boolean | Include Drafts |
include_rejected | boolean | Include Rejected |
limit | integer | null | Limit |
up_to_days | integer | Up To Days |
use_submitted_date_ordering | boolean | Use Submitted Date Ordering |
ramp_resubmit_reimbursementRevert 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
reimbursement_uuidrequired | string | null | UUID of the rejected reimbursement in the current business to reopen as a draft. |
ramp_search_reimbursementsSearch 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
accounting_sync_status | string | null | Filter 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). |
filters | object | null | Text-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_date | string | null | From Date |
from_submitted_date | string | null | From Submitted Date |
include_comments | boolean | Include Comments |
include_policy_assessment | boolean | Include Policy Assessment |
include_suggestions | boolean | Include Suggestions |
next_page_cursor | string | null | Next Page Cursor |
page_size | integer | Page Size |
reimbursement_status | array | null | Reimbursement Status |
reimbursement_types | array | null | Reimbursement Types |
reimbursement_uuids | array | null | Reimbursement Uuids |
reimbursements_to_retrieve | string | null | Which 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_string | string | null | Search String |
to_date | string | null | To Date |
to_submitted_date | string | null | To Submitted Date |
user_id | integer | null | User Id |
ramp_search_user_reimbursementsView 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
accounting_sync_status | string | null | Filter 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). |
filters | object | null | Text-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_date | string | null | From Date |
from_submitted_date | string | null | From Submitted Date |
include_comments | boolean | Include Comments |
include_policy_assessment | boolean | Include Policy Assessment |
include_suggestions | boolean | Include Suggestions |
next_page_cursor | string | null | Next Page Cursor |
page_size | integer | Page Size |
reimbursement_status | array | null | Reimbursement Status |
reimbursement_types | array | null | Reimbursement Types |
reimbursement_uuids | array | null | Reimbursement Uuids |
reimbursements_to_retrieve | string | null | Which 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_string | string | null | Search String |
to_date | string | null | To Date |
to_submitted_date | string | null | To Submitted Date |
ramp_submit_reimbursementSubmit 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
reimbursement_uuidrequired | string | null | UUID 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_transactionAttach 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
receipt_uuidrequired | string | UUID of the receipt to attach, e.g. from CreateReceipt or a receipt listing. Not the upload file_id or internal receipt_id. |
transaction_uuidrequired | string | UUID of the transaction to attach the receipt to. |
ramp_complete_transaction_revisionComplete 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
reasonrequired | string | Reason |
transaction_uuidrequired | string | UUID of the revision-requested transaction to complete. |
ramp_edit_transactionEdit 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
transaction_uuidrequired | string | null | UUID of the transaction to modify. Call GetUserTransactions to determine the UUID if it cannot be obtained from context. |
attendee_selections | object | null | Attendee 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_uuid | string | null | Fund Uuid |
memo | string | null | Memo |
tracking_category_selections | array | null | Tracking Category Selections |
trip_selection | object | null | Trip 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_fields | array | null | User Submitted Fields |
ramp_get_candidate_trips_for_transactionFetch 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_get_full_transaction_metadataView 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.
| Parameter | Type | Description |
|---|---|---|
idrequired | string | null | Transaction id (from tool calls or metadata) |
rationalerequired | string | Rationale |
ramp_get_receipt_detailsGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
receipt_uuidsrequired | array | Receipt Uuids |
ramp_get_transaction_missing_itemsCheck 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.
| Parameter | Type | Description |
|---|---|---|
idrequired | string | null | Transaction UUID or transaction alias. |
rationalerequired | string | Rationale |
ramp_get_transaction_suggested_memosGet AI-suggested memo/note options for a specific transaction.
Parameters and full description
Get AI-suggested memo/note options for a specific transaction.
| Parameter | Type | Description |
|---|---|---|
idrequired | string | null | The ID of the transaction to retrieve suggested memos for. |
rationalerequired | string | Rationale |
ramp_get_transactionsSearch 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
transactions_to_retrieverequired | string | Which set of transactions to search. |
card_uuid | string | null | Restrict results to this exact card, within the selected transaction scope. |
details_to_include_in_response | array | null | Details To Include In Response |
end_at | string | null | End At |
filters | object | null | Structured filters by merchant, category, spend allocation, trip, or tracking category. |
include_count | boolean | Include Count |
next_page_cursor | string | null | Next Page Cursor |
only_missing_items | boolean | Only Missing Items |
page_size | integer | Page Size |
reason_memo_merchant_or_user_name_text_search | string | null | Reason Memo Merchant Or User Name Text Search |
sort | object | null | Sort order. Defaults to transaction_date desc. |
start_at | string | null | Start At |
state | string | null | Filter by state. Defaults to non-declined; 'all' returns every non-declined state but never declines; set 'declined' for declined/failed. |
ramp_list_unmatched_receiptsList 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
from_transaction_date | string | null | From Transaction Date |
merchant | string | null | Merchant |
offset | integer | Offset |
page_size | integer | Page Size |
to_transaction_date | string | null | To Transaction Date |
ramp_mark_transaction_missing_receiptFlag 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
transaction_uuidrequired | string | null | Transaction Uuid |
ramp_merchant_categoriesList 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_provide_no_receipt_reasonSubmit a reason explaining why a transaction has no receipt.
Parameters and full description
Submit a reason explaining why a transaction has no receipt.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
reasonrequired | string | Reason |
transaction_uuidrequired | string | null | Transaction Uuid |
ramp_request_receipt_upload_linkCreate 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
transaction_uuid | string | null | ID of the card transaction that needs a receipt. Omit for out-of-pocket or reimbursement receipts to create an unattached receipt. |
ramp_request_transaction_repaymentRequest 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
reasonrequired | string | Reason |
thoughtsrequired | string | Thoughts |
transaction_idrequired | string | The UUID of the transaction to request repayment for. |
ramp_search_receiptsSearch 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
keywords | array | null | Keywords |
offset | integer | Offset |
page_size | integer | Page Size |
query | string | null | Query |
received_after | string | null | Received After |
received_before | string | null | Received Before |
scope | string | Scope |
ramp_splitSplit 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
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Why this MCP tool call is needed. |
transaction_idrequired | string | Value for transaction_id. |
ramp_update_transaction_amount_limitSet 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.
| Parameter | Type | Description |
|---|---|---|
new_transaction_amount_limitrequired | number | string | New Transaction Amount Limit |
rationalerequired | string | Rationale |
card_id | string | null | Card Id |
spend_allocation_id | string | null | Spend Allocation Id |
ramp_upload_receipt_fileUpload 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.
| Parameter | Type | Description |
|---|---|---|
content_typerequired | string | Content Type |
file_content_base64required | string | File Content Base64 |
filenamerequired | string | Filename |
rationalerequired | string | Rationale |
transaction_uuid | string | null | Optional UUID of a transaction to auto-attach the receipt to. |
Travel
ramp_booking_cancellation_detailsCheck 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.
| Parameter | Type | Description |
|---|---|---|
booking_idrequired | string | Parent 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. |
rationalerequired | string | Rationale |
ramp_booking_modification_detailsCheck 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
booking_id | string | null | Parent reservation UUID, including a car rental's booking UUID. |
booking_request_id | string | null | Booking-request UUID linked to an existing reservation. |
flight_booking_id | string | null | Flight sub-booking UUID, not the parent reservation UUID. |
flight_leg_index | integer | null | Flight Leg Index |
hotel_room_booking_id | string | null | Hotel room sub-booking UUID, not the parent reservation UUID. |
ramp_create_tripCreate 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.
| Parameter | Type | Description |
|---|---|---|
are_trip_dates_from_booking_receipt_or_user_inputrequired | boolean | Are Trip Dates From Booking Receipt Or User Input |
namerequired | string | Name |
rationalerequired | string | Rationale |
calendar_timezone | string | null | Calendar Timezone |
destinations | array | null | Destinations |
end_date | string | null | End Date |
idempotency_key | string | null | Unique idempotency key generated by the client. Must be a non-empty string of at most 255 characters. |
start_date | string | null | Start Date |
trip_purpose | string | null | Trip Purpose |
ramp_get_booking_detailsGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
booking_id | string | null | Parent booking UUID, such as a car rental's booking_id or a booking_id returned by another travel tool. |
booking_request_id | string | null | Travel booking request UUID (GetBookings booking_request_id). |
flight_booking_id | string | null | Flight booking UUID (GetBookings flight_booking_id). |
hotel_room_booking_id | string | null | Hotel room booking UUID (GetBookings hotel_room_booking_id). |
include_provider_status | boolean | Include Provider Status |
ramp_get_booking_service_statusGet 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_get_flight_booking_locationsResolves 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.
| Parameter | Type | Description |
|---|---|---|
queryrequired | string | Query |
rationalerequired | string | Rationale |
limit | integer | Limit |
location_type | string | Location Type |
ramp_get_hotel_ratesFetch 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.
| Parameter | Type | Description |
|---|---|---|
check_in_daterequired | string | Check In Date |
check_out_daterequired | string | Check Out Date |
hotel_idrequired | string | Hotel UUID from SearchHotels results. |
rationalerequired | string | Rationale |
filters | object | null | Optional 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_rates | integer | Max Recommended Rates |
num_adults | integer | Num Adults |
search_id | string | null | Search Id |
traveler_user_id | string | null | Traveler UUID when retrieving rates on behalf of another user. |
ramp_get_pending_travel_requestsRetrieves 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
next_page_cursor | string | null | Next Page Cursor |
page_size | integer | Page Size |
ramp_get_traveler_profileRetrieve 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
traveler_user_id | string | null | Traveler 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_programsList 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
ramp_remove_traveler_loyalty_programRemove 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
traveler_loyalty_program_idrequired | string | Traveler Loyalty Program Id |
ramp_search_flight_modificationsSearch 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
slice_modificationsrequired | array | Slice Modifications |
airlines | array | null | Airlines |
avoid_red_eye_flights | boolean | null | Avoid Red Eye Flights |
booking_id | string | null | Parent booking UUID returned by a travel tool |
booking_request_id | string | null | Booking request UUID of an already fulfilled flight booking |
cabin_class | string | null | Cabin 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_preferences | array | null | Clear Preferences |
cursor | string | null | Cursor |
flight_booking_id | string | null | Flight booking UUID from GetBookings |
limit | integer | Limit |
max_stops | integer | null | Max Stops |
preferred_arrival_time_window | string | null | Broad 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_window | string | null | Broad 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_id | string | null | Selected Outbound Offer Id |
ramp_search_hotelSearch 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
check_in_date | string | null | Check In Date |
check_out_date | string | null | Check Out Date |
cursor | string | null | Cursor |
filters | object | null | Optional filters applied to fresh or cached results. Put chain requests in filters.chain_names; do not pass a chain name as hotel_name. |
hotel_name | string | null | Hotel Name |
latitude | number | string | null | Latitude |
limit | integer | Limit |
location_query | string | null | Location Query |
longitude | number | string | null | Longitude |
num_adults | integer | Num Adults |
preferences | string | null | Preferences |
search_id | string | null | Search Id |
sort | object | null | Optional sort configuration that mirrors web static hotel search. |
traveler_user_id | string | null | Traveler UUID when searching on behalf of another user. |
wait_for_results | boolean | null | Wait For Results |
ramp_set_traveler_loyalty_programSet 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.
| Parameter | Type | Description |
|---|---|---|
loyalty_numberrequired | string | Loyalty Number |
program_namerequired | string | Program Name |
rationalerequired | string | Rationale |
ramp_submit_flight_bookingBook 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
action | string | Action |
airline_credit_surface_call_id | string | null | Airline Credit Surface Call Id |
confirm | boolean | Confirm |
expected_total_amount | integer | number | string | null | Expected Total Amount |
flight_offer_uuid | string | null | Literal '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_uuid | string | null | flight_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_options | boolean | null | Include Seat Options |
oop_reason | string | null | Oop Reason |
reason | string | null | Reason |
request_new_fund | boolean | Request New Fund |
seat_position | string | null | The 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_id | string | null | Seat Selection Surface Call Id |
seat_selections | array | null | Seat Selections |
selection_surface_call_id | string | null | Selection Surface Call Id |
spend_allocation_id | string | null | Eligible 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_id | string | null | Traveler UUID when booking for someone else; use the value from search. Requires delegate or travel-manager permission. Omit for self-booking. |
trip_id | string | null | Trip to attach the booking to. Omit to auto-select or create one. |
ramp_submit_flight_cancellationPreview 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
booking_id | string | null | Parent booking UUID returned by a travel tool |
booking_request_id | string | null | Booking request UUID from GetBookings or the booking result |
confirm | boolean | Confirm |
flight_booking_id | string | null | Flight booking UUID from GetBookings |
preview_id | string | null | Preview Id |
ramp_submit_flight_modificationPreview 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.
| Parameter | Type | Description |
|---|---|---|
offer_idrequired | string | Offer Id |
rationalerequired | string | Rationale |
booking_id | string | null | Parent booking UUID returned by a travel tool |
booking_request_id | string | null | Booking request UUID of an already fulfilled flight booking |
confirm | boolean | Confirm |
flight_booking_id | string | null | Flight booking UUID from GetBookings |
oop_reason | string | null | Oop Reason |
preview_id | string | null | Preview Id |
ramp_submit_hotel_bookingBook 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.
| Parameter | Type | Description |
|---|---|---|
check_in_daterequired | string | Check In Date |
check_out_daterequired | string | Check Out Date |
hotel_idrequired | string | Hotel UUID from SearchHotels results. |
rate_idrequired | string | Rate UUID from GetHotelRates for the selected hotel. |
rationalerequired | string | Rationale |
confirm | boolean | Confirm |
expected_total_amount | integer | number | string | null | Expected Total Amount |
oop_reason | string | null | Oop Reason |
reason | string | null | Reason |
request_new_fund | boolean | Request New Fund |
selection_surface_call_id | string | null | Selection Surface Call Id |
spend_allocation_id | string | null | Eligible 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_id | string | null | Traveler UUID when booking for someone else. |
trip_id | string | null | Trip UUID to attach this booking to. Omit to auto-select or create. |
ramp_submit_hotel_cancellationPreview 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
booking_id | string | null | Parent booking UUID returned by a travel tool |
booking_request_id | string | null | Booking request UUID from GetBookings or the booking result |
confirm | boolean | Confirm |
hotel_room_booking_id | string | null | Hotel room booking UUID from GetBookings |
preview_id | string | null | Preview Id |
ramp_travel_request_actionApprove 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.
| Parameter | Type | Description |
|---|---|---|
actionrequired | string | Action |
booking_request_idrequired | string | The UUID of the booking request to take action on. |
rationalerequired | string | Rationale |
rejection_reason | string | null | Rejection Reason |
ramp_update_travel_preferencesSave, 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
requestrequired | string | Request |
ramp_update_traveler_profileCreate 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.
| Parameter | Type | Description |
|---|---|---|
rationalerequired | string | Rationale |
avoid_red_eye_flights | boolean | null | Avoid Red Eye Flights |
date_of_birth | string | null | Date Of Birth |
email | string | null | |
first_name | string | null | First Name |
home_airport_code | string | null | Home Airport Code |
id_gender | string | null | Id Gender |
known_traveler_number | string | null | Known Traveler Number |
last_name | string | null | Last Name |
loyalty_programs | array | null | Loyalty Programs |
max_stops | integer | null | Max Stops |
middle_name | string | null | Middle Name |
name_prefix | string | null | Name Prefix |
name_suffix | string | null | Name Suffix |
phone_country_code | string | null | Phone Country Code |
phone_number | string | null | Phone Number |
preferred_airlines | array | null | Preferred Airlines |
preferred_arrival_time_window | string | null | Preferred Arrival Time Window |
preferred_cabin_class | string | null | Preferred Cabin Class |
preferred_departure_time_window | string | null | Preferred Departure Time Window |
redress_number | string | null | Redress Number |
seat_preference | string | null | Seat Preference |
traveler_user_id | string | null | Traveler user UUID for delegated profile updates. Requires delegate or travel-manager permission. Omit for self-booking. |
For the product-level choice, see Connecting.