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

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.net/ontarioprotocol/apis/ontario-protocol-x402-api.md) · [All operations](https://skmtc.net/ontarioprotocol/apis/ontario-protocol-x402-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ontarioprotocol/ontario-protocol-x402-api/revisions/54384a1c4bf3/schema)