Market Category Booster

Map a free-text product description to a marketplace category path. Walks the taxonomy of the target marketplace one level at a time and returns the full path: one match per level, from the broadest category down to the most specific one, each with the reason it was picked. Use it to assign a listing category to a product you only have prose for. The last match carries `truncated: true` when the per-request token budget stopped the descent before a leaf. Every successful call is billed: with no `X-API-Key` header and no x402 payment proof the tool answers with the payment requirements instead of a result.

{
  "type": "object",
  "properties": {
    "description": {
      "type": "string",
      "description": "free-text product description, up to 2000 characters."
    },
    "store_id": {
      "type": "string",
      "description": "target marketplace, one of the values from `list_stores`."
    }
  },
  "required": [
    "description",
    "store_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Product name",
      "type": "string"
    },
    "categories": {
      "description": "One match per taxonomy level, from broadest to most specific. The last item may carry truncated=true",
      "items": {
        "description": "One level of the taxonomy descent: the category matched at that depth.",
        "properties": {
          "id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Category identifier in the target taxonomy"
          },
          "category": {
            "description": "Category name as it appears in the taxonomy",
            "type": "string"
          },
          "reason": {
            "description": "Why the model picked this category",
            "type": "string"
          },
          "level": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Zero-based depth in the taxonomy tree; null on legacy records"
          },
          "truncated": {
            "default": false,
            "description": "True on the last match when the per-request token budget stopped the descent: the path is valid but not necessarily a leaf",
            "type": "boolean"
          }
        },
        "required": [
          "category",
          "reason"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "judge_approved": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Whether a separate LLM judge confirmed the final category path is consistent with the description; null when the token budget ran out before the judge could run"
    },
    "judge_reason": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "The judge's stated reason for its verdict on the final path; null when the judge did not run or the final path was never judged"
    }
  },
  "required": [
    "name",
    "categories"
  ]
}

List the marketplaces whose taxonomies are loaded, as `store_id` values. These are the only accepted values for the `store_id` argument of `categorize_product`. Free of charge on purpose: without it an agent would have to pay for a failed call to discover them.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "result": {
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "result"
  ],
  "x-fastmcp-wrap-result": true
}

Return the x402 payment requirements for one categorization call. Meant for an agent that holds no API key: gives network, asset, recipient address and amount as JSON, so the payment authorization can be signed before calling `categorize_product`. Free of charge.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "result": {
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "x-fastmcp-wrap-result": true
}