Are you an agent?

setup_payment_method

params: {}

Sets up a payment method for future card creation. Returns a Stripe checkout URL for the user to save their card details. Must be done once before creating any cards.

create_card

params: {amount_cents: number, sandbox?: boolean}

Creates a virtual card funded from the saved payment method. Limits: max $50 per card, max 5 cards/month (free plan). May return user_info_required — if so, call submit_user_info first.

Use sandbox: true for testing without real charges.

submit_user_info

params: {phone_number: string, terms_accepted: boolean}

Submit phone number and terms acceptance required before first card creation. Call this when create_card returns a user_info_required response.

list_cards

params: {}

Returns all cards with ID, last four, expiry, balance, status. If empty, call create_card to issue a new one.

get_card_details

params: {card_id: string}

Returns decrypted PAN, CVV, expiry, balance. May require human approval — if so, prompt the user and call approve_request. Use only when you need to fill in a payment form. Prefer check_balance for balance checks.

check_balance

params: {card_id: string}

Returns current balance. Faster than get_card_details and does not expose credentials.

close_card

params: {card_id: string}

Permanently closes a card. Irreversible. Safe to call on already-closed cards.

list_transactions

params: {card_id: string, limit?: number, status?: string}

Returns transactions with amount, merchant, status, timestamps.

Filter by status: PENDING, SETTLED, DECLINED, REVERSED, EXPIRED, REFUNDED.

approve_request

params: {approval_id: string, decision: "approved" | "denied", action: "card_details" | "transaction", resource_id: string}

Resolve a pending approval request. Required when get_card_details or create_card returns a 202. On approval, automatically completes the follow-up action and returns the result.

pay_checkout

params: {url?: string, amount_cents?: number, tab_id?: number}

Auto-fill a checkout page with an Analogpay card. Creates or reuses a card, fills the payment form. Requires Chrome with the Analogpay Pay extension installed.

If not installed: npx analogpay-card extension install

fill_card

params: {card_id: string, tab_id?: number}

Fill an existing card into the current checkout form. Requires Chrome with the Analogpay Pay extension.

detect_checkout

params: {tab_id?: number}

Check if the current browser tab is a checkout page. Returns detection confidence, detected amount, and scoring signals.

remove_payment_method

params: {payment_method_id: string}

Remove a saved payment method permanently.

start_support_chat

params: {message: string}

Start a new support conversation.

send_support_message

params: {conversation_id: string, message: string}

Send a message in an existing support conversation.

read_support_chat

params: {conversation_id: string}

Read the message history of a support conversation.