open-wallets

Universal wallet management for AI agents. Create and manage virtual cards across multiple providers via CLI or MCP server.

Features

Multi-provider support — AgentCard, Stripe Issuing (coming soon), and more
MCP server — 10 tools for AI agents to manage wallets programmatically
CLI — Full-featured command-line interface with --json output
Doctor command — Diagnose configuration, provider health, and MCP setup
Agent tracking — Assign cards to specific AI agents
Transaction history — Track all card activity

Installation

bun install -g @hasna/wallets

Quick Start

# Register a provider
wallets provider add agentcard --jwt YOUR_JWT_TOKEN --default

# Create a funded card
wallets card create --amount 50 --name "Shopping Card"

# List all cards
wallets card list

# Check balance
wallets balance <card-id>

# Get full card details (PAN, CVV, expiry)
wallets card details <card-id>

# Close a card
wallets card close <card-id>

# Run diagnostics
wallets doctor

MCP Setup

# Install for Claude Code
wallets mcp --claude

# Install for all agents
wallets mcp --all

# Manual setup (add to MCP config):
# Command: wallets-mcp

MCP Tools

Tool	Description
`create_card`	Create a new funded virtual card
`list_cards`	List all virtual cards
`get_card_details`	Get full card details (PAN, CVV, expiry)
`get_balance`	Check card balance
`close_card`	Close a card permanently
`list_providers`	List registered wallet providers
`register_provider`	Register a wallet provider
`list_transactions`	List card transactions
`doctor`	Run wallet diagnostics
`describe_tools`	Get full schema for wallet tools

Providers

AgentCard (agentcard.sh)

Prepaid virtual Visa cards for AI agents. Sign up at agentcard.sh.

# Install AgentCard CLI
npm install -g agent-cards

# Sign up and get JWT
agent-cards signup

# Register with open-wallets
wallets provider add agentcard --jwt YOUR_JWT --default

Coming Soon

Stripe Issuing — Native virtual card issuing via Stripe
Privacy.com — Virtual cards for online purchases

Configuration

Config stored at ~/.wallets/config.json:

{
  "default_provider": "agentcard",
  "default_currency": "USD",
  "providers": {
    "agentcard": {
      "jwt": "your-jwt-token"
    }
  }
}

Database stored at ~/.wallets/wallets.db (SQLite, WAL mode). Override with WALLETS_DB_PATH env var.

Library Usage

import { createCardRecord, listCards, getProviderInstance } from "@hasna/wallets";

// Create a provider instance
const provider = getProviderInstance("agentcard", { jwt: "your-jwt" });

// Create a card via the provider
const card = await provider.createCard({ amount: 50 });

// List all cards from the database
const cards = listCards({ status: "active" });

Development

git clone https://github.com/hasna/open-wallets.git
cd open-wallets
bun install
bun test
bun run build

License

Apache-2.0