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.