Tools Reference - Agentcard

All tools are prefixed mcp__agent-cards__* in your client. Amounts are in cents (e.g. $25 = 2500); always display them back as dollars.

Getting started

Tool	Purpose
`get_instructions`	Return the current usage guide — call this first.
`submit_user_info`	Submit one-time KYC (name, DOB, phone, `terms_accepted`) required before the first card.
`approve_request`	Approve or deny a pending approval request.

Tool	Purpose
`list_cards`	List all cards with IDs, last four, expiry, balance, and status.
`create_card`	Create a new virtual Visa card (`amount_cents`; needs a saved payment method).
`check_balance`	Check a card’s live balance without exposing credentials.
`get_card_details`	Get decrypted PAN, CVV, and expiry (may require approval).
`close_card`	Permanently close a card (irreversible).
`list_transactions`	List a card’s transactions with amount, merchant, status, and timestamps.

Tool	Purpose
`setup_payment_method`	Save a payment method via Stripe for future card creation.
`list_payment_methods`	List saved methods (id, brand, last4, expiry); marks the default.
`set_default_payment_method`	Choose which saved method funds new cards.
`remove_payment_method`	Remove a saved payment method.

Tool	Purpose
`get_plan`	Show current plan, per-card cap, monthly usage, and upgrade options.
`upgrade_plan`	Start a Stripe Checkout to upgrade (Basic or Pro).
`cancel_plan`	Cancel the active paid subscription (revert to Free).
`get_mode`	Show the issuing mode (test = sandbox, prod = live cards).
`set_mode`	Switch issuing mode between test and prod.

Tool	Purpose
`detect_checkout`	Check if the current browser tab is a checkout page.
`fill_card`	Fill an existing card into a checkout form.
`pay_checkout`	Create a new card and fill the checkout form in one step.

The conversational buy tool runs the whole shop-and-checkout flow; the granular buy_* tools back it. See the Shopping guide.

Tool	Purpose
`buy`	Natural-language shopping: describe a purchase and it runs the flow.
`buy_list_merchants`	List merchants and link status.
`buy_link_merchant` / `buy_confirm_merchant` / `buy_unlink_merchant`	Link, confirm, or disconnect a merchant.
`buy_search_stores` / `buy_select_store`	Find and scope to a store within a multi-store merchant.
`buy_search_products`	Search a linked merchant for products.
`buy_add_to_cart` / `buy_set_item_quantity` / `buy_remove_from_cart` / `buy_view_cart` / `buy_clear_cart`	Build and inspect the cart.
`buy_set_budget`	Set a spend budget.
`buy_checkout`	Place and pay for the cart.
`buy_order_history` / `buy_reorder` / `buy_track_order` / `buy_set_substitution`	Review, re-create, track orders, and set out-of-stock preferences.
`buy_addresses` / `buy_set_default_address`	List and set delivery addresses.

Tool	Purpose
`start_support_chat`	Open a new support conversation.
`send_support_message`	Send a message in a conversation.
`read_support_chat`	Read a conversation’s message history.

Tool	Purpose
`list_connections`	List third-party apps connected to your account.