agent-ready

The agent-ready wholesale marketplace.

For AI agents and autonomous purchasing systems that need product catalogue, ordering, invoice, and delivery data in predictable formats.

Open OpenAPI Read llms.txt

agent discovery

{
  "name": "CatalogHub",
  "capabilities": [
    "catalog.search",
    "supplier.discover",
    "basket.create",
    "order.submit",
    "invoice.query"
  ],
  "resources": {
    "llms": "/llms.txt",
    "openapi": "/openapi.json",
    "mcp": "/mcp"
  }
}

Available capabilities

Search products

Discover suppliers

Compare prices

Check availability

Read nutritional data

Read allergens

Create baskets

Submit orders

Query invoices

Query deliveries

Draft surface: availability depends on workspace permissions and product rollout.

Authentication

OAuth2

API Keys

Documentation

REST API

Rate limits

Errors

Webhooks

Protocol Surfaces

OpenAPI 3.1

MCP descriptor

JSON Schemas

Agent manifest

Endpoint examples

Copy/paste requests with inline JSON responses.

Search Products

GET /v1/catalog/search

draft

Request

curl "https://api.cataloghub.example/v1/catalog/search?q=olive%20oil&include=allergens,nutrition" \
  -H "Authorization: Bearer ch_api_YOUR_KEY" \
  -H "Accept: application/json"

Response

{
  "data": [
    {
      "id": "ch_prod_8f2a",
      "name": "Extra Virgin Olive Oil",
      "supplier": {
        "id": "ch_sup_19",
        "name": "Mediterra Wholesale"
      },
      "pack": "12 x 1L",
      "availability": "in_stock",
      "allergens": [],
      "nutrition": {
        "energy_kcal_per_100ml": 824
      }
    }
  ]
}

Create Basket

POST /v1/baskets

draft

Request

curl -X POST "https://api.cataloghub.example/v1/baskets" \
  -H "Authorization: Bearer ch_api_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "restaurant_id": "ch_rest_42",
    "items": [
      { "product_id": "ch_prod_8f2a", "quantity": 3 }
    ]
  }'

Response

{
  "basket_id": "ch_basket_91m",
  "status": "draft",
  "currency": "GBP",
  "totals": {
    "net": 144.75,
    "tax": 28.95,
    "gross": 173.70
  }
}

Machine-readable resources

No searching required.

/robots.txtCrawler and discovery hints /llms.txtOverview for language models /openapi.jsonOpenAPI 3.1 JSON /openapi.yamlOpenAPI 3.1 YAML /mcpMCP server descriptor /.well-known/agent.jsonAgent capability manifest /.well-known/cataloghub-agent.jsonCatalogHub manifest alias /agent/skill.mdAgent skill instructions