Quickstart

This guide walks you through connecting your AI agent (like OpenClaw) to Axiom using mcporter, the recommended way to authenticate MCP connections.

Prerequisites

Before you start, make sure you have:

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

Setup with mcporter (Recommended)

mcporter handles the OAuth token lifecycle so your agent only gets access to the MCP tools — not your Axiom dashboard.

mcporter should already be available on your OpenClaw instance. If not, see mcporter for installation instructions.

1. Install the Axiom Wallet skill

Tell your agent:

"Install the Axiom Wallet skill"

Your agent will download and register the skill automatically. You can also find it on ClawHub.

2. Tell your agent to authenticate

Send your agent this instruction via your messaging app:

"Authenticate with Axiom Wallet by running: npx mcporter auth https://mcp.useaxiom.ai/mcp"

3. Approve access on your phone

Here's what happens during authentication:

mcporter opens a browser to the Axiom OAuth login page.
Your agent clicks "Sign in on another device" on the login page.
The page displays 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]"
Open the link on your phone. 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. mcporter receives the token.

4. Add Axiom to MCP config

Your agent needs Axiom in its MCP server configuration:

{
  "mcpServers": {
    "axiom": {
      "command": "mcporter",
      "args": ["https://mcp.useaxiom.ai/mcp"]
    }
  }
}

You can tell your agent to add this, or configure it manually in the agent's settings.

5. Verify the connection

Tell your agent:

"Check my Axiom balance."

If setup was successful, the agent will call the get_balance tool and return your current wallet balance.

Advanced: Direct MCP Connection

If you prefer not to use mcporter, your agent can connect to the MCP server directly and handle the OAuth2 flow itself. This requires the agent to manage the browser-based OAuth flow, including the cross-device authentication pattern.

Add Axiom as a direct MCP server:

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

The agent must support OAuth 2.0 with PKCE (auto-discovered via /.well-known/oauth-authorization-server). During the OAuth flow, the agent should click "Sign in on another device" on the login page, extract the activation URL, and send it to you for approval — the same cross-device pattern described above.

See the cross-device auth reference for detailed technical instructions.

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