{
  "webmcp": "0.1",
  "name": "SuggestAPI Commerce Tools",
  "description": "WebMCP tools for tenant-aware commerce search, product lookup, comparison, and recommendations.",
  "origin": "https://agent.suggestapi.com",
  "mcpEndpoint": "https://agent.suggestapi.com/mcp",
  "tools": [
    {
      "name": "search",
      "description": "Search a tenant's catalog and knowledge surface for products, collections, content, and policies.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "tenant": {
            "type": "string",
            "description": "Merchant domain, e.g. demo.suggestapi.com"
          },
          "query": {
            "type": "string",
            "description": "Natural-language or keyword search query"
          },
          "retrieval_mode": {
            "type": "string",
            "enum": [
              "typeahead",
              "autocomplete",
              "search",
              "hybrid"
            ]
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100
          }
        },
        "required": [
          "tenant",
          "query"
        ]
      },
      "endpoint": "https://agent.suggestapi.com/v1/agent/search",
      "method": "POST"
    },
    {
      "name": "recommend",
      "description": "Generate a recommendation set for a tenant based on a natural-language query.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "tenant": {
            "type": "string",
            "description": "Merchant domain, e.g. demo.suggestapi.com"
          },
          "query": {
            "type": "string",
            "description": "Natural-language recommendation request"
          }
        },
        "required": [
          "tenant",
          "query"
        ]
      },
      "endpoint": "https://agent.suggestapi.com/v1/agent/recommend",
      "method": "POST"
    },
    {
      "name": "compare",
      "description": "Compare two or more tenant catalog objects across price, availability, and attributes.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "tenant": {
            "type": "string",
            "description": "Merchant domain, e.g. demo.suggestapi.com"
          },
          "ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Catalog object ids to compare"
          }
        },
        "required": [
          "tenant",
          "ids"
        ]
      },
      "endpoint": "https://agent.suggestapi.com/v1/agent/compare",
      "method": "POST"
    },
    {
      "name": "product_lookup",
      "description": "Retrieve a single canonical tenant product record by id.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "tenant": {
            "type": "string",
            "description": "Merchant domain, e.g. demo.suggestapi.com"
          },
          "id": {
            "type": "string",
            "description": "Product id"
          }
        },
        "required": [
          "tenant",
          "id"
        ]
      },
      "endpoint": "https://agent.suggestapi.com/v1/agent/product",
      "method": "GET"
    }
  ]
}