# Agentcard

- [Getting started](https://docs.agentcard.sh/getting-started/index.md): Agentcard allows your agent to buy anything online.
- [Agentic purchases explained](https://docs.agentcard.sh/getting-started/agentic-purchases-explained.md): The ecosystem an agent needs to buy something online, and where Agentcard fits in.
- [Quickstart](https://docs.agentcard.sh/vault/quickstart.md): Store a user's card once, then complete a first purchase from an agent browser in about fifteen minutes.
- [Adding a card to the Vault](https://docs.agentcard.sh/vault/adding-a-card.md): Create a vault session, send the user one link, and get back a user id you can charge against.
- [Open your cards on another device](https://docs.agentcard.sh/vault/open-your-cards-on-another-device.md): Approve a new computer from the phone that holds your key, and it opens your cards from then on without your master password.
- [Creating a cart](https://docs.agentcard.sh/vault/creating-a-cart.md): Attach Agentcard to the browser your agent already uses, then let it shop.
- [Completing a purchase](https://docs.agentcard.sh/vault/completing-a-purchase.md): The agent submits a placeholder card, the user approves with their passkey, the real card pays, and you confirm the order.
- [Set rules on a card](https://docs.agentcard.sh/vault/set-rules-on-a-card.md): Presets are optional rules for Vault purchases. Save one, attach it to a stored card, and only the purchases paid with that card are judged.
- [Agentcard's Purchase API](https://docs.agentcard.sh/vault/integrations/ecommerce-apis/purchase-api.md): Let your agent buy online without building merchant integrations or running an agent browser.
- [Zinc](https://docs.agentcard.sh/vault/integrations/ecommerce-apis/zinc.md)
- [Ophelia](https://docs.agentcard.sh/vault/integrations/ecommerce-apis/ophelia.md)
- [Your own browser](https://docs.agentcard.sh/vault/integrations/agent-browsers/your-own.md): Use Agentcard with a browser you run yourself to let your agent make purchases with your users' cards.
- [Kernel](https://docs.agentcard.sh/vault/integrations/agent-browsers/kernel.md): Use Agentcard with KERNEL to let your agent make purchases with your users' cards.
- [Browserbase](https://docs.agentcard.sh/vault/integrations/agent-browsers/browserbase.md): Use Agentcard with Browserbase to let your agent make purchases with your users' cards.
- [Linq](https://docs.agentcard.sh/vault/integrations/imessage-providers/linq.md): Use Agentcard with Linq to let your iMessage agent make payments with your users' cards.
- [Photon](https://docs.agentcard.sh/vault/integrations/imessage-providers/photon.md): Use Agentcard with Photon to let your iMessage agent make payments with your users' cards.
- [Blooio](https://docs.agentcard.sh/vault/integrations/imessage-providers/blooio.md): Use Agentcard with Blooio to let your iMessage agent make payments with your users' cards.
- [Quickstart](https://docs.agentcard.sh/issuing/quickstart.md): Authenticate a user, verify their identity, fund their balance, and issue a card your agent can pay with. Sandbox, about fifteen minutes.
- [Authenticating a user](https://docs.agentcard.sh/issuing/authenticating-a-user.md): Send the user a one-time code, verify it, and get the connection token that acts as them.
- [Completing a KYC](https://docs.agentcard.sh/issuing/completing-a-kyc.md): Verify a user's identity once so Agentcard can issue them cards. Hosted page or your own UI.
- [Issuing a card](https://docs.agentcard.sh/issuing/issuing-a-card.md): Fund the user's balance, then create single-use or multi-use cards for your agent.
- [Using the cards](https://docs.agentcard.sh/issuing/using-the-cards.md): Read a card's credentials at checkout, pay with it, and manage it afterwards.
- [Set rules on a card](https://docs.agentcard.sh/issuing/set-rules-on-a-card.md): Presets are optional rules for the cards you issue. Save one, put it on a card, and only that card is judged.
- [Integrating a merchant to the Purchase API](https://docs.agentcard.sh/partners/integrating-a-merchant.md): Expose a catalog and an orders endpoint, and agents on Agentcard can buy from you.
- [API reference](https://docs.agentcard.sh/api-reference/overview.md): Every v2 endpoint, grouped by the resource it acts on. Each page has parameters, responses, and a live playground.
- [Access tokens](https://docs.agentcard.sh/api-reference/access-tokens/overview.md): Exchange your client credentials for the platform token every other call needs.
- [Create an access token](https://docs.agentcard.sh/api-reference/access-tokens/create.md): Exchanges your `client_id` + `client_secret` for a platform access token (OAuth2 client credentials, RFC 6749 §4.4). The token lives one hour — when it expires, exchange again; there are no refresh tokens on this grant.
- [Introspect credential](https://docs.agentcard.sh/api-reference/access-tokens/introspect.md): Returns the organization and mode your token acts as. Useful as a health check and to confirm you're pointed at the right credential.
- [Connections](https://docs.agentcard.sh/api-reference/connections/overview.md): Connect a user to your platform: send a code, verify it, and get a token that acts as them.
- [Send a code](https://docs.agentcard.sh/api-reference/connections/start.md): Sends a one-time code to the user by email or phone. Provide **exactly one** of `email` or `phone`. Codes are valid for 10 minutes.
- [Verify the code](https://docs.agentcard.sh/api-reference/connections/verify.md): Checks the code the user entered and, on success, connects the user and returns the token pair to store. Completing the code **is** the authorization — there is no separate approval screen.
- [Refresh the connection](https://docs.agentcard.sh/api-reference/connections/refresh.md): Connection access tokens expire after one hour. Exchange the refresh token for a new pair before then.
- [Record consent](https://docs.agentcard.sh/api-reference/connections/consent.md): Records that the user authorized your platform to act on their behalf. Safe to retry — it's idempotent per user, so a repeat call updates the same record instead of creating a duplicate.
- [Start attested onboarding](https://docs.agentcard.sh/api-reference/connections/onboarding-attempt-create.md): Create an onboarding attempt for a phone number you already hold and text the returned `wallet_url` to the user. No Agentcard account exists yet: the user sees the wallet instantly, and our one-time code fires exactly once, inside our page, at their first money action. You never see or relay the cod…
- [Exchange the attempt](https://docs.agentcard.sh/api-reference/connections/onboarding-attempt-exchange.md): One-time collection of the user's connection after they verified (you'll know from the `connection.created` webhook, which carries `onboarding_attempt_id`). Returns the same token pair `connect/verify` would have: store `access_token`, `refresh_token`, and `user.id`, and keep the session alive with…
- [Get an onboarding attempt](https://docs.agentcard.sh/api-reference/connections/onboarding-attempt-get.md): Inspect an attempt's state while you wait for `connection.created`: whether the person has verified, whether the grant was already exchanged, and when the attempt expires. Only the client that created the attempt can read it.
- [Vault](https://docs.agentcard.sh/api-reference/vault/overview.md): Store a user's own card once, then authorize checkouts that pay with it.
- [Create a vault session](https://docs.agentcard.sh/api-reference/vault/sessions-create.md): Create a single-use link the user opens to store a card behind their passkey.
- [Get a vault session](https://docs.agentcard.sh/api-reference/vault/sessions-get.md): Read a session until the user finishes. The poll alternative to the vault.session_linked webhook.
- [Send a user their vault link](https://docs.agentcard.sh/api-reference/vault/vault-link.md): Have Agentcard text or email a connected user the link that adds a card to their vault.
- [List a user's vaulted cards](https://docs.agentcard.sh/api-reference/vault/cards-list.md): Display fields for the cards a user has stored. Never card data.
- [Create a checkout authorization](https://docs.agentcard.sh/api-reference/vault/authorizations-create.md): Pause a captured processor request until the user approves it with their passkey.
- [Get a checkout authorization](https://docs.agentcard.sh/api-reference/vault/authorizations-get.md): The authoritative state of one authorization, including the processor response once approved.
- [Cancel a checkout authorization](https://docs.agentcard.sh/api-reference/vault/authorizations-cancel.md): Abandon a paused merchant request before the user's device has started sending the card.
- [List recognized processors](https://docs.agentcard.sh/api-reference/vault/recognizers.md): The processor request formats Agentcard can pause and complete.
- [Get checkout coverage](https://docs.agentcard.sh/api-reference/vault/coverage-get.md): What the direct SDK can pause and complete, processor by processor, with its modes and limitations.
- [Assess checkout cases](https://docs.agentcard.sh/api-reference/vault/coverage-assess.md): Label up to 1,000 observed processor requests as recognized, unsupported, or unverified before you build.
- [Approve before checkout](https://docs.agentcard.sh/api-reference/vault/preparations-create.md): Ask the user to approve before a short-lived card tokenization request starts.
- [Wait for checkout approval](https://docs.agentcard.sh/api-reference/vault/preparations-get.md): Read a preparation until the user is ready for a fresh card request.
- [Cancel a checkout preparation](https://docs.agentcard.sh/api-reference/vault/preparations-cancel.md): Abandon a Square preparation that has not been bound to a merchant request.
- [List presets](https://docs.agentcard.sh/api-reference/vault/presets-list.md): Every preset your company has saved, each with where it is attached.
- [Get a preset](https://docs.agentcard.sh/api-reference/vault/presets-get.md): One saved preset, its rules in plain words, and where it is attached.
- [Save a preset](https://docs.agentcard.sh/api-reference/vault/presets-put.md): Save a named preset, or replace its rules. Saving filters nothing until the preset is attached.
- [Delete a preset](https://docs.agentcard.sh/api-reference/vault/presets-delete.md): Delete a preset and every attachment it had. Its rules stop applying everywhere at once.
- [Attach a preset](https://docs.agentcard.sh/api-reference/vault/presets-attach.md): Attach a saved preset to one of a user's stored cards. Only the purchases paid with that card are judged.
- [Detach a preset](https://docs.agentcard.sh/api-reference/vault/presets-detach.md): Detach a preset from a stored card, one API client, or the company. The purchases it covered there stop being judged by it.
- [Purchases](https://docs.agentcard.sh/api-reference/purchases/overview.md): One conversational endpoint that builds a cart at a real merchant and places the order once you confirm.
- [Buy](https://docs.agentcard.sh/api-reference/purchases/buy.md): One conversational endpoint that places real orders. Send the user's request as plain text in `ask`; thread follow-ups with `conversation_id`; place a shown cart by echoing its `hash` in `confirm` (or an array of hashes for several carts). Money only moves on a confirm, and only for exactly the cart…
- [Conversation status](https://docs.agentcard.sh/api-reference/purchases/conversation.md): The server's view of a /buy conversation, for a confirm whose response never arrived: whether a turn is still running, the last checkout attempt (any outcome, with its code and approval link), and every order the conversation placed, read from the ledger. Same bearer scoping as POST /buy.
- [Merchant catalogue](https://docs.agentcard.sh/api-reference/purchases/merchants.md): The live catalogue for rail selection: every merchant id /buy accepts, its display name, and whether this user still needs to link an account there. Same bearer scoping as POST /buy. Merchant ids are the public ids /buy uses in `placements[].merchant` and `unmatched[].merchant` (`retail` covers Amaz…
- [Cards](https://docs.agentcard.sh/api-reference/cards/overview.md): One-time virtual cards created against a member's added card, authenticated as the member.
- [Get the member flow status](https://docs.agentcard.sh/api-reference/cards/flow-status.md): One read that answers "what should happen next for this member": add a card, create a card, share an approval link, or fetch the open card. Authenticated with the member's connection token from [Verify the code](/companies/api/reference/connect-verify).
- [Create a card](https://docs.agentcard.sh/api-reference/cards/create.md): Create a one-time virtual card against the member's added card, then key its credentials into your checkout and [close it](/companies/api/reference/member-card-close) when you're done. Sandbox answers `201` with an open test card. Production answers `202 approval_pending` with an `approval_url` the…
- [Get a card](https://docs.agentcard.sh/api-reference/cards/get.md): Authoritative card state. While the card is `open` it carries `credentials` (number, expiry, CVC) to key into the checkout. Each read of an open card notifies the member that the credentials were accessed, so fetch once when you are ready to pay rather than polling; poll [flow status](/companies/api…
- [Close a card](https://docs.agentcard.sh/api-reference/cards/close.md): Close a card after checkout. Idempotent: closing a closed card answers `200`. One-time cards also close themselves after their first approved charge.
- [List the member's cards](https://docs.agentcard.sh/api-reference/cards/list.md): The member's wallet as this connection sees it: added cards (attachments, pending included) and the cards created against them.
- [Identity verification](https://docs.agentcard.sh/api-reference/identity-verification/overview.md): Verify a connected user's identity: upload their ID, submit extra fields, then a short face scan.
- [Upload the front of the ID](https://docs.agentcard.sh/api-reference/identity-verification/upload-front.md): Uploads the front of the user's identity document as a base64-encoded image. This step acknowledges receipt; the next step (`back`) tells you what comes next.
- [Upload the back of the ID](https://docs.agentcard.sh/api-reference/identity-verification/upload-back.md): Uploads the back of the document. The response tells you what to do next — this is the branch point of the flow:
- [Submit information](https://docs.agentcard.sh/api-reference/identity-verification/submit-information.md): Submits the extra fields requested by a `needs_information` response. Send only the fields listed in `required_fields`; values are trimmed, and a blank value counts as not provided. For a fresh verification, the response returns the `iframe_url` for the face scan. For an imported verification (Reusa…
- [Get verification status](https://docs.agentcard.sh/api-reference/identity-verification/status.md): Polls the current verification status — the alternative to the `identity.verification.updated` webhook.
- [Import a verification](https://docs.agentcard.sh/api-reference/identity-verification/import.md): Import a verification you already ran on your **own Sumsub account** (Reusable KYC). Generate a single-use share token for the Agentcard client id, send it here, and the user skips document capture and the face scan. A successful import drops into the exact same status contract as a fresh verificati…
- [Simulate an outcome (test mode)](https://docs.agentcard.sh/api-reference/identity-verification/simulate.md): **Test mode only.** Drives a test-mode verification to a chosen terminal outcome instantly — test verifications never complete on their own. The simulated verdict flows through the same status contract and fires the same `identity.verification.updated` webhook a real review produces, so your status…
- [Wallet](https://docs.agentcard.sh/api-reference/wallet/overview.md): A connected user's balance, and how to fund it from your own UI.
- [Get the user's wallet](https://docs.agentcard.sh/api-reference/wallet/get.md): The connected user's wallet and current balance — render it in your own wallet UI. Provisions the wallet on first read.
- [Create a funding session](https://docs.agentcard.sh/api-reference/wallet/fund.md): Returns an Apple Pay / Google Pay payment link for the amount you specify. Show it in your UI; when the user completes the payment the funds land in their wallet. The link is single-use and expires after 30 minutes. Requires a phone verification fresh within 60 days — see `POST /api/v2/wallet/phone/…
- [Get a funding session](https://docs.agentcard.sh/api-reference/wallet/fund-status.md): Poll a funding session until it is `completed` — the payment status is refreshed from the provider on every read.
- [Start phone verification](https://docs.agentcard.sh/api-reference/wallet/phone-start.md): Sends the user a one-time code. Relay it through your UI — the user reads it back to you, same pattern as the connect code. A verification stays fresh for 60 days. Provide `phone_number` only when the user has no phone on file (any E.164 number outside the prohibited-countries list).
- [Verify the phone code](https://docs.agentcard.sh/api-reference/wallet/phone-verify.md): Checks the code the user read back. On success the verification stays fresh for 60 days and funding sessions can be created.
- [Wallet links](https://docs.agentcard.sh/api-reference/wallet-links/overview.md): One texted link that opens a connected user's wallet, as an iMessage App Clip on iOS and a hosted page everywhere else.
- [Create a wallet link](https://docs.agentcard.sh/api-reference/wallet-links/create.md): Mint a short-lived link that opens the user's wallet. Text the URL as is.
- [Webhook endpoints](https://docs.agentcard.sh/api-reference/webhook-endpoints/overview.md): Register the URLs Agentcard delivers events to, choose the events, and rotate signing secrets.
- [Create a webhook endpoint](https://docs.agentcard.sh/api-reference/webhook-endpoints/create.md): Register a URL and the events it receives. The signing secret is returned once.
- [List webhook endpoints](https://docs.agentcard.sh/api-reference/webhook-endpoints/list.md): The endpoints registered in the mode of your token.
- [Get a webhook endpoint](https://docs.agentcard.sh/api-reference/webhook-endpoints/get.md): One endpoint, without its secret.
- [Update a webhook endpoint](https://docs.agentcard.sh/api-reference/webhook-endpoints/update.md): Change the URL, the events, the description, or pause deliveries.
- [Delete a webhook endpoint](https://docs.agentcard.sh/api-reference/webhook-endpoints/delete.md): Remove an endpoint. Deliveries stop immediately.
- [Rotate the signing secret](https://docs.agentcard.sh/api-reference/webhook-endpoints/roll-secret.md): Replace the signing secret. Deliveries are signed with the new one from the next event.
- [Get the signing secret](https://docs.agentcard.sh/api-reference/webhook-endpoints/secret.md): Read the current signing secret for an endpoint.
- [List recent deliveries](https://docs.agentcard.sh/api-reference/webhook-endpoints/deliveries.md): Recent delivery attempts for an endpoint, for debugging.
- [Embed origins](https://docs.agentcard.sh/api-reference/embed-origins/overview.md): The web origins allowed to iframe the wallet embed.
- [Replace embed origins](https://docs.agentcard.sh/api-reference/embed-origins/put.md): Set the full list of origins allowed to frame the wallet embed.
- [Get embed origins](https://docs.agentcard.sh/api-reference/embed-origins/get.md): The origins currently allowed to frame the wallet embed.
- [Blooio connection](https://docs.agentcard.sh/api-reference/blooio/overview.md): Connect your organization's Blooio account so Agentcard can send wallet links from your own Blooio numbers.
- [Start the Blooio connection](https://docs.agentcard.sh/api-reference/blooio/oauth-start.md): Mint the Blooio consent URL to send your operator to.
- [Get the Blooio connection](https://docs.agentcard.sh/api-reference/blooio/connection.md): Whether your organization has connected Blooio, and with which scopes.
- [Webhooks](https://docs.agentcard.sh/webhooks/overview.md): How Agentcard events reach your server: connect an endpoint, verify the signature, and handle retries.
- [Connection events](https://docs.agentcard.sh/webhooks/connections/overview.md): A user connected to your platform, opened their wallet link, or an action needs their approval.
- [connection.created](https://docs.agentcard.sh/webhooks/connections/connection-created.md): A user finished connecting to your platform: they verified the code on `/connect/verify`, or completed attested onboarding.
- [wallet_link.opened](https://docs.agentcard.sh/webhooks/connections/wallet_link-opened.md): The user opened a wallet link you minted, the first time only.
- [approval.requested](https://docs.agentcard.sh/webhooks/connections/approval-requested.md): An action on this user's card needs their approval, for example another connected app asking to close a card.
- [Vault events](https://docs.agentcard.sh/webhooks/vault/overview.md): A vault session linked to a user, and a card landed in their vault.
- [vault.session_linked](https://docs.agentcard.sh/webhooks/vault/vault-session_linked.md): An open vault session got its user: a new enrollment finished, or a returning user signed in with their passkey.
- [vault.card_stored](https://docs.agentcard.sh/webhooks/vault/vault-card_stored.md): The user stored a card in their vault.
- [Checkout authorization events](https://docs.agentcard.sh/webhooks/checkout-authorizations/overview.md): What happened to a paused checkout: approved, submitted, declined, refused by your rules, expired, watched, or charged a different amount.
- [checkout_authorization.approved](https://docs.agentcard.sh/webhooks/checkout-authorizations/checkout_authorization-approved.md): The user approved with their passkey and the processor answered (`token` and `cse` only).
- [checkout_authorization.submitted](https://docs.agentcard.sh/webhooks/checkout-authorizations/checkout_authorization-submitted.md): Hosted-form processors only, instead of `approved`: the user's device attested that it submitted the processor's form.
- [checkout_authorization.declined](https://docs.agentcard.sh/webhooks/checkout-authorizations/checkout_authorization-declined.md): The user said no, a pre-replay check refused it, the processor rejected the request, or your runtime cancelled it.
- [checkout_authorization.expired](https://docs.agentcard.sh/webhooks/checkout-authorizations/checkout_authorization-expired.md): Nobody approved within 15 minutes.
- [checkout_authorization.amount_mismatch](https://docs.agentcard.sh/webhooks/checkout-authorizations/checkout_authorization-amount_mismatch.md): Fires after `approved` for the same authorization when the charge disagreed with the approval.
- [checkout_authorization.refused](https://docs.agentcard.sh/webhooks/checkout-authorizations/checkout_authorization-refused.md): One of your presets refused a purchase before anyone was asked to approve it. No authorization exists and nothing was charged.
- [checkout_authorization.watched](https://docs.agentcard.sh/webhooks/checkout-authorizations/checkout_authorization-watched.md): A finished purchase broke a rule one of your presets watches. Nothing is blocked; you are being told.
- [Order events](https://docs.agentcard.sh/webhooks/orders/overview.md): Every confirm on the Purchase API ends in exactly one order event, plus a confirmation when the retailer accepts.
- [order.placed](https://docs.agentcard.sh/webhooks/orders/order-placed.md): An order was placed at the merchant.
- [order.confirmed](https://docs.agentcard.sh/webhooks/orders/order-confirmed.md): Retail orders only, in addition to `order.placed`: the retailer accepted the order on its side (usually within a minute) and issued its own order number, delivery window, and final total.
- [order.failed](https://docs.agentcard.sh/webhooks/orders/order-failed.md): A confirm ended without a placed order.
- [Card and transaction events](https://docs.agentcard.sh/webhooks/cards/overview.md): Lifecycle of a one-time virtual card and every authorization on it.
- [card.created](https://docs.agentcard.sh/webhooks/cards/card-created.md): A one-time virtual card was created.
- [card.updated](https://docs.agentcard.sh/webhooks/cards/card-updated.md): The card's balance or status changed, for example after its first authorization.
- [card.closed](https://docs.agentcard.sh/webhooks/cards/card-closed.md): The card closed.
- [transaction.authorized](https://docs.agentcard.sh/webhooks/cards/transaction-authorized.md): A merchant authorized a charge on the card.
- [transaction.cleared](https://docs.agentcard.sh/webhooks/cards/transaction-cleared.md): The authorization settled.
- [transaction.declined](https://docs.agentcard.sh/webhooks/cards/transaction-declined.md): A charge was declined.
- [transaction.voided](https://docs.agentcard.sh/webhooks/cards/transaction-voided.md): A pending authorization was reversed by the merchant.
- [balance.low](https://docs.agentcard.sh/webhooks/cards/balance-low.md): A card's remaining balance dropped below its threshold.
- [Identity verification events](https://docs.agentcard.sh/webhooks/identity-verification/overview.md): A user's KYC status changed.
- [identity.verification.updated](https://docs.agentcard.sh/webhooks/identity-verification/identity-verification-updated.md): The verification moved to a new status: `awaiting_documents`, `needs_information`, `requires_verification`, `pending`, `approved`, or `rejected`.
- [Wallet events](https://docs.agentcard.sh/webhooks/wallet/overview.md): Funds arriving in a connected user's wallet.
- [user_wallet.funding_detected](https://docs.agentcard.sh/webhooks/wallet/user_wallet-funding_detected.md): A deposit to the user's wallet address was seen on chain and is confirming.
- [user_wallet.funded](https://docs.agentcard.sh/webhooks/wallet/user_wallet-funded.md): The deposit was credited.
- [Reward and merchant events](https://docs.agentcard.sh/webhooks/rewards/overview.md): Agentcard points earned or reversed, and a merchant account connected for the Purchase API.
- [reward.earned](https://docs.agentcard.sh/webhooks/rewards/reward-earned.md): The user earned Agentcard points on a transaction.
- [reward.reversed](https://docs.agentcard.sh/webhooks/rewards/reward-reversed.md): Points were reversed, for a refund or a voided transaction.
- [merchant.connected](https://docs.agentcard.sh/webhooks/rewards/merchant-connected.md): The user linked a merchant account (for example DoorDash) that `/buy` can now order from.
- [Company wallet events](https://docs.agentcard.sh/webhooks/company-wallet/overview.md): Events for organizations that fund cards from a company balance: cardholders, card flows, transfers, recoveries.
- [cardholder.created](https://docs.agentcard.sh/webhooks/company-wallet/cardholder-created.md): A cardholder was created for your organization.
- [cardholder_onboarding_session.completed](https://docs.agentcard.sh/webhooks/company-wallet/cardholder_onboarding_session-completed.md): A hosted onboarding session finished and the cardholder exists.
- [card_flow.started](https://docs.agentcard.sh/webhooks/company-wallet/card_flow-started.md): A company-funded card mint started: a transfer from the company balance to the cardholder is about to happen.
- [card_flow.failed](https://docs.agentcard.sh/webhooks/company-wallet/card_flow-failed.md): The mint did not complete.
- [transfer.approved](https://docs.agentcard.sh/webhooks/company-wallet/transfer-approved.md): The transfer was approved (by API or in the dashboard).
- [transfer.completed](https://docs.agentcard.sh/webhooks/company-wallet/transfer-completed.md): The funds reached the cardholder.
- [recovery.requested](https://docs.agentcard.sh/webhooks/company-wallet/recovery-requested.md): Residual spending power on a cardholder is being recovered back to the company pool.
- [wallet.funded](https://docs.agentcard.sh/webhooks/company-wallet/wallet-funded.md): The company balance received funds.
- [wallet.balance.low](https://docs.agentcard.sh/webhooks/company-wallet/wallet-balance-low.md): The company balance dropped below the threshold you set, accounting for committed funds.
- [CLI](https://docs.agentcard.sh/tools/cli.md): The agent-cards CLI: manage your organization from the terminal, and give coding agents a tool catalog they can call.
- [agent-cards signup](https://docs.agentcard.sh/tools/cli/signup.md): Sign up or sign in with an emailed code
- [agent-cards login](https://docs.agentcard.sh/tools/cli/login.md): Log in with an emailed code (same as signup)
- [agent-cards logout](https://docs.agentcard.sh/tools/cli/logout.md): Log out and clear stored credentials
- [agent-cards whoami](https://docs.agentcard.sh/tools/cli/whoami.md): Show the currently logged-in user email
- [agent-cards account link](https://docs.agentcard.sh/tools/cli/account-link.md): Link or merge another account of yours (fixes "documents submitted on another
- [agent-cards cards](https://docs.agentcard.sh/tools/cli/cards.md): Manage virtual cards
- [agent-cards cards create](https://docs.agentcard.sh/tools/cli/cards-create.md): Fund and issue a new virtual card
- [agent-cards cards list](https://docs.agentcard.sh/tools/cli/cards-list.md): List all cards
- [agent-cards cards details](https://docs.agentcard.sh/tools/cli/cards-details.md): Show decrypted PAN / CVV / expiry for a card
- [agent-cards cards transactions](https://docs.agentcard.sh/tools/cli/cards-transactions.md): Show transaction history for a card
- [agent-cards cards close](https://docs.agentcard.sh/tools/cli/cards-close.md): Close a card (releases any held funds)
- [agent-cards cards pause](https://docs.agentcard.sh/tools/cli/cards-pause.md): Pause a multi-use card (blocks new charges; reversible with resume)
- [agent-cards cards resume](https://docs.agentcard.sh/tools/cli/cards-resume.md): Resume a paused multi-use card
- [agent-cards cards set-limit](https://docs.agentcard.sh/tools/cli/cards-set-limit.md): Change a multi-use card's total spending limit
- [agent-cards cards preset](https://docs.agentcard.sh/tools/cli/cards-preset.md): Show or set a card's preset (limits & restrictions)
- [agent-cards cards preset list](https://docs.agentcard.sh/tools/cli/cards-preset-list.md): List built-in and saved presets
- [agent-cards cards preset save](https://docs.agentcard.sh/tools/cli/cards-preset-save.md): Save (or update) a named preset from rule flags
- [agent-cards cards preset delete](https://docs.agentcard.sh/tools/cli/cards-preset-delete.md): Delete a saved preset
- [agent-cards cards preset allow-merchant](https://docs.agentcard.sh/tools/cli/cards-preset-allow-merchant.md): Remember a merchant so the next matching charge is allowed
- [agent-cards transactions](https://docs.agentcard.sh/tools/cli/transactions.md): Show transactions across all your cards (or a single card if an id is given)
- [agent-cards attach](https://docs.agentcard.sh/tools/cli/attach.md): Attach your own Visa so purchases charge it directly (no KYC, no funding)
- [agent-cards wallet](https://docs.agentcard.sh/tools/cli/wallet.md): Your wallet — the cards it holds, plus your balance
- [agent-cards balance](https://docs.agentcard.sh/tools/cli/balance.md): Your cash balance (funds new cards) — or one card's balance with an id
- [agent-cards fund](https://docs.agentcard.sh/tools/cli/fund.md): Add cash to your balance via Apple Pay / Google Pay
- [agent-cards withdraw](https://docs.agentcard.sh/tools/cli/withdraw.md): Withdraw cash to your bank, or USDC on Base with --to (processed manually, 1-3
- [agent-cards redeem](https://docs.agentcard.sh/tools/cli/redeem.md): Redeem a promo code; the credit lands in your balance
- [agent-cards codes](https://docs.agentcard.sh/tools/cli/codes.md): List your promo codes: used, processing, or retryable
- [agent-cards payment-method setup](https://docs.agentcard.sh/tools/cli/payment-method-setup.md): Save a payment method for future card creation
- [agent-cards payment-method list](https://docs.agentcard.sh/tools/cli/payment-method-list.md): List your saved payment methods
- [agent-cards payment-method default](https://docs.agentcard.sh/tools/cli/payment-method-default.md): Set your default payment method (prompts if no id given)
- [agent-cards payment-method remove](https://docs.agentcard.sh/tools/cli/payment-method-remove.md): Remove a saved payment method
- [agent-cards plan](https://docs.agentcard.sh/tools/cli/plan.md): View and manage your subscription plan
- [agent-cards plan upgrade](https://docs.agentcard.sh/tools/cli/plan-upgrade.md): Upgrade to a paid plan (basic or pro)
- [agent-cards plan cancel](https://docs.agentcard.sh/tools/cli/plan-cancel.md): Cancel your subscription
- [agent-cards buy](https://docs.agentcard.sh/tools/cli/buy.md): Buy — chat to shop, or use a subcommand to link merchants, shop, and check out
- [agent-cards buy merchants](https://docs.agentcard.sh/tools/cli/buy-merchants.md): List merchants and link status
- [agent-cards buy link](https://docs.agentcard.sh/tools/cli/buy-link.md): Link a merchant account (rappi | goodeggs | doordash)
- [agent-cards buy connect](https://docs.agentcard.sh/tools/cli/buy-connect.md): Link a merchant by logging in via a hosted browser (doordash)
- [agent-cards buy confirm](https://docs.agentcard.sh/tools/cli/buy-confirm.md): Confirm a merchant link with the one-time code
- [agent-cards buy unlink](https://docs.agentcard.sh/tools/cli/buy-unlink.md): Disconnect a merchant (drops the saved session + link)
- [agent-cards buy stores](https://docs.agentcard.sh/tools/cli/buy-stores.md): Find stores within a multi-store merchant (DoorDash) by name
- [agent-cards buy store](https://docs.agentcard.sh/tools/cli/buy-store.md): Scope searches + the cart to one store (DoorDash)
- [agent-cards buy search](https://docs.agentcard.sh/tools/cli/buy-search.md): Search a linked merchant for products
- [agent-cards buy add](https://docs.agentcard.sh/tools/cli/buy-add.md): Add a product to the cart
- [agent-cards buy remove](https://docs.agentcard.sh/tools/cli/buy-remove.md): Remove a product from the cart
- [agent-cards buy qty](https://docs.agentcard.sh/tools/cli/buy-qty.md): Set a product's quantity in the cart (0 removes it)
- [agent-cards buy cart](https://docs.agentcard.sh/tools/cli/buy-cart.md): View the cart
- [agent-cards buy clear](https://docs.agentcard.sh/tools/cli/buy-clear.md): Empty the cart
- [agent-cards buy orders](https://docs.agentcard.sh/tools/cli/buy-orders.md): View recent order history at a linked merchant
- [agent-cards buy reorder](https://docs.agentcard.sh/tools/cli/buy-reorder.md): Re-create a cart from a past order (use the id from `buy orders`)
- [agent-cards buy track](https://docs.agentcard.sh/tools/cli/buy-track.md): Show status + ETA for a placed order (use the id from `buy orders`)
- [agent-cards buy substitution](https://docs.agentcard.sh/tools/cli/buy-substitution.md): Set out-of-stock preference for an item (itemMsid = msid from `buy search`;
- [agent-cards buy addresses](https://docs.agentcard.sh/tools/cli/buy-addresses.md): List the delivery addresses saved on a linked merchant account
- [agent-cards buy set-address](https://docs.agentcard.sh/tools/cli/buy-set-address.md): Set the default delivery address (addressId = the id from `buy addresses`)
- [agent-cards buy budget](https://docs.agentcard.sh/tools/cli/buy-budget.md): Set a spend budget (period: daily|weekly|monthly|total)
- [agent-cards buy checkout](https://docs.agentcard.sh/tools/cli/buy-checkout.md): Place + pay for the cart (DESTRUCTIVE — requires --yes)
- [agent-cards kyc](https://docs.agentcard.sh/tools/cli/kyc.md): Verify your identity (ID photo → auto-read details → quick face scan)
- [agent-cards rewards show](https://docs.agentcard.sh/tools/cli/rewards-show.md): Show the tokenback balance and recent activity
- [agent-cards rewards redeem](https://docs.agentcard.sh/tools/cli/rewards-redeem.md): Redeem tokenback as balance credit (defaults to the full balance)
- [agent-cards connections list](https://docs.agentcard.sh/tools/cli/connections-list.md): List connected apps
- [agent-cards connections revoke](https://docs.agentcard.sh/tools/cli/connections-revoke.md): Revoke an app's access to your account
- [agent-cards approvals list](https://docs.agentcard.sh/tools/cli/approvals-list.md): List pending approval requests
- [agent-cards approvals approve](https://docs.agentcard.sh/tools/cli/approvals-approve.md): Approve a pending request (confirms what you are approving first)
- [agent-cards approvals deny](https://docs.agentcard.sh/tools/cli/approvals-deny.md): Deny a pending request
- [agent-cards setup-mcp](https://docs.agentcard.sh/tools/cli/setup-mcp.md): Configure the AgentCard MCP server in Claude Code
- [agent-cards settings](https://docs.agentcard.sh/tools/cli/settings.md): Manage notification, delivery address, and authorization preferences
- [agent-cards settings notifications](https://docs.agentcard.sh/tools/cli/settings-notifications.md): Configure email notifications
- [agent-cards settings authorization](https://docs.agentcard.sh/tools/cli/settings-authorization.md): View authorization status (always enabled)
- [agent-cards settings default-card](https://docs.agentcard.sh/tools/cli/settings-default-card.md): Pick the default payment agents charge: wallet balance or an attached card
- [agent-cards settings address](https://docs.agentcard.sh/tools/cli/settings-address.md): Set the default delivery address agents ship to
- [agent-cards update](https://docs.agentcard.sh/tools/cli/update.md): Update CLI to the latest version
- [agent-cards support](https://docs.agentcard.sh/tools/cli/support.md): Start a live support conversation
- [agent-cards api](https://docs.agentcard.sh/tools/cli/api.md): The Agentcard tool catalog for agents and scripts (same tools as the MCP
- [agent-cards api tools](https://docs.agentcard.sh/tools/cli/api-tools.md): List tool names as a JSON array (token-cheap for agents)
- [agent-cards api describe](https://docs.agentcard.sh/tools/cli/api-describe.md): Show a tool's description and input/output schemas
- [agent-cards api call](https://docs.agentcard.sh/tools/cli/api-call.md): Invoke a tool with a JSON arguments object (or pipe JSON with -)
- [agent-cards api search](https://docs.agentcard.sh/tools/cli/api-search.md): Search tools by regex over names and descriptions
- [agent-cards api schema](https://docs.agentcard.sh/tools/cli/api-schema.md): Drill into a field of a tool's input schema (dot notation, e.g. items.quantity)
- [agent-cards api skill](https://docs.agentcard.sh/tools/cli/api-skill.md): Published Agentcard skills for coding agents
- [agent-cards agents add](https://docs.agentcard.sh/tools/cli/agents-add.md): Install the Agentcard steering block into your coding agents' instruction files
- [agent-cards engineer init](https://docs.agentcard.sh/tools/cli/engineer-init.md): Provision an engineer engagement for this repo (device login, Slack channel,
- [agent-cards engineer connect](https://docs.agentcard.sh/tools/cli/engineer-connect.md): Run the daemon: bridge proposals from the AgentCard engineer into your coding
- [agent-cards engineer status](https://docs.agentcard.sh/tools/cli/engineer-status.md): Show the engagement, daemon, and report-queue status
- [agent-cards engineer report](https://docs.agentcard.sh/tools/cli/engineer-report.md): Report an AgentCard issue/question to the engineer (for coding agents; queues
- [agent-cards engineer ask](https://docs.agentcard.sh/tools/cli/engineer-ask.md): Ask the AgentCard engineer a question and BLOCK for the answer (for coding
- [agent-cards engineer disconnect](https://docs.agentcard.sh/tools/cli/engineer-disconnect.md): Close the engagement and remove the daemon token, queue, and repo snippet
- [agent-cards companies](https://docs.agentcard.sh/tools/cli/companies.md): Agentcard for Companies — issue cards to your users' agents
- [agent-cards companies wizard](https://docs.agentcard.sh/tools/cli/companies-wizard.md): Run an AI agent that implements Agentcard (OAuth + MCP) into the repo at this
- [agent-cards companies create](https://docs.agentcard.sh/tools/cli/companies-create.md): Create a new company
- [agent-cards companies list](https://docs.agentcard.sh/tools/cli/companies-list.md): List the companies you belong to
- [agent-cards companies get](https://docs.agentcard.sh/tools/cli/companies-get.md): Show details of a company
- [agent-cards companies use](https://docs.agentcard.sh/tools/cli/companies-use.md): Set the default company for companies commands (id or name; bare = pick)
- [agent-cards companies env](https://docs.agentcard.sh/tools/cli/companies-env.md): Show or switch mode for new client credentials (test/production)
- [agent-cards companies subscribe](https://docs.agentcard.sh/tools/cli/companies-subscribe.md): Subscribe to a paid plan for production access (live client credentials)
- [agent-cards companies members](https://docs.agentcard.sh/tools/cli/companies-members.md): Manage company members
- [agent-cards companies return-urls](https://docs.agentcard.sh/tools/cli/companies-return-urls.md): View or set the return-URL allowlist for hosted cardholder onboarding sessions
- [agent-cards companies credentials](https://docs.agentcard.sh/tools/cli/companies-credentials.md): Manage client credentials — pinned OAuth clients for "Connect with Agentcard"
- [agent-cards companies credentials create](https://docs.agentcard.sh/tools/cli/companies-credentials-create.md): Register a client for an app (uses current env mode; production requires an
- [agent-cards companies credentials list](https://docs.agentcard.sh/tools/cli/companies-credentials-list.md): List a company's client credentials
- [agent-cards companies credentials revoke](https://docs.agentcard.sh/tools/cli/companies-credentials-revoke.md): Delete a client and revoke its tokens (interactive)
- [agent-cards companies balance](https://docs.agentcard.sh/tools/cli/companies-balance.md): Company balance — the pooled cash behind create_card's company flow
- [agent-cards companies balance get](https://docs.agentcard.sh/tools/cli/companies-balance-get.md): Show the company balance, deposit address, and settings
- [agent-cards companies balance provision](https://docs.agentcard.sh/tools/cli/companies-balance-provision.md): Create the company balance account (one-time; admin)
- [agent-cards companies balance transfers](https://docs.agentcard.sh/tools/cli/companies-balance-transfers.md): List company-funded card transfers
- [agent-cards companies balance settings](https://docs.agentcard.sh/tools/cli/companies-balance-settings.md): Update company-flow settings
- [agent-cards companies balance test-fund](https://docs.agentcard.sh/tools/cli/companies-balance-test-fund.md): Add TEST-MODE funds to the mock pool (never real money)
- [agent-cards companies balance withdraw](https://docs.agentcard.sh/tools/cli/companies-balance-withdraw.md): Withdraw company cash — to your bank via Coinbase, or USDC to a Base address
- [agent-cards companies webhooks](https://docs.agentcard.sh/tools/cli/companies-webhooks.md): Manage webhook endpoints for company events
- [agent-cards companies webhooks list](https://docs.agentcard.sh/tools/cli/companies-webhooks-list.md): List webhook endpoints
- [agent-cards companies webhooks create](https://docs.agentcard.sh/tools/cli/companies-webhooks-create.md): Create a webhook endpoint (prints the signing secret once)
- [agent-cards companies webhooks update](https://docs.agentcard.sh/tools/cli/companies-webhooks-update.md): Update a webhook endpoint
- [agent-cards companies webhooks delete](https://docs.agentcard.sh/tools/cli/companies-webhooks-delete.md): Delete a webhook endpoint and its delivery history
- [agent-cards companies webhooks reveal](https://docs.agentcard.sh/tools/cli/companies-webhooks-reveal.md): Show the signing secret for a webhook endpoint
- [agent-cards companies webhooks roll-secret](https://docs.agentcard.sh/tools/cli/companies-webhooks-roll-secret.md): Rotate the signing secret for a webhook endpoint
- [agent-cards companies webhooks deliveries](https://docs.agentcard.sh/tools/cli/companies-webhooks-deliveries.md): List recent deliveries for a webhook endpoint
- [agent-cards companies webhooks test](https://docs.agentcard.sh/tools/cli/companies-webhooks-test.md): Send a test event to a webhook endpoint
- [agent-cards companies webhooks listen](https://docs.agentcard.sh/tools/cli/companies-webhooks-listen.md): Manage webhook endpoints for company events
- [MCP](https://docs.agentcard.sh/tools/mcp.md): One Agentcard MCP server, three toolsets: your organization's, your users', and your own.
- [create_cardholder](https://docs.agentcard.sh/tools/mcp/org/create_cardholder.md): Create a cardholder: one of YOUR users, as Agentcard knows them.
- [list_cardholders](https://docs.agentcard.sh/tools/mcp/org/list_cardholders.md): List your organization's cardholders in this mode, newest first.
- [get_cardholder](https://docs.agentcard.sh/tools/mcp/org/get_cardholder.md): Get one cardholder by id (must belong to your org, in this mode).
- [create_onboarding_session](https://docs.agentcard.sh/tools/mcp/org/create_onboarding_session.md): Create a hosted onboarding session: Agentcard collects the user's details, verifies their email with an emailed code, takes consent, and hands you a finished c…
- [get_onboarding_session](https://docs.agentcard.sh/tools/mcp/org/get_onboarding_session.md): Check a hosted onboarding session: pending (email not yet proven), verified (consent pending), completed (cardholder_id is set), or expired.
- [start_cardholder_kyc](https://docs.agentcard.sh/tools/mcp/org/start_cardholder_kyc.md): Start (or resume) identity verification for a cardholder.
- [get_cardholder_kyc_status](https://docs.agentcard.sh/tools/mcp/org/get_cardholder_kyc_status.md): Check a cardholder's identity verification status: not_started, pending (review usually takes about a minute), requires_input (the user must redo something — r…
- [create_card](https://docs.agentcard.sh/tools/mcp/org/create_card.md): Issue a virtual card for a cardholder, holding an exact amount in cents (2500 = $25.00).
- [list_cards](https://docs.agentcard.sh/tools/mcp/org/list_cards.md): List your organization's cards in this mode, newest first.
- [get_card](https://docs.agentcard.sh/tools/mcp/org/get_card.md): Get one card's summary (no card number): balance, status, expiry, cardholder.
- [get_card_details](https://docs.agentcard.sh/tools/mcp/org/get_card_details.md): Reveal a card's full number, expiry, and CVC for checkout.
- [close_card](https://docs.agentcard.sh/tools/mcp/org/close_card.md): Close a card and release any unspent hold.
- [setup_cardholder_payment_method](https://docs.agentcard.sh/tools/mcp/org/setup_cardholder_payment_method.md): Set up a funding payment method for a cardholder — needed when create_card answers payment_method_required.
- [get_cardholder_payment_method_status](https://docs.agentcard.sh/tools/mcp/org/get_cardholder_payment_method_status.md): Check whether a cardholder has a funding payment method on file.
- [get_company_wallet](https://docs.agentcard.sh/tools/mcp/org/get_company_wallet.md): Your organization's pooled wallet: balance, committed and available amounts, the USDC deposit address, and flow settings.
- [list_transfers](https://docs.agentcard.sh/tools/mcp/org/list_transfers.md): List company-wallet transfers (pool → user funding for cards), newest first.
- [confirm_collection](https://docs.agentcard.sh/tools/mcp/org/confirm_collection.md): Report your collection outcome for a company-wallet transfer awaiting it (the card_flow.started webhook is your cue): "succeeded" when you've secured payment f…
- [recover_funds](https://docs.agentcard.sh/tools/mcp/org/recover_funds.md): Recover a cardholder's residual company-funded spending power back into your company wallet — for users you won't fund again (for everyone else, closed-card ba…
- [list_recoveries](https://docs.agentcard.sh/tools/mcp/org/list_recoveries.md): List headroom recoveries (residual cardholder spending power pulled back into the company wallet), newest first.
- [test_charge](https://docs.agentcard.sh/tools/mcp/org/test_charge.md): Sandbox only: simulate a merchant charging a test card, driving the exact settlement a real charge does — authorization, clearing, the one-time-use auto-close,…
- [ask_agentcard_engineer](https://docs.agentcard.sh/tools/mcp/org/ask_agentcard_engineer.md): Ask AgentCard's forward-deployed engineer a question about integrating or debugging AgentCard.
- [get_engineer_reply](https://docs.agentcard.sh/tools/mcp/org/get_engineer_reply.md): Fetch the AgentCard engineer's replies to a question or issue you sent (by its envelope_id, returned from ask_agentcard_engineer / report_agentcard_issue).
- [report_agentcard_issue](https://docs.agentcard.sh/tools/mcp/org/report_agentcard_issue.md): Report a concrete AgentCard integration failure (an API error, an unexpected response, broken behavior) to AgentCard's forward-deployed engineer as a structure…
- [whoami](https://docs.agentcard.sh/tools/mcp/org/whoami.md): Confirm which organization this connection acts as, and whether it is in sandbox (test cards, no real money) or production mode.
- [mint_buy_token](https://docs.agentcard.sh/tools/mcp/org/mint_buy_token.md): Create a scoped 30-day token that lets this cardholder's agent act as THAT ONE USER — add balance to their wallet, complete verification, and shop through the…
- [buy](https://docs.agentcard.sh/tools/mcp/user/buy.md): Shop and check out, in natural language, across the merchants the user has linked (DoorDash, etc.).
- [surprise_me](https://docs.agentcard.sh/tools/mcp/user/surprise_me.md): Buy the user something totally unexpected and very silly/stupid-fun under a small dollar cap (default $10, hard max $25).
- [buy_list_merchants](https://docs.agentcard.sh/tools/mcp/user/buy_list_merchants.md): List merchants available for agent commerce (Rappi, Good Eggs, DoorDash) and whether this user has linked each one.
- [buy_connect](https://docs.agentcard.sh/tools/mcp/user/buy_connect.md): Connect a merchant for shopping.
- [buy_connect_status](https://docs.agentcard.sh/tools/mcp/user/buy_connect_status.md): Check the status of a hosted merchant login started with buy_connect.
- [buy_link_merchant](https://docs.agentcard.sh/tools/mcp/user/buy_link_merchant.md): Link a merchant account so the agent can shop + check out there.
- [buy_unlink_merchant](https://docs.agentcard.sh/tools/mcp/user/buy_unlink_merchant.md): Disconnect a merchant — drops the saved session + link.
- [buy_confirm_merchant](https://docs.agentcard.sh/tools/mcp/user/buy_confirm_merchant.md): Complete linking a cooperative merchant (Rappi) by submitting the one-time code from buy_link_merchant.
- [buy_request_merchant](https://docs.agentcard.sh/tools/mcp/user/buy_request_merchant.md): Log a feature request when the user asks to shop at a merchant/provider Agentcard does NOT support (anything not in buy_list_merchants — e.g.
- [buy_track_order](https://docs.agentcard.sh/tools/mcp/user/buy_track_order.md): Status of a placed order (order id from buy_order_history or the placement confirmation): retail orders carry the retailer's own order number, its quoted deliv…
- [buy_order_history](https://docs.agentcard.sh/tools/mcp/user/buy_order_history.md): List recent orders at a linked merchant.
- [buy_reorder](https://docs.agentcard.sh/tools/mcp/user/buy_reorder.md): Re-create a cart from a past order (use the order id from buy_order_history), making it the active cart.
- [buy_return_order](https://docs.agentcard.sh/tools/mcp/user/buy_return_order.md): Start a return for a placed retail order (Amazon/Walmart lane) — use the order id from buy_order_history / the placement confirmation.
- [buy_return_status](https://docs.agentcard.sh/tools/mcp/user/buy_return_status.md): Status + return-label URLs for a return started with buy_return_order (by its return_id).
- [buy_addresses](https://docs.agentcard.sh/tools/mcp/user/buy_addresses.md): List the delivery addresses saved on a linked merchant account.
- [buy_set_default_address](https://docs.agentcard.sh/tools/mcp/user/buy_set_default_address.md): Set the default delivery address on a linked merchant account.
- [buy_set_delivery_address](https://docs.agentcard.sh/tools/mcp/user/buy_set_delivery_address.md): Set a NEW delivery address by its raw parts (street, city, state, zip) for merchants with NO saved addresses to choose from (e.g.
- [buy_set_gift_recipient](https://docs.agentcard.sh/tools/mcp/user/buy_set_gift_recipient.md): DoorDash only: send this order as a GIFT — marks the cart as a gift for a recipient identified by their first name + phone (DoorDash texts them).
- [buy_set_budget](https://docs.agentcard.sh/tools/mcp/user/buy_set_budget.md): Set a spending budget that the spend gate enforces before any checkout creates a card.
- [buy_get_budget](https://docs.agentcard.sh/tools/mcp/user/buy_get_budget.md): Show the user's spending budgets: the daily/weekly/monthly/total caps the spend gate enforces before any checkout, each with its limit, spent, and remaining am…
- [buy_save_traveler](https://docs.agentcard.sh/tools/mcp/user/buy_save_traveler.md): Save the traveller (passenger) details a flight booking needs: legal first + last name (as on their government ID), date of birth (YYYY-MM-DD), gender, contact…
- [buy_cancel_flight](https://docs.agentcard.sh/tools/mcp/user/buy_cancel_flight.md): Cancel a flight the user previously booked, and refund them.
- [manage_subscription](https://docs.agentcard.sh/tools/mcp/user/manage_subscription.md): Manage a recurring meal/grocery SUBSCRIPTION (e.g.
- [buy_search_products](https://docs.agentcard.sh/tools/mcp/user/buy_search_products.md): Search a linked merchant for products by keyword.
- [buy_search_stores](https://docs.agentcard.sh/tools/mcp/user/buy_search_stores.md): Find orderable stores within a multi-store merchant (DoorDash) by name.
- [buy_select_store](https://docs.agentcard.sh/tools/mcp/user/buy_select_store.md): Scope subsequent searches and the cart to one store within a multi-store merchant (DoorDash).
- [buy_add_to_cart](https://docs.agentcard.sh/tools/mcp/user/buy_add_to_cart.md): Add a product (by id from buy_search_products or the menu digest) to the cart.
- [buy_add_items](https://docs.agentcard.sh/tools/mcp/user/buy_add_items.md): Add SEVERAL items to the cart in ONE call — use this instead of repeated buy_add_to_cart whenever the user wants a multi-item order (e.g.
- [buy_remove_from_cart](https://docs.agentcard.sh/tools/mcp/user/buy_remove_from_cart.md): Remove a product (by id) from the cart at a linked merchant.
- [buy_set_item_quantity](https://docs.agentcard.sh/tools/mcp/user/buy_set_item_quantity.md): Set a product's quantity in the cart (0 removes it).
- [buy_view_cart](https://docs.agentcard.sh/tools/mcp/user/buy_view_cart.md): View the current cart (items + totals) at a linked merchant.
- [buy_clear_cart](https://docs.agentcard.sh/tools/mcp/user/buy_clear_cart.md): Empty the cart at a linked merchant.
- [buy_get_item_options](https://docs.agentcard.sh/tools/mcp/user/buy_get_item_options.md): For a restaurant item where buy_search_products reported hasOptions=true, or the user asked to customize/modify an item, or buy_add_to_cart failed with options…
- [buy_set_substitution](https://docs.agentcard.sh/tools/mcp/user/buy_set_substitution.md): Set the out-of-stock preference for one item in a placed order.
- [buy_checkout](https://docs.agentcard.sh/tools/mcp/user/buy_checkout.md): DESTRUCTIVE: place + pay for the current cart.
- [create_card](https://docs.agentcard.sh/tools/mcp/user/create_card.md): The one card tool: get the user a virtual debit card for a purchase.
- [list_cards](https://docs.agentcard.sh/tools/mcp/user/list_cards.md): The user's wallet: every live card they hold, with IDs, last four digits, expiry, balance, and status, plus `vaultCards`: the user's OWN cards stored in their…
- [get_card_details](https://docs.agentcard.sh/tools/mcp/user/get_card_details.md): Get decrypted PAN, CVV, expiry, and current balance for a specific card.
- [get_card_balance](https://docs.agentcard.sh/tools/mcp/user/get_card_balance.md): The live balance of ONE virtual card (the user's overall cash balance is get_balance).
- [pause_card](https://docs.agentcard.sh/tools/mcp/user/pause_card.md): Pause a multi-use card: temporarily blocks ALL new charges (reversible — use resume_card to unblock).
- [resume_card](https://docs.agentcard.sh/tools/mcp/user/resume_card.md): Resume a paused multi-use card so it accepts charges again.
- [update_card_limit](https://docs.agentcard.sh/tools/mcp/user/update_card_limit.md): Change a multi-use card's total spending limit.
- [close_card](https://docs.agentcard.sh/tools/mcp/user/close_card.md): Permanently close a virtual card.
- [get_card_preset](https://docs.agentcard.sh/tools/mcp/user/get_card_preset.md): Read the rules on a card as a plain summary.
- [set_card_preset](https://docs.agentcard.sh/tools/mcp/user/set_card_preset.md): Put rules on a card.
- [allow_card_merchant](https://docs.agentcard.sh/tools/mcp/user/allow_card_merchant.md): Remember a merchant so the next charge there passes the card's category and merchant rules.
- [list_presets](https://docs.agentcard.sh/tools/mcp/user/list_presets.md): List every preset the user can pass by name, built-in and saved, each with a plain summary.
- [save_preset](https://docs.agentcard.sh/tools/mcp/user/save_preset.md): Save a set of rules under a name so the user can reuse it in create_card or set_card_preset.
- [delete_preset](https://docs.agentcard.sh/tools/mcp/user/delete_preset.md): Retire a saved preset name. Cards already issued keep their rules.
- [get_wallet_link](https://docs.agentcard.sh/tools/mcp/user/get_wallet_link.md): The user's hosted wallet, as one shareable URL.
- [list_added_cards](https://docs.agentcard.sh/tools/mcp/user/list_added_cards.md): List the user's ADDED cards (their own Visa/Mastercard cards enrolled via create_card's add-card flow — the funding source that charges their own card), with i…
- [remove_added_card](https://docs.agentcard.sh/tools/mcp/user/remove_added_card.md): Remove (unenroll) one of the user's added cards.
- [get_balance](https://docs.agentcard.sh/tools/mcp/user/get_balance.md): The user's cash balance: the money that funds new cards.
- [add_funds](https://docs.agentcard.sh/tools/mcp/user/add_funds.md): Generate a secure checkout link the user opens to add cash to their own balance (the money that funds new cards) via Apple Pay or Google Pay, in USD.
- [start_phone_verification](https://docs.agentcard.sh/tools/mcp/user/start_phone_verification.md): Send (or re-send) the user's one-time funding verification code (the provider verifies the phone on the user's Agentcard identity, valid 60 days).
- [verify_phone](https://docs.agentcard.sh/tools/mcp/user/verify_phone.md): Check the one-time code the user received from start_phone_verification.
- [submit_funding_profile](https://docs.agentcard.sh/tools/mcp/user/submit_funding_profile.md): Save the user's one-time funding profile — five multiple-choice compliance answers (employment status, source of funds, industry, income band, expected yearly…
- [withdraw](https://docs.agentcard.sh/tools/mcp/user/withdraw.md): Withdraw cash from the user's balance, either to their saved bank account or to a crypto address on Base (USDC).
- [create_withdrawal_recipient](https://docs.agentcard.sh/tools/mcp/user/create_withdrawal_recipient.md): Save a bank account as a withdrawal destination for the user's cash balance.
- [list_withdrawal_recipients](https://docs.agentcard.sh/tools/mcp/user/list_withdrawal_recipients.md): List the user's saved bank accounts for withdrawals, masked (bank name and last four only).
- [redeem_code](https://docs.agentcard.sh/tools/mcp/user/redeem_code.md): Redeem a promo code that adds money to the user's cash balance.
- [list_codes](https://docs.agentcard.sh/tools/mcp/user/list_codes.md): List the user's promo (coupon) codes: every code they have redeemed or attempted, with its amount and state — used (credit already sent), awaiting_verification…
- [start_kyc](https://docs.agentcard.sh/tools/mcp/user/start_kyc.md): Begin (or resume) identity verification.
- [submit_kyc_document](https://docs.agentcard.sh/tools/mcp/user/submit_kyc_document.md): Submit the user's ID photo for identity verification.
- [check_kyc_document](https://docs.agentcard.sh/tools/mcp/user/check_kyc_document.md): Check the conversational verification state — use after the user uploads their ID via the browser upload link (or any time you need to re-orient).
- [submit_kyc_fields](https://docs.agentcard.sh/tools/mcp/user/submit_kyc_fields.md): Submit identity fields for verification: the ones the ID photo didn't carry (listed by missingFields — the tax/ID number always has to be asked since IDs don't…
- [get_kyc_status](https://docs.agentcard.sh/tools/mcp/user/get_kyc_status.md): Check the user's identity verification (KYC) status.
- [complete_kyc_transfer](https://docs.agentcard.sh/tools/mcp/user/complete_kyc_transfer.md): One-time transfer for users verified under the LEGACY hosted KYC flow (verified before July 2026): carries their existing, approved verification into the curre…
- [submit_user_info](https://docs.agentcard.sh/tools/mcp/user/submit_user_info.md): Submit the user's phone number and terms acceptance for a virtual card.
- [list_payment_methods](https://docs.agentcard.sh/tools/mcp/user/list_payment_methods.md): List the saved payment methods (used only to pay for flight bookings, not for cards or adding funds).
- [setup_payment_method](https://docs.agentcard.sh/tools/mcp/user/setup_payment_method.md): Save a payment method used ONLY to pay for flight bookings (the fare is charged to it via a hold at booking; no virtual card is created for flights).
- [set_default_payment_method](https://docs.agentcard.sh/tools/mcp/user/set_default_payment_method.md): Set which saved payment method is the default charged for flight bookings.
- [remove_payment_method](https://docs.agentcard.sh/tools/mcp/user/remove_payment_method.md): Remove a saved payment method.
- [get_rewards](https://docs.agentcard.sh/tools/mcp/user/get_rewards.md): Show the user's tokenback: balance, lifetime earned, and recent activity.
- [redeem_rewards](https://docs.agentcard.sh/tools/mcp/user/redeem_rewards.md): Redeem tokenback: the tokens' cash value (1 token = 1¢) lands on the user's rewards card as spending power.
- [list_transactions](https://docs.agentcard.sh/tools/mcp/user/list_transactions.md): Transactions with amount, merchant, status, and timestamps.
- [list_transactions_by_payment_method](https://docs.agentcard.sh/tools/mcp/user/list_transactions_by_payment_method.md): List transactions across the whole account GROUPED by payment method: wallet (USDC collateral) card spend, legacy saved-card-on-file spend, sandbox/test card s…
- [list_all_transactions](https://docs.agentcard.sh/tools/mcp/user/list_all_transactions.md): Advanced/legacy: use list_transactions WITHOUT a card_id for the all-cards view instead.
- [list_pending_approvals](https://docs.agentcard.sh/tools/mcp/user/list_pending_approvals.md): List the user's PENDING approval requests: asks from connected apps (create a card, view full card details, close/pause/resume a card, change a limit) waiting…
- [approve_request](https://docs.agentcard.sh/tools/mcp/user/approve_request.md): Resolve a pending approval request (approve or deny) once the USER has decided.
- [whoami](https://docs.agentcard.sh/tools/mcp/user/whoami.md): Show who you are operating as: the authenticated AgentCard account's email, user id, name, plan, KYC + account status, member-since date, and how this session…
- [get_instructions](https://docs.agentcard.sh/tools/mcp/user/get_instructions.md): Call this FIRST; returns the latest usage guide for shopping with `buy` AND for operating the Agentcard account tools (cards, funding, your own card, KYC, supp…
- [get_settings](https://docs.agentcard.sh/tools/mcp/user/get_settings.md): View the user's notification preferences (which email alerts they receive), their default payment source (which card or balance agents charge — check it before…
- [update_settings](https://docs.agentcard.sh/tools/mcp/user/update_settings.md): Update the user's email notification preferences, their default delivery address (the wallet-level shipping address agents use when buying physical goods for t…
- [get_plan](https://docs.agentcard.sh/tools/mcp/user/get_plan.md): Show the user's current subscription plan, card limits, and this month's usage.
- [upgrade_plan](https://docs.agentcard.sh/tools/mcp/user/upgrade_plan.md): Start a paid-plan upgrade.
- [cancel_plan](https://docs.agentcard.sh/tools/mcp/user/cancel_plan.md): Cancel the active paid subscription, reverting to the free plan.
- [link_account](https://docs.agentcard.sh/tools/mcp/user/link_account.md): Link or merge another Agentcard account that belongs to the same person.
- [list_connections](https://docs.agentcard.sh/tools/mcp/user/list_connections.md): List the third-party apps the user has connected to their Agentcard account via OAuth (e.g.
- [revoke_connection](https://docs.agentcard.sh/tools/mcp/user/revoke_connection.md): Revoke a third-party app's access to the user's Agentcard account.
- [start_support_chat](https://docs.agentcard.sh/tools/mcp/user/start_support_chat.md): Start a new support conversation and send the first message
- [send_support_message](https://docs.agentcard.sh/tools/mcp/user/send_support_message.md): Send a message in an existing support conversation
- [read_support_chat](https://docs.agentcard.sh/tools/mcp/user/read_support_chat.md): Read the message history of a support conversation

## OpenAPI Specs

- [openapi](/openapi.json)