AxonGate Quickstart

Turn a public URL into clean RAG-ready markdown with one paid x402 call. Use the terminal buyer for a direct smoke test, or attach the MCP server so an agent can call AxonGate as a tool.

1. Fund burner walletUse Base USDC. Fresh costs 0.03 USDC; cached costs 0.015 USDC.

2. Run the buyerThe script probes payment terms, signs x402, pays, and returns markdown.

3. Watch attributionUse source=quickstart so `/metrics` shows the conversion path.

4. Add MCPLet an agent call fetch_clean_context with explicit spend confirmation.

This can spend real USDC. Every paid path requires an explicit confirm-spend or confirm_spend_usdc value that must match the selected tier.

Fast Terminal Path

npm install
npm run paid:buyer -- \
  --wallet-file "C:/path/to/burner_wallet.json" \
  --target-url "https://www.iana.org/domains/reserved" \
  --tier fresh \
  --force-refresh \
  --confirm-spend 0.03 \
  --source quickstart

Expected Shape

PAID
{
  "http_status": 200,
  "status": "success",
  "target_url": "https://www.iana.org/domains/reserved",
  "tier": "fresh",
  "markdown_chars": 1000,
  "payment": {
    "mode": "x402-facilitator",
    "amount_usdc": 0.03,
    "source": "quickstart"
  }
}

MCP Agent Path

Add the server to an MCP-capable client, then call the probe tool first. The paid tool refuses to run unless the confirmed spend matches the selected tier price.

Client Config

{
  "mcpServers": {
    "axongate": {
      "command": "node",
      "args": [
        "C:/path/to/AxonGate-Vault/examples/axongate_mcp.mjs"
      ],
      "env": {
        "AXONGATE_BASE_URL": "https://web-production-8136ee.up.railway.app",
        "AXONGATE_WALLET_FILE": "C:/path/to/burner_wallet.json",
        "AXONGATE_CONFIRM_SPEND": "0.03"
      }
    }
  }
}

Probe Tool

Tool: probe_payment_terms
Input:
{
  "tier": "fresh",
  "source": "quickstart-mcp"
}

Paid Tool

Tool: fetch_clean_context
Input:
{
  "target_url": "https://www.iana.org/domains/reserved",
  "tier": "fresh",
  "force_refresh": true,
  "confirm_spend_usdc": "0.03",
  "source": "quickstart-mcp",
  "max_markdown_chars": 12000
}

Pricing

Tier	Price	Best For
`cached`	0.015 USDC	Repeat reads when AxonGate already has a cached copy
`basic`	0.02 USDC	Cache-friendly production calls
`fresh`	0.03 USDC	Current public web context and first real tests
`deep`	0.05 USDC	Higher-value calls with a short cache window