readycounter.vercel.app

{
  "name": "search_catalog",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search the store catalog by query, category, max_price, or in_stock_only. Returns structured product records for agent discovery.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Free-text search."
      },
      "category": {
        "type": "string",
        "enum": [
          "beans",
          "kits",
          "equipment",
          "beverages",
          "merch",
          "subscription",
          "powder"
        ]
      },
      "max_price": {
        "type": "number",
        "minimum": 0
      },
      "in_stock_only": {
        "type": "boolean"
      }
    },
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_product",
  "kind": "answer",
  "impl": "imperative",
  "description": "Return full structured product details by SKU id.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "description": "Product SKU id. `product_id` and `sku` are accepted too."
      }
    },
    "required": [
      "id"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "add_to_order",
  "kind": "transact",
  "impl": "imperative",
  "description": "Add a product to the shared co-shop order. Human and agent see the same order. Does not complete checkout.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "product_id": {
        "type": "string",
        "description": "Product SKU id, as returned by search_catalog. `id` and `sku` are accepted too."
      },
      "quantity": {
        "type": "integer",
        "minimum": 1,
        "maximum": 99,
        "default": 1
      }
    },
    "required": [
      "product_id"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "update_line_quantity",
  "kind": "act",
  "impl": "imperative",
  "description": "Update quantity on an existing order line in the shared co-shop order.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "line_id": {
        "type": "string"
      },
      "quantity": {
        "type": "integer",
        "minimum": 0,
        "maximum": 99
      }
    },
    "required": [
      "line_id",
      "quantity"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "remove_line",
  "kind": "act",
  "impl": "imperative",
  "description": "Remove a line from the shared co-shop order.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "line_id": {
        "type": "string"
      }
    },
    "required": [
      "line_id"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_order",
  "kind": "answer",
  "impl": "imperative",
  "description": "Return the current shared order: lines, quantities, subtotal. Same state the human sees.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_delivery_quote",
  "kind": "answer",
  "impl": "imperative",
  "description": "Return shipping quote for the current order. Read-only.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "prepare_checkout",
  "kind": "transact",
  "impl": "imperative",
  "description": "Validate the order for checkout. Returns blocked if merchant config prevents agent checkout (e.g. CAPTCHA). Human must complete payment in UI.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_readiness_score",
  "kind": "answer",
  "impl": "imperative",
  "description": "Return merchant agent-readiness score /100 and per-check breakdown for the active store.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_merchant_config",
  "kind": "answer",
  "impl": "imperative",
  "description": "Return active merchant checkout flags (CAPTCHA, account required) and store metadata.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "create_coshop_room",
  "kind": "act",
  "impl": "imperative",
  "description": "Create a live API-backed co-shop room. Returns roomId and share URL — human and agent sync via /api/v1/rooms (deployed).",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "export_shopify_catalog",
  "kind": "act",
  "impl": "imperative",
  "description": "Export active store catalog as Shopify Catalog JSON for agent feeds and partner integrations.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "validate_catalog_feed",
  "kind": "act",
  "impl": "imperative",
  "description": "Validate Shopify-shaped catalog feed for agent readiness (GTIN, variants, prices).",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "apply_readiness_fix",
  "kind": "act",
  "impl": "imperative",
  "description": "Autopilot: apply a readiness fix — disable_captcha, disable_account_wall, or sync_feed_prices. Returns score before/after.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "fix": {
        "type": "string",
        "enum": [
          "disable_captcha",
          "disable_account_wall",
          "sync_feed_prices"
        ]
      }
    },
    "required": [
      "fix"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "simulate_agent_journey",
  "kind": "act",
  "impl": "imperative",
  "description": "Simulate full agent path: search → get_product → add_to_order → get_order → prepare_checkout. Returns per-step pass/fail.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "import_shopify_catalog",
  "kind": "act",
  "impl": "imperative",
  "description": "Import Shopify Catalog JSON as a new store. Persists in browser; switches to imported store.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "feed": {
        "type": "object",
        "description": "Shopify Catalog export JSON"
      },
      "store_id": {
        "type": "string"
      },
      "store_name": {
        "type": "string"
      }
    },
    "required": [
      "feed"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_field_companion",
  "kind": "answer",
  "impl": "imperative",
  "description": "Field companion handbook: pressing agent-commerce issues, merchant checklist, research briefs (R1–R6), protocol cheatsheet. Optional topic filter.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topic": {
        "type": "string",
        "description": "all | issues | checklist | research | protocols | issue id (e.g. gtin-gap) | rank number"
      }
    },
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "review_against_field",
  "kind": "act",
  "impl": "imperative",
  "description": "Review crawl/readiness signals against the field handbook. Returns matching pressing issues and do-this-week steps.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "gtinPct": {
        "type": "number"
      },
      "catalogScore": {
        "type": "number"
      },
      "captchaHint": {
        "type": "boolean"
      },
      "productsJsonOk": {
        "type": "boolean"
      },
      "accountWall": {
        "type": "boolean"
      },
      "error": {
        "type": "string"
      }
    },
    "additionalProperties": false
  },
  "page": "/"
}