git clone https://github.com/Athe1st3154/awesome-claude-skills-cn
T=$(mktemp -d) && git clone --depth=1 https://github.com/Athe1st3154/awesome-claude-skills-cn "$T" && mkdir -p ~/.claude/skills && cp -r "$T/composio-skills/ramp-automation" ~/.claude/skills/athe1st3154-awesome-claude-skills-cn-ramp-automation && rm -rf "$T"
composio-skills/ramp-automation/SKILL.mdRamp Automation
Automate Ramp corporate finance operations including retrieving transactions, managing reimbursements, searching expenses, viewing card details, and listing users for expense management and accounting workflows.
Toolkit docs: composio.dev/toolkits/ramp
设置
This skill requires the Rube MCP server connected at
https://rube.app/mcp.
Before executing any tools, ensure an active connection exists for the
ramp toolkit. If no connection is active, initiate one via RUBE_MANAGE_CONNECTIONS.
Core Workflows
1. List All Transactions
Retrieve all corporate card transactions with comprehensive filtering options.
Tool:
RAMP_GET_ALL_TRANSACTIONS
Key Parameters:
-- Transactions after this date (ISO 8601 datetime)from_date
-- Transactions before this date (ISO 8601 datetime, default: today)to_date
-- Filter by user UUIDuser_id
-- Filter by physical card UUIDcard_id
-- Filter by department UUIDdepartment_id
-- Filter by merchant UUIDmerchant_id
-- Filter by business entity UUIDentity_id
/min_amount
-- Amount range filter (USD)max_amount
-- Transaction state; set tostate
to include declined transactions"ALL"
-- Filter by approval statusapproval_status
-- Filter by ERP sync status (supersedessync_status
andsync_ready
)has_no_sync_commits
--has_no_sync_commits
for unsynced transactionstrue
--sync_ready
for transactions ready to sync to ERPtrue
--requires_memo
for transactions missing required memostrue
--include_merchant_data
to include full purchase data from merchanttrue
-- Results per page (2--100, default: 20)page_size
-- Pagination cursor: ID of last entity from previous pagestart
/order_by_date_desc
-- Sort by dateorder_by_date_asc
/order_by_amount_desc
-- Sort by amountorder_by_amount_asc
Example:
Tool: RAMP_GET_ALL_TRANSACTIONS Arguments: from_date: "2026-02-01T00:00:00Z" to_date: "2026-02-11T23:59:59Z" page_size: 50 order_by_date_desc: true
2. Search Transactions
Search transactions by merchant name, memo, or other transaction details.
Tool:
RAMP_SEARCH_TRANSACTIONS
Key Parameters:
(required) -- Search text for merchant name, memo, or other detailsquery- All filter parameters from
are also availableRAMP_GET_ALL_TRANSACTIONS
Example:
Tool: RAMP_SEARCH_TRANSACTIONS Arguments: query: "AWS" from_date: "2026-01-01T00:00:00Z" page_size: 25
3. Get Transaction Details
Retrieve complete details of a specific transaction including merchant details, receipts, accounting codes, and dispute information.
Tool:
RAMP_GET_TRANSACTION
Key Parameters:
(required) -- ID of the transactiontransaction_id
Example:
Tool: RAMP_GET_TRANSACTION Arguments: transaction_id: "txn_abc123def456"
4. Manage Reimbursements
List and retrieve reimbursement records for approval workflows and expense analysis.
Tools:
-- List reimbursements with filteringRAMP_LIST_REIMBURSEMENTS
-- Get complete details of a specific reimbursementRAMP_GET_REIMBURSEMENT
Key Parameters for
:RAMP_LIST_REIMBURSEMENTS
-- Filter by employee UUIDuser_id
-- Filter by business entity UUIDentity_id
/from_date
-- Date range for creation dateto_date
/from_submitted_at
-- Date range for submission dateto_submitted_at
/from_transaction_date
-- Underlying transaction date rangeto_transaction_date
-- Filter for reimbursements pending a specific approverawaiting_approval_by_user_id
-- Filter by ERP sync statussync_status
--has_no_sync_commits
for unsynced reimbursementstrue
--sync_ready
for reimbursements ready to synctrue
--direction
(default) or"BUSINESS_TO_USER"
(repayments)"USER_TO_BUSINESS"
-- Results per page (2--100, default: 20)page_size
-- Pagination cursorstart
Example:
Tool: RAMP_LIST_REIMBURSEMENTS Arguments: from_date: "2026-02-01T00:00:00Z" sync_ready: true page_size: 50
5. List Users and Get My Transactions
View organization users and personal transaction history.
Tools:
-- List users with filtering by department, role, location, entityRAMP_LIST_USERS
-- Get transactions for the authenticated userRAMP_GET_MY_TRANSACTIONS
Key Parameters for
:RAMP_LIST_USERS
-- Filter by department UUIDdepartment_id
-- Filter by user rolerole
-- Filter by email addressemail
-- Filter by employee IDemployee_id
-- Filter by business entity UUIDentity_id
-- Filter by location UUIDlocation_id
-- Results per page (2--100, default: 20)page_size
Example:
Tool: RAMP_LIST_USERS Arguments: role: "ADMIN" page_size: 50
6. View Card Details and Accounting Fields
Retrieve card information and custom accounting field configurations.
Tools:
-- Get detailed card information (spending limits, cardholder, fulfillment status)RAMP_GET_CARD
-- Fetch custom accounting field definitionsRAMP_FETCH_CUSTOM_ACCOUNTING_FIELD
已知陷阱
| Pitfall | Detail |
|---|---|
| Pagination required | All list endpoints return paginated results. Use the parameter with the ID of the last entity from the previous page to iterate. |
| Date format | All date parameters must be ISO 8601 datetime format (e.g., ). Plain date strings will fail. |
| sync_status priority | When is set, it supersedes both and parameters. |
| Amount filters in USD | and are in USD. Ensure correct currency context when filtering. |
| state=ALL for declined | By default, declined transactions are excluded. Set to include them in results. |
| page_size bounds | Must be between 2 and 100. Default is 20. Values outside this range cause errors. |
快速参考
| Tool Slug | Description |
|---|---|
| List all transactions with filtering |
| Search transactions by text query |
| Get details of a specific transaction |
| Get authenticated user's transactions |
| List reimbursements with filtering |
| Get details of a specific reimbursement |
| List organization users |
| Get card details |
| Fetch custom accounting field config |
由 Composio 提供支持