> ## Documentation Index
> Fetch the complete documentation index at: https://aixyz.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# BYO Facilitator Agent

> Template demonstrating a custom x402 payment facilitator

<Info>
  **Source:**
  [`examples/with-custom-facilitator`](https://github.com/AgentlyHQ/aixyz/tree/main/examples/with-custom-facilitator)
</Info>

## Overview

This template demonstrates how to bring your own x402 payment facilitator by providing an `app/accepts.ts` file. Instead of using the default facilitator at `x402.org`, you can point to a custom facilitator URL for payment verification.

## 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

The `app/accepts.ts` file configures a custom payment facilitator:

```typescript title="app/accepts.ts" theme={null}
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

Use a custom facilitator when you need to:

* 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

The agent charges `$0.005` per request via x402 on Base Sepolia.

## Environment Variables

| Variable               | Description                                   |
| ---------------------- | --------------------------------------------- |
| `OPENAI_API_KEY`       | OpenAI API key                                |
| `X402_FACILITATOR_URL` | Custom facilitator URL (defaults to x402.org) |

## Running

```bash theme={null}
cd examples/with-custom-facilitator
bun install
bun run dev
```