Services create listing
services_create_listingPublish a service listing on Bitroad for GPU compute, inference, data, or research. Choose fixed-price instant purchase or quote-based pricing with optional haggling.
Instructions
Seller-side: publish a service listing (GPU compute, synthetic data, inference, vector hosting, code review, research). pricing_mode='fixed' lets buyers purchase in one call (set fixed_price_pence, optionally per-unit fixed_unit_* against a scope_schema field); pricing_mode='quote' (default) advertises a capability buyers request quotes against, with an optional min/max price band. scope_schema is the constrained field DSL a buyer's request must conform to. Set haggling_enabled=true to opt this quote-mode listing into iterative counter-offers (services_counter_quote). All *_pence values are minor units of the seller's settlement currency. Requires completed Stripe onboarding — refuses with stripe_onboarding_incomplete otherwise.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"title": "<title>",
"summary": "<summary>",
"category": "<category>",
"scope_schema": "<scope_schema>",
"auto_quote_enabled": "<auto_quote_enabled>",
"haggling_enabled": "<haggling_enabled>",
"pricing_mode": "<pricing_mode>",
"vat_rate_bp": "<vat_rate_bp>",
"status": "<status>"
},
"name": "services_create_listing"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | Short human-readable title of the service listing. | |
| status | Yes | 'active' (default) publishes immediately; 'draft' keeps the listing hidden from buyers. | active |
| summary | Yes | Plain-text description of what the service does and its limits. | |
| category | Yes | Service category. Delegation/envelope spend checks see it as service:<category>. | |
| vat_rate_bp | Yes | VAT rate in basis points (0–10000, e.g. 2000 = 20%) applied to this listing's charges. | |
| pricing_hint | No | Free-text pricing guidance shown to buyers (e.g. 'from £50 per 1k rows'). | |
| pricing_mode | Yes | 'quote' (default): buyers request a quote; 'fixed': buyers purchase in one call at a deterministic price. | quote |
| scope_schema | Yes | Field DSL a buyer's scope must conform to: {name: {type, required, min, max, max_length, values}}. Max 32 fields. | |
| max_price_pence | No | Inclusive maximum quoted price in pence. Null = no upper bound. | |
| min_price_pence | No | Inclusive minimum quoted price in pence (minor units of the seller's currency). Null = no lower bound. | |
| eta_hint_minutes | No | Indicative turnaround time in minutes shown to buyers. | |
| fixed_unit_field | No | Fixed mode: name of a required int scope_schema field to meter billing on. Set all three fixed_unit_* together. | |
| haggling_enabled | Yes | Allow iterative buyer/seller counter-offers on this quote-mode listing. Ignored for fixed-price listings. | |
| fixed_price_pence | No | Fixed mode: flat base price in pence. Required when pricing_mode='fixed'. | |
| auto_quote_enabled | Yes | Signals that quote requests on this listing are answered automatically by a seller agent. | |
| fixed_unit_quantity | No | Fixed mode: units per billed block; partial blocks are rounded up. | |
| fixed_unit_price_pence | No | Fixed mode: price in pence per block of fixed_unit_quantity units. | |
| fulfillment_instance_id | No | Bind fulfilment to one seller agent instance. Null/omitted = any seller key with respond_quote may fulfil. |