Quickstart

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

Prerequisites

Before you start, make sure you have:

An Axiom account with a linked payment method — sign up at the Axiom dashboard and complete onboarding.
An AI agent that supports MCP (e.g. Claude Desktop, OpenClaw).

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"
    }
  }
}

The first time you use an Axiom tool, Claude Desktop will open a browser window to sign in. Log in with your Axiom account and approve the requested permissions. The connection completes automatically after approval.

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 your linked payment method.

Optional: Add the Axiom Wallet skill

For richer purchase workflows and detailed receipt formatting, add the Axiom Wallet skill:

Download axiom-wallet.zip and unzip it.
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 — follow 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

Tell your agent to run:

mcporter auth https://mcp.useaxiom.ai/mcp --browser none --oauth-timeout 300000

The page will display an activation URL. Your agent sends it to you 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 review and approve the requested permissions. The browser page auto-detects your approval and completes the OAuth exchange.

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 your linked payment method.

What's Next

Once connected, your agent has access to the MCP tools based on the scopes you approved. See Scopes for details on what each permission grants, and How It Works for the full architecture.

On this page