Axiomdocs

Quickstart

Set up Axiom so your AI agent can make purchases on your behalf.

This guide walks you through connecting your AI agent to Axiom. Choose your platform below.

Prerequisites

Before you start, make sure you have:

  1. An Axiom account with a card on file: sign up at the Axiom dashboard and finish setup. (Connecting from ChatGPT? You can create your account during the connection flow. It includes an optional step to add a card and shipping address; you can skip it, and ChatGPT will ask again at your first order.)
  2. An AI agent that supports MCP (e.g. ChatGPT, Claude Desktop, OpenClaw).

Axiom is available in the ChatGPT plugin store. No configuration needed.

1. Add Axiom from the plugin store

In ChatGPT, browse the plugin directory (or ask ChatGPT for Axiom), select Axiom, and choose Connect.

2. Sign in and allow

ChatGPT sends you to Axiom to connect your accounts. Create your account (or sign in), then confirm your email with the link in the message Axiom sends you, or by entering its 6-digit code. Axiom then offers to save a card and shipping address; you can skip this step, and ChatGPT will ask again at your first order. Finally, allow ChatGPT to place orders for you; see Scopes for exactly what that covers. You return to ChatGPT with Axiom connected.

3. Finish setup

If you skipped the card and address step, open app.useaxiom.ai/setup to add them and review your spending rules. Axiom charges your card at the moment of each order. If you ask ChatGPT to order something before setup is finished, it sends you the same page and holds the order for 24 hours; say "done" when you're finished and ChatGPT continues with your order.

4. Verify the connection

Ask ChatGPT:

Check my Axiom payment method.

If setup was successful, ChatGPT will call the get_payment_method tool and return the card on file (brand and last 4 digits) and whether your account is ready to order.

To disconnect later, remove Axiom from ChatGPT's connected apps settings. This immediately ends its access.

Claude Desktop connects to Axiom directly, no extra tools needed. OAuth is handled natively.

1. Add Axiom as a connector

Open Claude Desktop and go to Settings > Connectors > Add, then enter:

https://mcp.useaxiom.ai/mcp

Alternatively, add it to your MCP configuration:

{
  "mcpServers": {
    "axiom": {
      "url": "https://mcp.useaxiom.ai/mcp"
    }
  }
}

2. Authenticate

The first time you use an Axiom tool, Claude Desktop will open a browser window to sign in. Sign in with your Axiom account (or create one and confirm your email), then allow Claude to place orders for you. The connection completes automatically.

3. Verify the connection

Ask Claude:

Check my Axiom payment method.

If setup was successful, Claude will call the get_payment_method tool and return the card on file (brand and last 4 digits) and whether your account is ready to order.

Optional: Add the Axiom Wallet skill

For guided purchase workflows that make the most of Axiom's server-managed checkout, add the Axiom Wallet skill:

  1. Download axiom-wallet.zip and unzip it.
  2. Go to claude.ai/customize/skills and upload the claude folder.

OpenClaw connects to Axiom via mcporter, which handles the OAuth token lifecycle so your agent only gets access to the MCP tools.

Before you start, your agent needs:

  • mcporter ≥0.8.0 on its PATH (check with mcporter --version). This should already be available on your OpenClaw instance; if not, see mcporter for installation instructions.
  • A headless browser CLI so the agent can read the activation URL from the rendered OAuth page. Either works:
    • Recommended: agent-browser (Rust native, fast, no Python needed): npm install -g agent-browser && agent-browser install
    • Alternative: browser-use (Python): uv add browser-use

1. Install the Axiom Wallet skill

Tell your agent:

Set up Axiom Wallet by following the guide at docs.useaxiom.ai

Your agent will read the docs and walk through the setup process. The skill is also available directly on ClawHub.

2. Authenticate

Your agent registers Axiom and starts the auth flow:

mcporter config add axiom --url https://mcp.useaxiom.ai/mcp
mcporter auth axiom --reset --oauth-timeout 300000 --log-level info

mcporter prints the OAuth authorize URL in its log output. Your agent opens it with the headless browser (agent-browser open "<URL>") and reads the activation URL off the rendered page. These are different URLs: the agent navigates to the authorize URL, and only the activation URL is for you.

Your agent then sends you the activation URL with a message like: To connect Axiom Wallet, open this link on your phone and approve access: [URL]

3. Approve access on your phone

Open the link your agent sent you. Sign in to Axiom if prompted, then allow OpenClaw to place orders for you. mcporter completes the OAuth exchange automatically once you allow it.

4. Verify the connection

Tell your agent:

Check my Axiom payment method.

If setup was successful, the agent will call the get_payment_method tool and return the card on file (brand and last 4 digits) and whether your account is ready to order.


What's Next

Once connected, your agent has access to the MCP tools covered by the permissions you allowed. See Scopes for details on what each permission covers, and How It Works for the full architecture.

On this page