ramp-card-management

Inspect Ramp card status and activate, lock, or unlock cards via CLI or MCP.

2|1|Updated Jul 24, 2026
One-click install
npx skills add https://github.com/ramp-public/skills --skill ramp-card-management-ramp-public
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ramp-card-management
Source: https://github.com/ramp-public/skills/tree/main/plugins/ramp/skills/ramp-card-management
Command: npx skills add https://github.com/ramp-public/skills --skill ramp-card-management-ramp-public

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Cardholders often cannot tell why a Ramp card will not spend, since a card with an ACTIVE lifecycle state can still be locked by sanctions or overdue tasks. This Skill inspects the true effective status of a card and safely performs activation, lock, and unlock actions with verified postconditions. ## Core Features & Use Cases - Effective Status Inspection: Uses ListCards to read is_spendable, active_locks, and blocking_task_count rather than relying on lifecycle state alone. - Physical Card Activation: Activates cards by last four digits, handling the delivery-confirmation flow only when required. - Safe Lock/Unlock Workflow: Requires explicit user confirmation before locking, routes overdue-task sanctions to ramp-complete-tasks, and re-verifies is_spendable after every write. - Use Case: An employee reports their card is declined. The agent lists their cards, finds an overdue-task lock, loads ramp-complete-tasks to resolve it, then re-checks the exact card before confirming it is spendable. ## Quick Start Ask the agent to check why your Ramp card is not working and unlock it if possible.

Frequently Asked Questions about ramp-card-management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check why my Ramp card is not working?▼

Run ramp cards list or the ListCards MCP tool to inspect the card's effective status. Check is_spendable, active_locks, and blocking_task_count, since a card with an ACTIVE lifecycle state can still be locked and unable to spend.

How do I activate a physical Ramp card?▼

Run ramp cards activate with the card's last four digits. If the result requires delivery confirmation, ask the user to confirm the card arrived, then retry with the --confirm_delivery flag.

Why is my Ramp card locked even though its state is ACTIVE?▼

The ACTIVE lifecycle state does not guarantee spendability. The card may have effective locks listed in active_locks, such as overdue-task sanctions, which require following each lock's remediation_action instead of a manual unlock.

What should I do when a Ramp card unlock returns CardUnlockBlocked?▼

CardUnlockBlocked is a typed failed precondition, not a partial success. Report the returned remaining_locks and blocking_task_count, then follow each remaining lock's remediation action rather than retrying the same unlock.

Can an admin inspect another employee's Ramp cards?▼

Yes. Admins and managers can resolve the employee's user UUID with ramp users org-chart, then pass it as cardholder_user_uuid to ListCards to view that cardholder's cards and lock status.