Give any AI agent the ability to create and manage virtual Visa cards, funded from a wallet the user tops up with Apple Pay or Google Pay.
This skill teaches AI agents how to use AgentCard MCP tools — creating cards, checking balances, paying for things, and more. It works with Claude Code, Cursor, Cline, Windsurf, and 40+ other agents.
npx skills add tiny-agent-company/agent-card-skillThen connect the MCP server to give your agent access to the tools:
# Claude Code (option A — built-in CLI command)
agent-cards setup-mcp
# Claude Code (option B — manual)
claude mcp add --transport http agent-cards https://mcp.agentcard.sh/mcpFor Cursor, Windsurf, and other MCP-compatible agents, add to the MCP config file (.cursor/mcp.json, .windsurf/mcp.json, etc.):
{
"mcpServers": {
"agent-cards": {
"url": "https://mcp.agentcard.sh/mcp"
}
}
}Restart your agent session after adding the MCP server — tools don't load until next session.
Authentication is handled via OAuth — your agent will prompt you to sign in on first use.
Copy-paste this into your AI agent to have it set everything up:
Set up AgentCard so I can create and manage virtual Visa cards from this agent.
Do these steps in order. Some steps require me to do something — wait for my confirmation before moving on.
1. Install the AgentCard skill:
npx skills add tiny-agent-company/agent-card-skill
2. Install the CLI:
npm install -g agent-cards
3. Check if I'm already logged in:
agent-cards whoami
If not logged in, run: agent-cards login --email <my email>
(a one-time code lands in my email — ask me for it, then run:
agent-cards login --email <my email> --code <the code>)
4. Connect the MCP server:
agent-cards setup-mcp
If that doesn't work, run: claude mcp add --transport http agent-cards https://mcp.agentcard.sh/mcp
5. Tell me to restart this session so the MCP tools load.
Do NOT try to use the tools in this session — they won't work until restart.
Do NOT fall back to curl or raw API calls.
After I restart the session, I'll ask you to list my cards to verify it works.
npm install -g agent-cards
agent-cards signupSkill (SKILL.md) — Procedural knowledge that teaches the agent:
- When and how to use each of the 44 AgentCard tools
- Workflows: wallet funding (with the one-time verification code), card creation, single-use vs multi-use cards, balance checks, shopping & checkout (
buy), payments, checkout autofill, withdrawals, plans, support - Safety rules: never expose PAN/CVV unprompted, confirm before closing cards, placing an order, or withdrawing
- Error handling: verification codes, KYC, funding gates, approval flows
Setup guide (references/setup.md) — Connection instructions the agent reads if tools aren't available yet.
| Capability | Tools |
|---|---|
| Fund the wallet | get_balance, add_funds, start_phone_verification, verify_phone, redeem_code, list_codes |
| Issue virtual cards | create_card, submit_user_info |
| Verify identity | start_kyc, get_kyc_status |
| Manage cards | list_cards, get_card_balance, get_card_details, close_card, pause_card, resume_card, update_card_limit |
| Withdraw funds | withdraw, create_withdrawal_recipient |
| Rewards | get_rewards, redeem_rewards |
| View spending | list_transactions, list_all_transactions, list_transactions_by_payment_method |
| Shop & check out | buy, get_instructions, buy_list_merchants, buy_unlink_merchant |
| Bring your own card | attach_card |
| Payment methods | setup_payment_method, remove_payment_method, list_payment_methods, set_default_payment_method |
| Plans & limits | get_plan, upgrade_plan, cancel_plan |
| Connected apps | list_connections |
| Account identity | whoami |
| Approvals | approve_request |
| Support | start_support_chat, send_support_message, read_support_chat |
- Skill = procedural knowledge (a markdown file that gets loaded into your agent's context)
- MCP server = tools (the actual API endpoints your agent calls)
You need both. The skill teaches the agent how to use the tools effectively — workflows, safety rules, error handling. The MCP server provides the tools themselves.
User: "Create me a $25 virtual card"
↓
Agent reads SKILL.md → knows the workflow
↓
Agent calls create_card(amount_cents: 2500) via MCP
↓
Card issued → agent presents summary
- AgentCard — Product website
- skills.sh — Skill registry
- MCP Server — Remote MCP endpoint (OAuth 2.1)
MIT — see LICENSE. Security reports: see SECURITY.md or email felipe@agentcard.sh. This repo is a read-only mirror of the canonical skill in the Agentcard monorepo; the published copy is checksummed at agentcard.sh/.well-known/agent-skills/index.json.