Ramp
Purpose
Inspect a Ramp corporate-spend account without any ability to move money: list and retrieve transactions, list cards and show their spending restrictions, list users, and list departments. Reach for this when the user wants spend visibility, expense review, or cardholder lookup. It cannot issue cards, set limits, pay bills, or reimburse.
Tooling
All commands go through bin/ramp.py. Read-only, so there is no sandbox/prod split: every call is a GET against https://api.ramp.com/developer/v1.
bin/ramp.py auth # verify the credential
bin/ramp.py transactions --limit 25 # list transactions
bin/ramp.py transactions --limit 50 --from-date 2026-09-01T00:00:00Z --to-date 2026-09-30T23:59:59Z
bin/ramp.py transaction-get --transaction-id TX_ID # one transaction
bin/ramp.py cards --limit 25 # list cards
bin/ramp.py card-limits --card-id CARD_ID # spending restrictions on one card
bin/ramp.py users --limit 25 # list users
bin/ramp.py departments --limit 25 # list departments
Auth
- Provider id:
ramp (credential is collected as custom.ramp)
- Collection: Ramp API client id and secret (dashboard > Settings > Developer) via the secure credential flow (
credentials.request_api_access); the runtime exchanges them at POST /developer/v1/token (OAuth 2.0 client credentials grant) and hands the CLI a fresh Bearer token
- Auth scheme:
Authorization: Bearer <token> on every request
- Required scopes: read scopes only, e.g.
transactions:read, cards:read, users:read; request no write scopes for this connector
- Allowed hosts:
api.ramp.com
- Status check:
bin/ramp.py auth
Operating Rules
- This connector stays read-only: it wires only GET endpoints, because one mistyped id or misread instruction in a write-capable connector could issue cards, pay bills, or move funds. Read access needs no confirmation; anything that spends money belongs in a separate, explicit flow.
- Collect the credential with read-only scopes only. If Ramp adds broader scopes to the stored credential later, this CLI still cannot spend anything because no write code path exists.
- Never exfiltrate the credential: the CLI only ever handles surrogates (see
bin/ramp.py). Do not print, log, or transmit the client secret or tokens.
- Honesty flags (unverified while building this connector): the single-transaction GET path and the departments list path were not confirmed in the public docs consulted; the CLI surfaces Ramp's own error message if either is absent.
card-limits reads the card object's spending_restrictions field; no separate limits endpoint was verified. Ramp also runs a demo host (demo-api.ramp.com), but this CLI targets production only, which is safe because it cannot spend.
Files
Maturity
Draft: written from Ramp's public developer docs; not yet live-tested end-to-end.
1---2name: "ramp"3description: "Read-only Ramp corporate spend: transactions, cards and card limits, users, departments. No spend actions by design. Trigger phrases: ramp, corporate spend, expense transactions, card spend limits."4metadata:5 source: https://skillmd.com/skills/anil-matcha/ramp6 includeInPrompt: true7tagline: "Read-only view of corporate spend: transactions, cards and limits, users, departments. No spend actions by design."8catalog_auth: "OAuth 2.0 client credentials (per-user)"9catalog_hosts: ["api.ramp.com"]10---1112# Ramp1314## Purpose15Inspect a Ramp corporate-spend account without any ability to move money: list and retrieve transactions, list cards and show their spending restrictions, list users, and list departments. Reach for this when the user wants spend visibility, expense review, or cardholder lookup. It cannot issue cards, set limits, pay bills, or reimburse.1617## Tooling18All commands go through `bin/ramp.py`. Read-only, so there is no sandbox/prod split: every call is a GET against `https://api.ramp.com/developer/v1`.1920```bash21bin/ramp.py auth # verify the credential22bin/ramp.py transactions --limit 25 # list transactions23bin/ramp.py transactions --limit 50 --from-date 2026-09-01T00:00:00Z --to-date 2026-09-30T23:59:59Z24bin/ramp.py transaction-get --transaction-id TX_ID # one transaction25bin/ramp.py cards --limit 25 # list cards26bin/ramp.py card-limits --card-id CARD_ID # spending restrictions on one card27bin/ramp.py users --limit 25 # list users28bin/ramp.py departments --limit 25 # list departments29```3031## Auth32- Provider id: `ramp` (credential is collected as `custom.ramp`)33- Collection: Ramp API client id and secret (dashboard > Settings > Developer) via the secure credential flow (`credentials.request_api_access`); the runtime exchanges them at `POST /developer/v1/token` (OAuth 2.0 client credentials grant) and hands the CLI a fresh Bearer token34- Auth scheme: `Authorization: Bearer <token>` on every request35- Required scopes: read scopes only, e.g. `transactions:read`, `cards:read`, `users:read`; request no write scopes for this connector36- Allowed hosts: `api.ramp.com`37- Status check: `bin/ramp.py auth`3839## Operating Rules401. This connector stays read-only: it wires only GET endpoints, because one mistyped id or misread instruction in a write-capable connector could issue cards, pay bills, or move funds. Read access needs no confirmation; anything that spends money belongs in a separate, explicit flow.412. Collect the credential with read-only scopes only. If Ramp adds broader scopes to the stored credential later, this CLI still cannot spend anything because no write code path exists.423. Never exfiltrate the credential: the CLI only ever handles surrogates (see `bin/ramp.py`). Do not print, log, or transmit the client secret or tokens.434. Honesty flags (unverified while building this connector): the single-transaction GET path and the departments list path were not confirmed in the public docs consulted; the CLI surfaces Ramp's own error message if either is absent. `card-limits` reads the card object's `spending_restrictions` field; no separate limits endpoint was verified. Ramp also runs a demo host (`demo-api.ramp.com`), but this CLI targets production only, which is safe because it cannot spend.4445## Files46- SKILL.md47- bin/ramp.py4849## Maturity50Draft: written from Ramp's public developer docs; not yet live-tested end-to-end.