AgentCard Skill

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.

Quick Install

npx skills add tiny-agent-company/agent-card-skill

Then 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/mcp

For 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.

Setup Prompt

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 signup
   (I need to click the magic link in my email — wait for me to confirm)

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.

Don't Have an Account?

npm install -g agent-cards
agent-cards signup

What's Included

Skill (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.

What Can Your Agent Do?

How It Works

1. Skill = procedural knowledge (a markdown file that gets loaded into your agent's context)
2. 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

Links

• AgentCard — Product website
• skills.sh — Skill registry
• MCP Server — Remote MCP endpoint (OAuth 2.1)

License & Security

MIT — see LICENSE. Security reports: see SECURITY.md or email [email protected]. 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.