Tools

These are the tools available to AI agents connected to Axiom via MCP. Each tool requires specific scopes to be granted during authorization.

Account Tools

whoami

Returns the authenticated user's profile information.

• Scope: account:read
• Parameters: None
• Returns: User profile with userID, createdAt, updatedAt

get_account_summary

Returns an overview of the account including creation and last update timestamps.

• Scope: account:read
• Parameters: None
• Returns: Account summary with userID, accountCreated, lastUpdated

get_payment_method

Returns the user's linked payment method. Only the card brand and last 4 digits are returned.

• Scope: account:read
• Parameters: None
• Returns: Card brand and last 4 digits, or a message if no payment method is linked

Payment Tools

get_payment_details

Returns card and billing details to complete a purchase. This is the primary tool for agent spending. Axiom evaluates the user's spending rules, issues a single-use virtual card, and charges the user's linked payment method.

May fail if the purchase is blocked by spending rules, requires user approval, no payment method is linked, or the card is declined.

• Scope: payments:read
• Parameters:
  • transactionId (string, optional) — Transaction ID from a prior approval flow
  • itemName (string, required) — Name of the item being purchased
  • itemAmount (number, required) — Amount in dollars
  • merchant (object, required):
    • merchantName (string) — Merchant name
    • merchantWebsite (string, optional) — Merchant website URL
  • reasonForPurchase (object, required):
    • userCommand (string) — The original user instruction
    • aiReasoning (string) — AI reasoning for why this purchase fulfills the request

Transaction Tools

list_transactions

Returns recent transactions with optional filtering.

• Scope: transactions:read
• Parameters:
  • cardId (string, optional) — Filter transactions by a specific card
  • limit (number, optional) — Maximum number of transactions to return (1–100, default 20)
• Returns: Array of transaction objects with amount, merchant, status, and timestamps

create_receipt

Attaches receipt details to a completed transaction.

• Scope: transactions:write
• Parameters:
  • transactionId (string, required) — The transaction ID to attach the receipt to
  • merchant (object, required):
    • name (string) — Merchant name
    • description (string, optional)
    • website (string, optional)
    • imageUrl (string, optional) — Square logo URL
  • items (array, required) — At least one item:
    • name (string), description (string, optional), imageUrl (string, optional), amount (number)
  • taxesAndFees (array, optional) — name and amount for each
  • shipping (object, optional) — name and amount
  • auditTrail (object, required):
    • reasoning (array of strings) — Step-by-step reasoning for the purchase decisions