# getagent.market — instructions for AI agents

You are reading the machine onboarding for getagent.market, a marketplace where every
purchase runs through the Regent control plane (verified identity, owner-approved
budget, on-chain audit). Anonymous callers cannot buy governed listings.

## 1. Discover
- `GET https://get4agent.com/v1/listings?kind=api` — catalog (JSON). Each listing has `id`, `title`,
  `price`, `currency`, `seller_kya_status`.
- `GET https://get4agent.com/listings/{id}/jsonld` — schema.org Product JSON-LD.
- MCP server: `https://get4agent.com/mcp` (search + call tools over Model Context Protocol).

## 2. Choose a payment rail
`GET https://get4agent.com/protocols` lists the rails enabled on this deployment:
- **prepaid** (KZT ledger) — requires a Regent identity (below). Balance:
  `GET https://get4agent.com/v1/accounts/{agent_id}`.
- **x402** (stablecoin, per call) — standard HTTP 402 flow on
  `POST https://get4agent.com/v1/x402/call/{listing_id}`: first request returns 402 + payment
  requirements; retry with the `X-PAYMENT` header after signing.
  - **Governed x402**: include the same `X-Control-Key` / `X-Agent-Id` / `X-Agent-Intent`
    headers on the paid retry — the Regent gate then decides BEFORE settlement
    (deny = no funds move; the receipt carries `decision_id`).
  - **Wallet identity**: bind your payer wallet to your AgentID so every x402 payment
    carries verified identity. Sign the challenge
    `regent-wallet-bind:{org_id}:{agent_id}:{address}` (EIP-191, wallet key) and
    `POST https://api.regentprotocol.org/v1/organizations/{org_id}/wallet-bindings`
    with `{agent_id, address, signature}`. Listings with `x402_anonymous: false`
    reject unbound anonymous payers (`403 KYA_REQUIRED`, checked before settlement).

## 3. Governed calls (prepaid rail)
`POST https://get4agent.com/v1/call/{listing_id}` with JSON body `{"agent_id": "...", ...args}`
and YOUR OWN Regent credentials in headers:
- `X-Control-Key`: your `rgnt_ctrl_...` control key
- `X-Agent-Id`: your full Regent agent id
- `X-Agent-Intent`: one sentence — why you are making this call

Your owner must have approved a mandate for the agent (per-tx / daily / monthly budget).
Responses: `200` result + `decision_id` (audit reference) · `403` gate deny with a coded
reason (e.g. `MANDATE_LIMIT_EXCEEDED`) · `402` insufficient prepaid balance.

## 4. Get a Regent identity (one-time, requires a human owner)
A human registers at https://web.regentprotocol.org: create an agent (AgentID), issue a
control key, request a mandate (the owner approves it by email). Humans can also sign in
on https://get4agent.com directly.

Never send provider API keys or your control key to any endpoint other than this host's
`/v1/call`. This marketplace never asks for your owner's credentials.