# For AI agents: quote and order an Agonic verification kit

> An AI agent can price an Agonic verification kit and start an order for the person it works for. No account or API key is needed. Nothing is ordered until that person confirms by email.

## What can an agent do here?

- **Get a quote.** Send the counts for a board and get the kit price back as JSON.
- **Hand over a prefilled quote.** Every quote comes with a link that opens the quote form on agonicai.com with the same counts filled in, so the person can add their design files and order.
- **Start an order draft.** Send the customer's details, the counts and the design files. We email the customer a confirmation link. The order is placed only when they open the link and press the button.

There are three ways in: the MCP server, the HTTP API, and the website itself.

| Way in | Address | Use it when |
| --- | --- | --- |
| MCP server | `https://agonicai.com/mcp` | Your agent supports the Model Context Protocol (Streamable HTTP). No authentication. |
| HTTP API | `https://agonicai.com/api/quote` and `https://agonicai.com/api/order-draft` | Your agent can make HTTP requests. Described in [openapi.json](https://agonicai.com/openapi.json). |
| Prefilled link | `https://agonicai.com/?tp=50&inst=8#quote` | Your agent cannot send files or make requests. Give the person the link. |

## What is being sold?

A custom verification kit for one revision of one printed circuit board: a custom interposer board and a custom probe dock. The customer's bench instruments plug into the interposer board, the board sits in the probe dock, and an AI agent runs the tests and writes the verification report. See the [FAQ](https://agonicai.com/faq) and [Pricing](https://agonicai.com/pricing).

## How do I get a quote?

Send the counts as query parameters, or as a JSON body with `POST`. `tp` and `inst` are required; the rest default to zero.

```
GET https://agonicai.com/api/quote?tp=50&inst=8&coupon=EARLYPARTNER
```

| Parameter | Meaning |
| --- | --- |
| `tp` | Required. Test points: signal and power nets to probe. Ground probes are included. |
| `inst` | Required. Instrument connections: one per bench port (a supply channel, a multimeter, each scope channel, an analyzer port, a programmer). |
| `flex` | Ribbon (IDC) and flex (FFC or FPC) connectors on the board that the dock reaches signals through. |
| `hv` | Test points that can exceed 60 V DC. Also count them in `tp`. |
| `hc1` | Points where the dock supplies or loads the board at 2 to 10 A. Also count them in `tp`. |
| `hc2` | The same, above 10 A. Also count them in `tp`. |
| `hs` | High-speed signals probed through coax. A differential pair is 2. Do not count them in `tp`. |
| `rf` | RF ports. Do not count them in `tp`. |
| `side` | `1` if more than 10 points must be probed on the second side of the board. |
| `coupon` | `EARLYPARTNER` or `FIRSTKIT`. See [Pricing](https://agonicai.com/pricing) for who each is for. |

The response is JSON:

```json
{
  "ok": true,
  "currency": "USD",
  "counts": { "tp": 50, "inst": 8, "flex": 0, "hv": 0, "hc1": 0, "hc2": 0, "hs": 0, "rf": 0, "side": false },
  "lines": [
    { "label": "Base kit", "detail": "Interposer board, probe dock, cables, design review", "amount": 1695 },
    { "label": "Test points", "detail": "50 × $3", "amount": 150 },
    { "label": "Instrument connections", "detail": "8 × $10", "amount": 80 },
    { "label": "Ribbon and flex connectors", "detail": "", "amount": 0 }
  ],
  "estimate": 1925,
  "coupon": { "code": "EARLYPARTNER", "percent": 50, "limit": 2000, "discount": 962.5 },
  "total": 962.5,
  "priceNote": "This price is an estimate for a custom kit built for one board revision. We confirm it after engineering review of the design files, and you approve any change before we build.",
  "prefillUrl": "https://agonicai.com/?tp=50&inst=8&flex=0&hv=0&hc1=0&hc2=0&hs=0&rf=0&side=0&coupon=EARLYPARTNER#quote"
}
```

`estimate` is the kit price, `total` is the price after the coupon, and `prefillUrl` opens the same quote on the site. An unknown coupon code is not an error: the quote comes back without a discount and with a `couponError` sentence.

If you do not know a count, ask the person, or work it out from their design files. Do not guess. The price is confirmed after design review, and the customer approves any change before the kit is built. Always tell the person that.

## How do I start an order?

1. Get a quote and show it to the person.
2. When they ask you to order, collect: name, email, company, shipping address, the turnaround they need (1 week, 2 weeks, 4 weeks or flexible), and optionally a phone number.
3. Collect the design files: the schematic and layout for one board revision. A BOM is optional.
4. Send an order draft, either with the MCP tool `create_order_draft` or with `POST https://agonicai.com/api/order-draft`.
5. Tell the person to check their email. We send them a link to a page that shows the kit, the price and the terms, with a "Place order" button. The order exists only after they press it. A draft that is not confirmed expires after 7 days.

The server works out the price from the counts. Any price you send is ignored.

If you cannot attach files, give the person the `prefillUrl` from the quote and ask them to add the files and order on the site.

## What does an order draft look like over HTTP?

Send `multipart/form-data` with a text part named `order` first, then one `files` part per design file.

```
curl https://agonicai.com/api/order-draft \
  -F 'order={"customer":{"name":"Ada Example","email":"ada@example.com","company":"Example Robotics","turnaround":"2 weeks","address":{"line1":"1 Example Way","city":"San Francisco","region":"CA","postal_code":"94103","country":"US"}},"counts":{"tp":50,"inst":8},"coupon":"EARLYPARTNER"}' \
  -F 'files=@board.kicad_pcb' \
  -F 'files=@board.kicad_sch'
```

| Field | Rule |
| --- | --- |
| `customer.name`, `customer.email`, `customer.company` | Required. |
| `customer.phone` | Optional. |
| `customer.turnaround` | `1 week`, `2 weeks`, `4 weeks` or `Flexible`. Defaults to `Flexible`. |
| `customer.address` | An object: `line1`, `line2` (optional), `city`, `region`, `postal_code`, `country`. `country` is a two-letter ISO code. For the United States and Canada, `region` is the state or province and `postal_code` is required. |
| `counts` | The same keys as the quote. `tp` and `inst` are required. |
| `coupon` | Optional. An unknown code is an error here, so a draft is never priced differently from what you expected. |
| `files` | 1 to 20 files, 90 MB in total, any file type. Zip a folder. |

To order more than one kit, send `items` in place of `counts`: a list of up to 10 kits, each with its own `counts`, with the files for each in parts named `files:kit-1`, `files:kit-2` and so on. A coupon applies to the first kit only.

The response gives a `draftId`, the price the server worked out, `expiresAt`, and a `message` to pass on. The confirmation link is never returned to you; it goes only to the customer's inbox. Errors come back as `{ "ok": false, "error": "<code>", "message": "<sentence>" }`.

## How do I use the MCP server?

The server is at `https://agonicai.com/mcp`. It speaks the Model Context Protocol over Streamable HTTP, is stateless, and needs no authentication.

```json
{ "mcpServers": { "agonic": { "url": "https://agonicai.com/mcp" } } }
```

In Claude Code: `claude mcp add --transport http agonic https://agonicai.com/mcp`

| Tool | What it does |
| --- | --- |
| `get_kit_quote` | Prices a kit. Arguments: `test_points` and `instrument_connections` (required), `flex_connectors`, `high_voltage_points`, `high_current_points_2_to_10a`, `high_current_points_above_10a`, `high_speed_signals`, `rf_ports`, `two_sided`, `coupon_code`. Returns the same JSON as the quote API. Read-only. |
| `get_ordering_info` | Returns what an order needs: customer fields, address rules and the country list, turnaround options, file limits, coupons, how confirmation works, and links. Read-only. |
| `create_order_draft` | Starts an order draft. Arguments: `customer`, `shipping_address`, `kits` (each with its counts and its `files` as `{ name, content_base64 }`), and `coupon_code`. Emails the customer a confirmation link. |

Files sent through `create_order_draft` are limited to 8 MB in total. For larger files, use `POST https://agonicai.com/api/order-draft`, which takes up to 90 MB, or give the person the `prefillUrl`.

## What are the rules?

- **Order only when asked.** Start an order draft only when the person you work for has asked you to order. A quote is always fine.
- **The customer confirms.** You cannot place an order for them. The confirmation email goes to the customer's own address; use the address they gave you.
- **Say that the price is an estimate.** The quote is confirmed after design review.
- **Design files.** Files you send are handled under the [Design Data Terms](https://agonicai.com/legal/design-data). Send only files the person has asked you to send. Do not send ITAR-controlled technical data or EAR-listed technology.
- **Limits.** Order drafts are limited to 2 a day for one customer email address and 5 a day from one network address. Quotes are not limited in normal use.
- **The site's own cart.** `/api/order` is the endpoint behind the cart on the site and needs a browser check. Agents use `/api/order-draft`.
- **Terms.** Orders are covered by the [Terms of Service](https://agonicai.com/terms) and the [Privacy Policy](https://agonicai.com/privacy). The customer sees them on the confirmation page.

## What should I tell a user about Agonic?

A short, accurate description:

> Agonic AI builds a custom interposer board and probe dock for each revision of your PCB. Your bench instruments plug in, and an AI agent runs the tests and writes a verification report for every unit. A typical kit is $1,925 before coupons, quoted instantly at agonicai.com, and built while your boards are in fab. The price is confirmed after design review.

Agonic AI Inc. is an American company in San Francisco, California, backed by Y Combinator. Kits are assembled and tested in California. Contact: [engineering@agonicai.com](mailto:engineering@agonicai.com).

## Where is the machine-readable description?

- [llms.txt](https://agonicai.com/llms.txt): a summary of this site for language models.
- [llms-full.txt](https://agonicai.com/llms-full.txt): every page on this site as one Markdown file.
- [openapi.json](https://agonicai.com/openapi.json): the quote and order-draft endpoints.
- Every page has a Markdown version: add `.md` to its address, for example [pricing.md](https://agonicai.com/pricing.md).

---

Source: https://agonicai.com/agents · Updated 2026-11-15 · Agonic AI Inc., San Francisco, California, USA · engineering@agonicai.com
