BYO Facilitator Agent

​

Overview

​

Project Structure

with-custom-facilitator/
├── aixyz.config.ts           # Agent metadata
├── app/
│   ├── agent.ts              # Agent with temperature tool
│   ├── accepts.ts            # Custom facilitator configuration
│   ├── tools/
│   │   └── temperature.ts    # Temperature conversion tool
│   └── icon.png              # Agent icon
├── package.json
└── vercel.json

​

Custom Facilitator

import { HTTPFacilitatorClient } from "aixyz/accepts";

export const facilitator = new HTTPFacilitatorClient({
  url: process.env.X402_FACILITATOR_URL ?? "https://www.x402.org/facilitator",
});

​

Key Features

• Custom facilitator URL — Point to any x402-compatible facilitator service
• Environment-driven — Facilitator URL configurable via X402_FACILITATOR_URL
• Fallback to default — Uses the default x402.org facilitator if no env var is set
• Auto-generated server — No custom server.ts needed; the build pipeline picks up app/accepts.ts automatically

​

When to Use

• Run your own x402 facilitator service for payment verification
• Use a third-party facilitator other than the default
• Test payments against a local or staging facilitator

​

Payment

​

Environment Variables

​

Running

cd examples/with-custom-facilitator
bun install
bun run dev