---
title: "Generate a free machine-readable Agent Buyer Card"
method: POST
path: "/api/tools/agent-buyer-card"
---

# Generate a free machine-readable Agent Buyer Card

`POST /api/tools/agent-buyer-card`

## Request

- Base URL: `https://ontarioprotocol.com`
- URL: `https://ontarioprotocol.com/api/tools/agent-buyer-card`
- Auth: none required

Formats provider-supplied public metadata into use-when, do-not-use, input, output, price, preflight, evidence, and fallback fields. It does not fetch the endpoint, call a tool, authorize or settle payment, collect credentials, or guarantee demand.

## Request body

- object
  - `endpoint` string, uri, required: Public HTTPS endpoint. Query strings are removed from output.
  - `evidence_url` string, uri
  - `fallback` string
  - `inputs` union
    - string
    - string[]
  - `job` string, required: Exact job for which an agent should select this tool.
  - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'
  - `name` string, required
  - `network` string, required
  - `not_for` string: A provider-specific task boundary for which the agent should not select this tool.
  - `output` string, required: Structured result returned after successful payment.
  - `preflight_url` string, uri
  - `price_usdc` string, required

## Response `200`

Buyer-legibility score, generated copy, and machine-readable card

## Other responses

- `400`: Invalid or incomplete public metadata

---

[API](https://skmtc.dev/ontarioprotocol/apis/ontario-protocol-x402-api.md) - [All operations](https://skmtc.dev/ontarioprotocol/apis/ontario-protocol-x402-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ontarioprotocol/apis/ontario-protocol-x402-api/revisions/c4bb7fd32b2f?raw)