Ramp ACTION
List Limits
Retrieve a paginated list of Ramp spend limits. Returns a compact summary of each limit by default (id, display_name, state, balance, spend_program_id, created_at, is_shareable); use Get Limit for the full record, or pass
fields to include specific extra fields. Use this to find limit IDs for Get Limit, Update Limit, and Terminate Limit. Returns one page of up to pageSize results (max 100); a page.next value in the response means more limits exist beyond this page. See the documentation- Action
- Read only
- OAuth
- SDK
- MCP
IMPLEMENTATION
Call this tool
Connect a user's Ramp account once, then configure and run List Limits from your backend or agent.
import { PipedreamClient } from "@pipedream/sdk"
const pd = new PipedreamClient({
projectId: process.env.PIPEDREAM_PROJECT_ID!,
clientId: process.env.PIPEDREAM_CLIENT_ID!,
clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
projectEnvironment: "production",
})
const result = await pd.actions.run({
id: "ramp-list-limits",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
ramp: { authProvisionId: "apn_xxxxxxx" },
pageSize: 10,
start: "Start (Pagination Cursor)",
},
})
console.log(result)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "ramp-list-limits",
"configured_props": {
"ramp": { "authProvisionId": "apn_xxxxxxx" },
"pageSize": 10,
"start": "Start (Pagination Cursor)"
}
}'// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "ramp",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "ramp-list-limits",
arguments: {
pageSize: 10,
start: "Start (Pagination Cursor)",
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| Property | Type | Description |
|---|---|---|
pageSize Page Size | integer | Number of results per page, between 2 and 100 (default 20). Optional |
start Start (Pagination Cursor) | string | Pagination cursor for the next page. Take the start query-parameter value from the previous response's page.next URL and pass it here. Optional |
fields Fields | string[] | Optional list of limit fields to include per record in addition to the compact default (e.g. cards, members, spending_restrictions, permitted_spend_types). Leave empty for the compact summary; use Get Limit for the complete record. Optional |
REFERENCE
Tool details
Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.
- Registry key
- ramp-list-limits
- Version
- 0.0.3
- App
- Ramp
- Authentication
- OAuth
- Read-only
- Yes
- Destructive
- No
- Open world
- Yes
- Source
- View on GitHub ↗