Quickstart

This quickstart gets you onto the e-money rail: a EURO account wired into your agent via MCP. It’s the fastest working payment and the foundation for everything else — the x402 schemes and the on-chain rails build on the same account. (Full setup guide, including stablecoin wallets.)

1. Create an API key

   Don’t have an account yet? Follow the sign up guide first.

   Log in to the Quantoz portal and navigate to API Keys → New key. Give it a label (e.g. my-first-agent) and copy the key.

2. Connect your client

   • Claude — follow the Connect to Claude guide to add it as a connector in two clicks.
   • Cursor / Windsurf / Claude Code — add this block to your MCP settings file:

   {
     "mcpServers": {
       "quantoz-euro": {
         "type": "http",
         "url": "https://mcp.ai.quantozpay.com/mcp",
         "headers": {
           "X-API-KEY": "YOUR_API_KEY_HERE"
         }
       }
     }
   }

   • OpenAI Agents SDK — connect via MCP in Python:

   from agents import Agent, MCPServerStreamableHttp
   
   euro = MCPServerStreamableHttp(
       url="https://mcp.ai.quantozpay.com/mcp",
       headers={"X-API-KEY": "YOUR_API_KEY_HERE"},
   )
   
   agent = Agent(name="payment-agent", mcp_servers=[euro])

3. Fund your wallet

   Open the Quantoz app and top up your wallet via bank transfer. The balance in your wallet is what your agent can spend.

4. Make your first payment

   Ask your agent:

   “What’s my EURO balance?”

   Then:

   “Send €5 to ACC_XXXX with the message ‘test payment’”

   That’s it. Your agent just made a euro payment.

API key security

The preferred way to connect is via the Claude connector — your API key is never stored in a config file and the authorization flow is handled securely in the browser.

If you’re connecting via a config file (Cursor, Windsurf, Claude Code), keep the following in mind:

• The wallet balance is your real protection — someone with your key can only spend what’s in the wallet. Keep a balance that matches what you actually need.
• Give each key a descriptive label so you know which agent uses it
• Rotate keys regularly in the portal and revoke the old one after replacing it
• Never commit the config file to git

Available tools

Once connected, your agent has access to 37 tools covering:

• Payments — send money, create payment requests
• Accounts — list and manage EURO accounts
• Funding — top up via bank transfer
• Collection Requests — collect money via SEPA
• Profile & KYC — profile info and limits

Next: pay x402-protected APIs

The same account lets your agent pay machine-to-machine over HTTP 402 — including on-chain merchants:

import { withEurPayment } from "x402-quantoz-euro";

const fetch = withEurPayment(globalThis.fetch, {
  apiKey: process.env.QUANTOZ_API_KEY,
  fromAccount: process.env.QUANTOZ_ACCOUNT,
});

// 402 challenges are paid automatically in EURO (off-chain);
// add evm: { privateKey } to also pay EURQ/USDQ merchants on-chain
const res = await fetch("https://merchant.example.com/premium-resource");

→ Agent developer guide for the full flow, including paying with self-custody EURQ/USDQ on Ethereum/Polygon. → Merchant guide to accept these payments yourself.