com.mcparmory/ramp
PYPI · MCPARMORY-RAMP · 2 COMPONENTS · SCANNED SEP 20
Manage expenses, corporate cards, accounts payable, and accounting integrations
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security37
- Malware scan not yet available for this package.Unverified
- No known CVEs affecting this package version or its production dependencies.Pass
- Install-script risk not yet assessed.Unverified
- 2 of 46 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency32
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- License check failed: the license (MIT License) isn't a recognized OSI-approved license. See how to fix → Fail
- Actively maintained (last published 130 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability75
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 24416 tokens (~131/item across 186 items; 186 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management87
- Stability observed for 26 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety98
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 22 of 24 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "get_transfer" implies "transfer" and declares readOnlyHint instead, contradicting what its own name says it does. See how to fix → Partial
- An AI judge read all 186 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
How do I install the com.mcparmory/ramp MCP server?
com.mcparmory/ramp runs locally as a PyPI package, launched with uvx mcparmory-ramp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
pypi · mcparmory-ramp
claude mcp add com-mcparmory-ramp -- uvx mcparmory-ramp
{
"mcpServers": {
"com-mcparmory-ramp": {
"command": "uvx",
"args": [
"mcparmory-ramp"
]
}
}
} {
"servers": {
"com-mcparmory-ramp": {
"command": "uvx",
"args": [
"mcparmory-ramp"
]
}
}
} codex mcp add com-mcparmory-ramp -- uvx mcparmory-ramp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"com-mcparmory-ramp": {
"type": "local",
"command": [
"uvx",
"mcparmory-ramp"
],
"enabled": true
}
}
} openclaw mcp add com-mcparmory-ramp --command uvx --arg mcparmory-ramp
mcp_servers:
com-mcparmory-ramp:
command: "uvx"
args: ["mcparmory-ramp"] {
"McpServers": {
"com-mcparmory-ramp": {
"Transport": "stdio",
"Command": "uvx",
"Arguments": [
"mcparmory-ramp"
]
}
}
} assistant mcp add com-mcparmory-ramp -t stdio -c uvx -a mcparmory-ramp
{
"mcpServers": {
"com-mcparmory-ramp": {
"command": "uvx",
"args": [
"mcparmory-ramp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 19 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.
- 18 Sept 26 −3
- Stability: pass → 0.80 functional
- 17 Sept 26 +1
- Stability: 0.97 → pass security
- 15 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.
- 14 Sept 26 −15
- Malware scan: pass → unverified ▼ security
- 13 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.
- 12 Sept 26 +15
- Malware scan: unverified → pass ▲ security
- 11 Sept 26 −18
- Malware scan: pass → unverified ▼ security
- Stability: pass → 0.80 functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Analysed pypi/mcparmory-ramp@1.0.2
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | pypi |
Background: How many MCP packages publish verified provenance →
Dependencies 46 packages
| Packages resolved | 46 |
|---|---|
| Stale | 1 |
| No linked repository | 1 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
list_custom_accounting_fields List Custom Accounting Fields ~119
Retrieve a paginated list of custom accounting fields from your ERP system, with optional filtering by remote ID and active status.
| Name | Type | Req | Description |
|---|---|---|---|
| is_active | boolean | – | Filter by field status: omit to return all fields, true for active fields only, or false for inactive fields only. |
| page_size | integer | – | Number of results per page, between 2 and 100 (defaults to 20 if not specified). |
| remote_id | string | – | Filter results to custom accounting fields matching a specific remote or external ID in your ERP system. |
No output schema declared.
No examples provided.
list_custom_field_options List Custom Field Options ~221
Retrieve a paginated list of options available for a specific custom accounting field, with optional filtering by remote ID, active status, code, or visibility.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | – | Filter results by the code identifier of custom accounting field options. |
| field_id | string | yes | The unique identifier (ramp_id) of the custom accounting field whose options you want to retrieve. This is a UUID that must be obtained from custom field endpoints. |
| is_active | boolean | – | Filter by active status: true returns only active options, false returns only inactive options, and omitting this parameter returns all options regardless of status. |
| page_size | integer | – | The number of results to return per page, between 2 and 100 inclusive. Defaults to 20 if not specified. |
| remote_id | string | – | Filter results by the external ID of custom accounting field options as they appear in the ERP system. |
| visibility | string | – | Filter by visibility setting: either HIDDEN or VISIBLE. Omitting this parameter returns options with any visibility level. |
No output schema declared.
No examples provided.
list_custom_table_columns List Custom Table Columns ~67
Retrieve all columns defined for a specific custom table. Returns the column metadata including names, types, and configurations for the specified custom table.
| Name | Type | Req | Description |
|---|---|---|---|
| custom_table_name | string | yes | The name of the custom table for which to list columns. This is the identifier of the custom table resource. |
No output schema declared.
No examples provided.
list_custom_table_rows List Custom Table Rows ~141
Retrieve rows from a custom table, with optional filtering by external key and control over referenced row inclusion and pagination.
| Name | Type | Req | Description |
|---|---|---|---|
| custom_table_name | string | yes | The name of the custom table to query for rows. |
| external_key | array | – | Filter results by the external key of custom rows. Accepts one or more external key values to match against. |
| include_all_referenced_rows | boolean | – | When enabled, includes all referenced rows in each cell instead of a limited subset. Defaults to false for performance. |
| page_size | integer | – | Number of rows to return per request, up to a maximum of 100. Defaults to 50 rows. |
No output schema declared.
No examples provided.
list_custom_tables List Custom Tables ~41
Retrieve a list of all custom tables available in the developer environment. This operation returns metadata for custom table definitions that can be used to store and manage custom records.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_departments List Departments ~69
Retrieve a paginated list of all departments. Results are returned in pages with a configurable size to support efficient browsing of large department collections.
| Name | Type | Req | Description |
|---|---|---|---|
| page_size | integer | – | Number of departments to return per page. Must be between 2 and 100 items; defaults to 20 if not specified. |
No output schema declared.
No examples provided.
list_draft_bills List Draft Bills ~287
Retrieve a paginated list of draft bills with optional filtering by entity, vendor, invoice details, and date ranges. Useful for finding bills in draft status that match specific criteria.
| Name | Type | Req | Description |
|---|---|---|---|
| entity_id | string | – | Filter results to draft bills associated with a specific entity, specified as a UUID. |
| from_due_date | string | – | Show only draft bills with a due date on or after this date. Provide as an ISO 8601 datetime string. |
| from_issued_date | string | – | Show only draft bills with an issued date on or after this date. Provide as an ISO 8601 datetime string. |
| invoice_number | string | – | Filter results to draft bills matching an exact invoice number. |
| page_size | integer | – | Number of results per page. Must be between 2 and 100; defaults to 20 if not specified. |
| remote_id | string | – | Filter results to draft bills matching an exact remote ID. |
| to_due_date | string | – | Show only draft bills with a due date on or before this date. Provide as an ISO 8601 datetime string. |
| to_issued_date | string | – | Show only draft bills with an issued date on or before this date. Provide as an ISO 8601 datetime string. |
| vendor_id | string | – | Filter results to draft bills from a specific vendor, specified as a UUID. |
No output schema declared.
No examples provided.
list_entities_with_pagination List Entities with Pagination ~185
Retrieve a paginated list of business entities with optional filtering by currency, name, primary status, and active state.
| Name | Type | Req | Description |
|---|---|---|---|
| currency | string | – | Filter results to entities using a specific currency code (e.g., USD, EUR, GBP). Accepts ISO 4217 currency codes and cryptocurrency variants. |
| entity_name | string | – | Filter results to entities matching a specific name or partial name. |
| hide_inactive | boolean | – | Exclude inactive entities from results. Defaults to false, which includes both active and inactive entities. |
| include_deleted_accounts | – | – | Include deleted accounts in the results. |
| is_primary | boolean | – | Filter to return only primary entities (true) or only non-primary entities (false). |
| page_size | integer | – | Number of results per page. Must be between 2 and 100 inclusive. Defaults to 20 if not specified. |
No output schema declared.
No examples provided.
list_gl_accounts List GL Accounts ~131
Retrieve a paginated list of general ledger accounts with optional filtering by remote ID, active status, or account code.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | – | Filter results to accounts matching this account code. |
| is_active | boolean | – | Filter by account active status: true returns only active accounts, false returns only inactive accounts, omitting this parameter returns all accounts regardless of status. |
| page_size | integer | – | Number of results per page, between 2 and 100 inclusive. Defaults to 20 if not specified. |
| remote_id | string | – | Filter results to accounts matching this external or remote system identifier. |
No output schema declared.
No examples provided.
list_inventory_item_accounting_fields List Inventory Item Accounting Fields ~44
Retrieve the list of available accounting fields for inventory items in the current accounting connection. Use this to understand which fields can be queried or managed for inventory item operations.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_inventory_item_options List Inventory Item Options ~134
Retrieve a paginated list of inventory item field options with optional filtering by remote ID, active status, or code.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | – | Filter results to inventory items matching this code value. |
| is_active | boolean | – | Filter by active status: true returns only active items, false returns only inactive items, and omitting this parameter returns all items regardless of status. |
| page_size | integer | – | Number of results per page, between 2 and 100 inclusive. Defaults to 20 if not specified. |
| remote_id | string | – | Filter results to inventory items matching this external or remote system identifier. |
No output schema declared.
No examples provided.
list_item_receipts List Item Receipts ~163
Retrieve a paginated list of item receipts, optionally filtered by entity, purchase order, or line item. Archived receipts are excluded by default.
| Name | Type | Req | Description |
|---|---|---|---|
| entity_id | string | – | Filter results to a specific business entity using its unique identifier (UUID format). |
| include_archived | boolean | – | Include archived item receipts in the results. By default, only active receipts are returned. |
| page_size | integer | – | Number of results per page, between 2 and 100. Defaults to 20 if not specified. |
| purchase_order_id | string | – | Filter results to a specific purchase order using its unique identifier (UUID format). |
| purchase_order_line_item_id | string | – | Filter results to a specific purchase order line item using its unique identifier (UUID format). |
No output schema declared.
No examples provided.
list_locations List Locations ~77
Retrieve a paginated list of business locations, optionally filtered by a specific business entity.
| Name | Type | Req | Description |
|---|---|---|---|
| entity_id | string | – | Filter results to locations associated with a specific business entity, specified as a UUID. |
| page_size | integer | – | Number of results per page, between 2 and 100 inclusive. Defaults to 20 if not specified. |
No output schema declared.
No examples provided.
list_matrix_table_rows List Matrix Table Rows ~136
Retrieve rows from a matrix table with inputs and results separated. Input columns are always complete, while result columns contain only values that have been explicitly set.
| Name | Type | Req | Description |
|---|---|---|---|
| external_keys | array | – | Optional list of external keys to filter results to specific rows. Only rows matching one of the provided keys are returned. |
| filters | array | – | Optional list of filters to apply against input column values. Only rows matching ALL specified filters are included in results. |
| page_size | integer | – | Maximum number of rows to return per page. Defaults to 100 rows. |
| table_name | string | yes | The name of the matrix table to query. |
No output schema declared.
No examples provided.
list_matrix_tables List Matrix Tables ~36
Retrieve all Matrix tables configured for your business. Matrix tables are custom data structures used to organize and manage complex, multi-dimensional business data.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_memos List Memos ~194
Retrieve a paginated list of memos with optional filtering by card, department, location, merchant, or user. Results are returned in pages with configurable size.
| Name | Type | Req | Description |
|---|---|---|---|
| card_id | string | – | Filter results to memos associated with a specific card. Provide the card's UUID. |
| department_id | string | – | Filter results to memos associated with a specific department. Provide the department's UUID. |
| location_id | string | – | Filter results to memos associated with a specific location. Provide the location's UUID. |
| merchant_id | string | – | Filter results to memos associated with a specific merchant. Provide the merchant's UUID. |
| page_size | integer | – | Number of memos to return per page. Must be between 2 and 100 inclusive. Defaults to 20 if not specified. |
| user_id | string | – | Filter results to memos associated with a specific user. Provide the user's UUID. |
No output schema declared.
No examples provided.
list_merchants List Merchants ~130
Retrieve a paginated list of merchants, optionally filtered by transaction date range. Use pagination parameters to control result set size.
| Name | Type | Req | Description |
|---|---|---|---|
| page_size | integer | – | Number of merchants to return per page. Must be between 2 and 100 inclusive; defaults to 20 if not specified. |
| transaction_from_date | string | – | Filter results to include only merchants with transactions on or after this date. Specify as an ISO 8601 datetime string. |
| transaction_to_date | string | – | Filter results to include only merchants with transactions on or before this date. Specify as an ISO 8601 datetime string. |
No output schema declared.
No examples provided.
list_native_table_columns List Native Table Columns ~70
Retrieve all custom columns defined for a specified native Ramp table. This operation returns the column metadata and configuration for the given native table.
| Name | Type | Req | Description |
|---|---|---|---|
| native_table_name | string | yes | The name of the native Ramp table for which to retrieve custom columns. This identifies the specific table whose column definitions should be listed. |
No output schema declared.
No examples provided.
list_native_table_rows List Native Table Rows ~140
Retrieve rows and their custom column values from a Native Ramp table, with optional filtering by Ramp object IDs and configurable pagination.
| Name | Type | Req | Description |
|---|---|---|---|
| include_all_referenced_rows | boolean | – | When enabled, includes all referenced rows within each cell instead of a limited subset. Defaults to false. |
| native_table_name | string | yes | The name of the Native Ramp table to query for rows. |
| page_size | integer | – | Number of rows to return per request, up to a maximum of 100. Defaults to 50. |
| ramp_id | array | – | Filter results to include only rows associated with the specified Ramp object IDs. Provide as an array of IDs. |
No output schema declared.
No examples provided.
list_native_tables List Native Tables ~36
Retrieve a list of all native Ramp tables available in the developer environment. Use this to discover and reference custom record tables for integration purposes.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_purchase_orders List Purchase Orders ~275
Retrieve a paginated list of purchase orders with optional filtering by creation source, receipt status, entity, spend request, and three-way match configuration. Supports inclusion of archived purchase orders.
| Name | Type | Req | Description |
|---|---|---|---|
| creation_source | string | – | Filter purchase orders by their creation source: ACCOUNTING_PROVIDER (imported from accounting software), DEVELOPER_API (created via API), or RAMP (created through Ramp platform). |
| entity_id | string | – | Filter results to purchase orders associated with a specific business entity using its unique identifier. |
| include_archived | boolean | – | Include archived purchase orders in results. By default, only active purchase orders are returned. |
| page_size | integer | – | Number of results per page, between 2 and 100. Defaults to 20 if not specified. |
| receipt_status | string | – | Filter purchase orders by receipt status: NOT_RECEIVED (no items received), PARTIALLY_RECEIVED (some items received), FULLY_RECEIVED (all items received), or OVER_RECEIVED (more items received than o… |
| spend_request_id | string | – | Filter results to purchase orders linked to a specific spend request using its unique identifier. |
| three_way_match_enabled | boolean | – | Filter to include only purchase orders where three-way match (PO, receipt, and invoice reconciliation) is enabled. Defaults to false. |
No output schema declared.
No examples provided.
list_receipt_integration_opted_out_emails List Receipt Integration Opted Out Emails ~85
Retrieve a list of email addresses that have opted out of receipt integrations. Optionally filter results by a specific email address or integration ID.
| Name | Type | Req | Description |
|---|---|---|---|
| string | – | Filter results to a specific email address. Must be a valid email format. | |
| id | string | – | Filter results to a specific receipt integration by its unique identifier (UUID format). |
No output schema declared.
No examples provided.
list_receipts List Receipts ~107
Retrieve a paginated list of receipts, optionally filtered by reimbursement or transaction. Use pagination to control result set size.
| Name | Type | Req | Description |
|---|---|---|---|
| page_size | integer | – | Number of receipts to return per page. Must be between 2 and 100 results; defaults to 20 if not specified. |
| reimbursement_id | string | – | Filter results to receipts associated with a specific reimbursement using its unique identifier. |
| transaction_id | string | – | Filter results to receipts associated with a specific transaction using its unique identifier. |
No output schema declared.
No examples provided.
list_reimbursements List Reimbursements ~499
Retrieve a paginated list of reimbursements with flexible filtering by direction, approval status, dates, and associated entities. Supports filtering by transaction dates, submission dates, sync status, and approval workflows.
| Name | Type | Req | Description |
|---|---|---|---|
| accounting_field_selection_id | string | – | Filter reimbursements by accounting field selection, identified by its UUID. This uniquely identifies an accounting field selection configuration on Ramp. |
| awaiting_approval_by_user_id | string | – | Filter for reimbursements awaiting approval from a specific user, identified by their UUID. |
| direction | string | – | Filter reimbursements by direction: BUSINESS_TO_USER for standard reimbursements (default) or USER_TO_BUSINESS for repayments from users back to the business. |
| entity_id | string | – | Filter reimbursements by business entity, identified by its UUID. |
| from_submitted_at | string | – | Filter reimbursements by submission date, returning only those submitted on or after this date (ISO 8601 format). |
| from_transaction_date | string | – | Filter reimbursements by the underlying transaction date, returning only those on or after this date (ISO 8601 format). |
| has_been_approved | boolean | – | Filter reimbursements by approval status: true for approved reimbursements, false for unapproved. Omit to return all reimbursements regardless of approval status. |
| page_size | integer | – | Number of results per page; must be between 2 and 100. Defaults to 20 if not specified. |
| sync_status | string | – | Filter by synchronization status: NOT_SYNC_READY (not ready for sync), SYNC_READY (ready to sync), or SYNCED (already synchronized). |
| synced_after | string | – | Filter reimbursements by sync date, returning only those synchronized on or after this date (ISO 8601 format). |
| to_submitted_at | string | – | Filter reimbursements by submission date, returning only those submitted on or before this date (ISO 8601 format). |
| to_transaction_date | string | – | Filter reimbursements by the underlying transaction date, returning only those on or before this date (ISO 8601 format). |
| trip_id | string | – | Filter reimbursements associated with a specific trip, identified by its UUID. |
| updated_after | string | – | Filter reimbursements by last update date, returning only those updated on or after this date (ISO 8601 format). |
| user_id | string | – | Filter reimbursements by user, identified by their UUID. |
No output schema declared.
No examples provided.
list_spend_limits List Spend Limits ~232
Retrieve a paginated list of spend limits with optional filtering by entity, program, card, user, termination status, and access roles.
| Name | Type | Req | Description |
|---|---|---|---|
| card_id | string | – | Filter results to limits associated with a specific card, specified as a UUID. |
| entity_id | string | – | Filter results to limits associated with a specific business entity, specified as a UUID. |
| is_terminated | boolean | – | When true, return only terminated spend limits; when false or omitted, return active limits. |
| page_size | integer | – | Number of results per page, between 2 and 100 inclusive. Defaults to 20 if not specified. |
| spend_program_id | string | – | Filter results to limits linked to a specific spend program, specified as a UUID. |
| user_access_roles | array | – | Filter by user access roles. Accepts one or more values from: OWNER, COOWNER, MEMBER. Can be provided as repeated parameters or comma-separated values. Only limits with matching access types are retu… |
| user_id | string | – | Filter results to limits owned by a specific user, specified as a UUID. |
No output schema declared.
No examples provided.
list_spend_programs List Spend Programs ~69
Retrieve a paginated list of spend programs. Use the page_size parameter to control how many results are returned per page.
| Name | Type | Req | Description |
|---|---|---|---|
| page_size | integer | – | Number of spend programs to return per page. Must be between 2 and 100 results; defaults to 20 if not specified. |
No output schema declared.
No examples provided.
list_statements List Statements ~65
Retrieve a paginated list of statements. Use the page_size parameter to control how many results are returned per page.
| Name | Type | Req | Description |
|---|---|---|---|
| page_size | integer | – | Number of statements to return per page. Must be between 2 and 100 results; defaults to 20 if not specified. |
No output schema declared.
No examples provided.
list_tax_code_options List Tax Code Options ~148
Retrieve a paginated list of available tax code options, with optional filtering by remote ID, active status, or code value. Use this to populate dropdowns or validate tax code selections in accounting workflows.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | – | Filter results to tax codes matching this code value exactly. |
| is_active | boolean | – | Filter by active status: omit to return all tax codes, true for active only, or false for inactive only. |
| page_size | integer | – | Number of results per page, between 2 and 100 (defaults to 20 if not specified). |
| remote_id | string | – | Filter results to tax codes matching this remote or external identifier from your source system. |
No output schema declared.
No examples provided.
list_tax_rates List Tax Rates ~72
Retrieve a paginated list of tax rates configured in the accounting system. Use the page_size parameter to control how many results are returned per page.
| Name | Type | Req | Description |
|---|---|---|---|
| page_size | integer | – | Number of tax rates to return per page. Must be between 2 and 100 results; defaults to 20 if not specified. |
No output schema declared.
No examples provided.
list_transactions List Transactions ~716
Retrieve a paginated list of transactions with support for filtering by various attributes (category, department, user, approval status, etc.) and ordering by date or amount. By default, all transactions except declined ones are returned.
| Name | Type | Req | Description |
|---|---|---|---|
| accounting_field_selection_id | string | – | Filter transactions by accounting field selection using its unique identifier. |
| all_requirements_met_and_approved | boolean | – | Filter to include only transactions that are fully approved with all cardholder requirements met (receipts, memos, tracking categories). If not specified, returns all transactions. |
| approval_status | string | – | Filter transactions by approval status. Valid statuses include awaiting employee action, awaiting reviewer, or fully approved. |
| awaiting_approval_by_user_id | string | – | Filter transactions awaiting approval from a specific user using their unique identifier. |
| card_id | string | – | Filter transactions by physical card using its unique identifier. |
| department_id | string | – | Filter transactions by department using its unique identifier. |
| entity_id | string | – | Filter transactions by business entity using its unique identifier. |
| has_been_approved | boolean | – | Filter to include only transactions that have been approved, or only those that have not been approved. If not specified, returns all transactions regardless of approval status. |
| has_statement | boolean | – | Filter to include only transactions with a statement, or only those without a statement. If not specified, returns all transactions. |
| include_merchant_data | boolean | – | When set to true, includes all purchase data provided by the merchant in the response. |
| limit_id | string | – | Filter transactions by spending limit using its unique identifier. |
| location_id | string | – | Filter transactions by merchant location using its unique identifier. |
| max_amount | string | – | Filter for transactions with an amount less than or equal to the specified USD dollar amount. Accepts numeric values. |
| merchant_id | string | – | Filter transactions by merchant using its unique identifier. |
| min_amount | string | – | Filter for transactions with an amount greater than or equal to the specified USD dollar amount. Accepts numeric values. |
| order_by_amount_desc | boolean | – | When set to true, sorts transactions by amount in descending order (highest first). Note that multiple ordering parameters cannot be used together. |
| order_by_date_desc | boolean | – | When set to true, sorts transactions by user transaction date in descending order (newest first). Note that multiple ordering parameters cannot be used together. |
| page_size | integer | – | Number of results to return per page. Must be between 2 and 100; defaults to 20 if not specified. |
| requires_memo | boolean | – | When set to true, returns only transactions that require a memo but do not have one. Cannot be set to false. |
| sk_category_id | integer | – | Filter transactions by Ramp expense category code. Valid codes range from 1 to 44. |
| spend_program_id | string | – | Filter transactions by spend program using its unique identifier. |
| statement_id | string | – | Filter transactions by statement using its unique identifier. |
| sync_status | string | – | Filter transactions by synchronization status: not ready to sync, already synced, or ready to sync. When set, this supersedes other sync-related filters. |
| synced_after | string | – | Filter for transactions synced after a specific date and time in ISO 8601 format. |
| trip_id | string | – | Filter transactions by trip using its unique identifier. |
| user_id | string | – | Filter transactions by cardholder user using their unique identifier. |
No output schema declared.
No examples provided.
list_transfers_with_pagination List Transfers with Pagination ~246
Retrieve a paginated list of transfer payments with optional filtering by sync status, transfer status, business entity, or statement. Use this to view transfer history and monitor payment processing status.
| Name | Type | Req | Description |
|---|---|---|---|
| entity_id | string | – | Filter transfers to only those associated with a specific business entity, identified by its UUID. |
| page_size | integer | – | Set the number of transfer records returned per page. Must be between 2 and 100 results per page. Defaults to 20 if not specified. |
| statement_id | string | – | Filter transfers to only those included in a specific statement, identified by its UUID. |
| status | string | – | Filter transfers by their current processing status in the ACH workflow. Refer to the Transfers Guide for detailed definitions of each status value, which range from initial states like INITIATED thr… |
| sync_status | string | – | Filter transfers by their synchronization readiness state. Use NOT_SYNC_READY for transfers not yet ready to sync, SYNC_READY for transfers prepared for synchronization, or SYNCED for transfers alrea… |
No output schema declared.
No examples provided.
list_trips List Trips ~186
Retrieve all trips for the business with optional filtering by user, status, amount range, and name. Results are paginated with a configurable page size.
| Name | Type | Req | Description |
|---|---|---|---|
| max_amount | string | – | Show only trips with a total amount less than or equal to this value. Accepts numeric values. |
| min_amount | string | – | Show only trips with a total amount greater than or equal to this value. Accepts numeric values. |
| page_size | integer | – | Number of results to return per page. Must be between 2 and 100; defaults to 20 if not specified. |
| status | string | – | Filter trips by their current status: cancelled, completed, ongoing, or upcoming. |
| trip_name | string | – | Filter trips by exact name match. |
| user_ids | array | – | Filter results to include only trips assigned to specific users. Provide an array of user IDs. |
No output schema declared.
No examples provided.
list_users List Users ~254
Retrieve a paginated list of users with optional filtering by employee ID, role, status, entity, department, email, or location. Defaults to returning all active and inactive users, excluding suspended users.
| Name | Type | Req | Description |
|---|---|---|---|
| department_id | string | – | Filter results to users in a specific department, specified as a UUID. |
| string | – | Filter results to users with a specific email address. | |
| employee_id | string | – | Filter results to users with a specific employee ID. |
| entity_id | string | – | Filter results to users belonging to a specific business entity, specified as a UUID. |
| location_id | string | – | Filter results to users at a specific location, specified as a UUID. |
| page_size | integer | – | Number of results per page, between 2 and 100. Defaults to 20 if not specified. |
| role | string | – | Filter results to users with a specific role: AUDITOR, BUSINESS_ADMIN, BUSINESS_BOOKKEEPER, BUSINESS_OWNER, BUSINESS_USER, GUEST_USER, or IT_ADMIN. |
| status | string | – | Filter results by user status: USER_ACTIVE, USER_INACTIVE, or USER_SUSPENDED. If not specified, returns all active and inactive users but excludes suspended users. |
No output schema declared.
No examples provided.
list_vendor_agreements List Vendor Agreements ~673
Retrieve a paginated list of vendor agreements with flexible filtering by dates, financial values, renewal status, ownership, and custom metadata. Supports inclusion of archived agreements and exclusion of snoozed items.
| Name | Type | Req | Description |
|---|---|---|---|
| agreement_custom_records | – | – | JSON object containing custom record field filters to match against agreement custom records. |
| auto_renews | boolean | – | Filter to include only agreements that automatically renew, or exclude them if false. |
| contract_owner_ids | array | – | Filter by one or more contract owner IDs to return only agreements owned by specified users. |
| department_ids | array | – | Filter by one or more department IDs to return only agreements associated with specified departments. |
| end_date_range | – | – | JSON object specifying a relative date range filter for agreement end dates (e.g., within next 30 days). |
| exclude_snoozed | boolean | – | When true, exclude agreements that have been snoozed from the results. |
| has_end_date | boolean | – | Filter to include only agreements with a defined end date, or exclude them if false. |
| has_pending_expansion_requests | boolean | – | Filter to include only agreements with pending expansion requests, or exclude them if false. |
| has_reminders | boolean | – | Filter to include only agreements with configured reminders, or exclude them if false. |
| include_archived | boolean | – | When true, include archived agreements in results; defaults to false to show only active agreements. |
| is_active | boolean | – | Filter to include only currently active agreements, or exclude them if false. |
| is_up_for_renewal | boolean | – | Filter to include only agreements that are up for renewal, or exclude them if false. |
| last_date_to_terminate_range | – | – | JSON object specifying a relative date range filter for the last date to terminate an agreement (e.g., within next 60 days). |
| max_days_remaining | integer | – | Filter to include only agreements with days remaining less than or equal to this value. |
| max_total_value | string | – | Filter to include only agreements with total contract value less than or equal to this amount. Accepts numeric string or number format. |
| min_days_remaining | integer | – | Filter to include only agreements with days remaining greater than or equal to this value. |
| min_total_value | string | – | Filter to include only agreements with total contract value greater than or equal to this amount. Accepts numeric string or number format. |
| page_size | integer | – | Number of results per page; must be between 2 and 100, defaults to 20 if not specified. |
| payee_agreement_ids | array | – | Filter by one or more agreement IDs to return only specified agreements. |
| payee_ids | array | – | Filter by one or more vendor (payee) IDs to return only agreements with specified vendors. |
| payee_owner_ids | array | – | Filter by one or more vendor owner IDs to return only agreements owned by specified vendor contacts. |
| renewal_status | array | – | Filter by one or more renewal status values to include only agreements with matching renewal statuses. |
| renewal_status_exclude | array | – | Exclude agreements with any of the specified renewal statuses from results. |
| start_date_range | – | – | JSON object specifying a relative date range filter for agreement start dates (e.g., within last 90 days). |
No output schema declared.
No examples provided.
list_vendor_bank_accounts List Vendor Bank Accounts ~92
Retrieve a paginated list of bank accounts associated with a specific vendor. Use pagination parameters to control result set size.
| Name | Type | Req | Description |
|---|---|---|---|
| page_size | integer | – | The number of bank accounts to return per page. Must be between 2 and 100 results; defaults to 20 if not specified. |
| vendor_id | string | yes | The unique identifier (UUID) of the vendor whose bank accounts you want to retrieve. |
No output schema declared.
No examples provided.
list_vendor_contacts List Vendor Contacts ~88
Retrieve a paginated list of contacts associated with a specific vendor. Use pagination to control the number of results returned per page.
| Name | Type | Req | Description |
|---|---|---|---|
| page_size | integer | – | The number of contacts to return per page, between 2 and 100. Defaults to 20 if not specified. |
| vendor_id | string | yes | The unique identifier (UUID) of the vendor whose contacts you want to retrieve. |
No output schema declared.
No examples provided.
list_vendor_credits List Vendor Credits ~163
Retrieve all vendor credits across all vendors for a business, with optional filtering by accounting date range and credit status.
| Name | Type | Req | Description |
|---|---|---|---|
| from_accounting_date | string | – | Filter results to include only vendor credits with an accounting date on or after this date (inclusive). Use ISO 8601 date format. |
| include_fully_used | boolean | – | When false (default), excludes vendor credits marked as fully used from results. Set to true to include them. |
| page_size | integer | – | Number of results per page, between 2 and 100. Defaults to 20 if not specified. |
| to_accounting_date | string | – | Filter results to include only vendor credits with an accounting date on or before this date (inclusive). Use ISO 8601 date format. |
No output schema declared.
No examples provided.
list_vendor_credits_by_vendor List Vendor Credits ~189
Retrieve a paginated list of vendor credits for a specific vendor, with optional filtering by accounting date range and inclusion of fully used credits.
| Name | Type | Req | Description |
|---|---|---|---|
| from_accounting_date | string | – | Filter results to include only vendor credits with an accounting date on or after this date (ISO 8601 format). Optional. |
| include_fully_used | boolean | – | When true, includes vendor credits marked as fully used in the results. Defaults to false, excluding fully used credits. |
| page_size | integer | – | Number of results per page, between 2 and 100. Defaults to 20 if not specified. |
| to_accounting_date | string | – | Filter results to include only vendor credits with an accounting date on or before this date (ISO 8601 format). Optional. |
| vendor_id | string | yes | The unique identifier (UUID) of the vendor whose credits should be retrieved. |
No output schema declared.
No examples provided.
list_vendors List Vendors ~310
Retrieve a paginated list of vendors with optional filtering by external ID, merchant, accounting system mappings, categories, and ownership. Use filters to narrow results to specific vendors matching your business criteria.
| Name | Type | Req | Description |
|---|---|---|---|
| accounting_vendor_remote_ids | array | – | Filter results to vendors whose accounting system remote IDs match any in this comma-separated list of strings. |
| external_vendor_id | string | – | Filter results to vendors matching this customer-defined external vendor identifier, independent of any accounting system remote IDs. |
| include_subsidiary | boolean | – | When enabled, include ERP subsidiary identifiers associated with each vendor in the response, if available. Defaults to false. |
| is_active | boolean | – | Filter results to vendors with this active status (true for active vendors, false for inactive). |
| merchant_id | string | – | Filter results to vendors associated with this specific card merchant, identified by UUID. |
| name | string | – | Filter results to vendors whose name matches or contains this value. |
| page_size | integer | – | Number of vendors to return per page; must be between 2 and 100. Defaults to 20 if not specified. |
| sk_category_ids | array | – | Filter results to vendors whose Ramp category codes match any in this comma-separated list of integers. |
| vendor_owner_id | string | – | Filter results to vendors owned by this specific user, identified by UUID. |
| vendor_tracking_category_option_ids | array | – | Filter results to vendors whose accounting field selection IDs match any in this comma-separated list of UUIDs. |
No output schema declared.
No examples provided.
list_vendors_accounting List Accounting Vendors ~131
Retrieve a paginated list of accounting vendors with optional filtering by remote ID, active status, or vendor code.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | – | Filter results to vendors matching this code. |
| is_active | boolean | – | Filter by vendor active status: true returns only active vendors, false returns only inactive vendors, and omitting this parameter returns all vendors regardless of status. |
| page_size | integer | – | Number of results per page, between 2 and 100 inclusive. Defaults to 20 if not specified. |
| remote_id | string | – | Filter results to vendors matching this remote or external identifier. |
No output schema declared.
No examples provided.
mark_transactions_ready_to_sync Mark Transactions Ready to Sync ~90
Mark one or more accounting transactions as ready to sync. This notifies the system that the specified transactions are prepared for synchronization.
| Name | Type | Req | Description |
|---|---|---|---|
| object_ids | array | yes | A list of transaction IDs to mark as ready for sync. Provide between 1 and 500 object IDs per request. |
| object_type | string | yes | The type of object being marked for sync. Currently supports TRANSACTION objects only. |
No output schema declared.
No examples provided.
reactivate_accounting_connection Reactivate Accounting Connection ~71
Reactivate a previously disconnected accounting connection, restoring it to active status while preserving all previous field configurations and settings. The business must not have any other active accounting connections at the time of reactivation.
| Name | Type | Req | Description |
|---|---|---|---|
| connection_id | string | yes | The unique identifier (UUID) of the accounting connection to reactivate. |
No output schema declared.
No examples provided.
reactivate_user Reactivate User ~56
Reactivate a deactivated user account, restoring their ability to log in, use their issued cards, and receive Ramp notifications.
| Name | Type | Req | Description |
|---|---|---|---|
| user_id | string | yes | The unique identifier of the user to reactivate, formatted as a UUID. |
No output schema declared.
No examples provided.
remove_custom_table_row_cells Remove Custom Table Row Cells ~107
Remove specific cells from rows in a custom table. Specify which cells to clear by providing row identifiers and column names.
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | yes | An array of row specifications indicating which cells to remove. Each row entry must specify the row identifier and list the column names whose cells should be cleared. All entries must use consisten… |
| table_name | string | yes | The name of the custom table from which cells will be removed. This identifies the target table for the operation. |
No output schema declared.
No examples provided.
remove_matrix_table_cells Remove Matrix Table Cells ~90
Remove specific cell values from many-to-many result columns in a matrix table without affecting other data in those rows.
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | yes | An array of row objects specifying which cells to remove from many-to-many result columns. Each row entry identifies the target row and the specific cell values to delete. |
| table_name | string | yes | The name of the matrix table from which cells will be removed. |
No output schema declared.
No examples provided.
remove_native_table_row_cells Remove Native Table Row Cells ~108
Remove specific cells from rows in a Native Ramp table. Specify which cells to clear by providing row identifiers and column names.
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | yes | Array of row specifications indicating which cells to remove. Each row entry must specify the row identifier and the column names whose cells should be cleared. All entries must use consistent column… |
| native_table_name | string | yes | The name of the native table from which cells will be removed. This identifies the specific Native Ramp table to modify. |
No output schema declared.
No examples provided.
remove_opted_out_email_from_receipt_integration Remove Opted Out Email from Receipt Integration ~67
Remove an email address from the receipt integration opt-out list, allowing it to receive receipt integrations again.
| Name | Type | Req | Description |
|---|---|---|---|
| mailbox_opted_out_email_uuid | string | yes | The unique identifier (UUID) of the opted-out email record to remove from the opt-out list. |
No output schema declared.
No examples provided.
remove_users_from_spend_limit Remove Users from Spend Limit ~85
Remove one or more users from a shared spend limit, revoking their access to that limit's budget allocation.
| Name | Type | Req | Description |
|---|---|---|---|
| spend_limit_id | string | yes | The unique identifier (UUID) of the spend limit from which users will be removed. |
| user_ids | array | – | Array of user identifiers to remove from the spend limit. If omitted, no users are removed. |
No output schema declared.
No examples provided.
rename_matrix_column Rename Matrix Column ~108
Rename the API identifier for a matrix table column while keeping its human-readable label unchanged. This operation works for both input and result columns in custom matrix records.
| Name | Type | Req | Description |
|---|---|---|---|
| column_name | string | yes | The current API name of the column to rename within the matrix table. |
| new_name | string | yes | The new API name to assign to the column. This becomes the identifier used in API requests and responses. |
| table_name | string | yes | The name of the matrix table containing the column to rename. |
No output schema declared.
No examples provided.
rename_matrix_table Rename Matrix Table ~104
Updates the API name of an existing Matrix table. This operation allows you to change how the table is referenced in API calls without affecting its underlying data or structure.
| Name | Type | Req | Description |
|---|---|---|---|
| new_name | string | yes | The new API name for the Matrix table. This will become the identifier used to reference the table in subsequent API operations. |
| table_name | string | yes | The current API name of the Matrix table to be renamed. This is the identifier used to reference the table in API operations. |
No output schema declared.
No examples provided.
What is the com.mcparmory/ramp MCP server?
com.mcparmory/ramp is an MCP server listed in the public MCP registry as com.mcparmory/ramp. Manage expenses, corporate cards, accounts payable, and accounting integrations. This page covers its PyPI package (mcparmory-ramp).
Is the com.mcparmory/ramp MCP server safe to use?
com.mcparmory/ramp scores 61 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the com.mcparmory/ramp MCP server expose?
com.mcparmory/ramp exposes 186 tools: list_gl_accounts, create_gl_accounts, get_gl_account, update_gl_account, delete_gl_account, and 181 more. Their descriptions and schemas cost roughly 24,416 tokens of context every time the server is loaded.
Is the com.mcparmory/ramp MCP server still maintained?
com.mcparmory/ramp is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.