AxonGate Quickstart

Turn a public URL into clean RAG-ready markdown or a citation-backed Proof Pack 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. Starter costs 0.012 USDC; fresh costs 0.03 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. Sell proofUse /proof-pack when a buyer needs cited claims instead of raw markdown.

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 Starter Path

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

Expected Shape

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

MCP Agent Path

Add the server to an MCP-capable client, then call the probe tool first. Paid tools refuse to run unless the confirmed spend matches the selected tier or pack price.

Client Config

{
  "mcpServers": {
    "axongate": {
      "command": "node",
      "args": [
        "C:/path/to/AxonGate-Vault/examples/axongate_mcp.mjs"
      ],
      "env": {
        "AXONGATE_BASE_URL": "https://api.axongate.one",
        "AXONGATE_WALLET_FILE": "C:/path/to/burner_wallet.json",
        "AXONGATE_CONFIRM_SPEND": "0.012",
        "AXONGATE_PROOF_CONFIRM_SPEND": "0.10"
      }
    }
  }
}

Probe Tool

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

Paid Tool

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

Proof Pack Tool

Tool: fetch_proof_pack
Input:
{
  "target_url": "https://www.iana.org/domains/reserved",
  "question": "What does this source establish about reserved domains?",
  "pack": "quick",
  "force_refresh": false,
  "confirm_spend_usdc": "0.10",
  "source": "quickstart-mcp-proof",
  "max_answer_chars": 1800,
  "max_citation_excerpt_chars": 360
}

Pricing

Tier	Price	Best For
`starter`	0.012 USDC	First paid conversion using the starter sample or existing cache
`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