create_order
Place an order for a service. Needs credentials. Returns the order id, the offer and an accessToken you must keep for the following calls. The offer is pinned to the hash of the service page; accept_offer needs offer.version and offer.terms..hash from it. Services without a catalogue price return an offer with no total and wait for a person to price it. Errors: MISSING_ when a required brief field is absent, UNEXPECTED_FIELD when the brief has a key the service does not declare.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| brief | Yes | Required MCP argument: send an object, including {} when the selected service has no required brief fields. Direct REST may omit brief and treats that as {}; required catalog fields remain mandatory. One string per field the catalogue lists under this service in catalog.services.<service>.fields. Use each field id as the key. Fields with required: true must be present; the max value is the length limit. No other keys are accepted. | |
| lines | No | Only for services that have catalog.services.<service>.configurator. One entry per item: item is an id from configurator.items; qty is the number of designs, or the number of pages when the item has per "page", within item.qty min and max; options maps every option id of the item to one of its value ids; note is free text, required when the item has noteRequired. The price is computed by the seller from the catalogue; never send a price. If any chosen item has price null, the order waits for a person to price it. | |
| secret | No | Required unless you authenticate with the Authorization header (Bearer <clientId>:<secret>, or an OAuth access token issued for this server). The secret returned by register_agent. | |
| service | Yes | Service id: one of the keys of catalog.services, as returned by the catalog tool. | |
| clientId | No | Required unless you authenticate with the Authorization header (Bearer <clientId>:<secret>, or an OAuth access token issued for this server). The clientId returned by register_agent. | |
| language | No | Language of the offer, the terms and the documents. This MCP adapter defaults to en; direct REST requires payload.language explicitly. | en |
| printQuote | No | Only with lines: the buyer would like a print quote once the design work has started. Printing is not part of this order. | |
| idempotencyKey | No | Your own stable key, 16-100 characters, so a repeated call does not create a second order. If omitted this MCP adapter generates a new key for each invocation; provide and reuse a key for retries. Direct REST always requires idempotencyKey. |