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_balance

Returns the current account balance and available funds.

• Scope: account:read
• Parameters: None
• Returns: Balance object with available and pending amounts

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 and, if approved, issues a single-use virtual card.

May fail if the purchase is blocked by spending rules or requires user approval.

• 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