{
  "$schema": "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json",
  "name": "com.lambowholesale/storefront",
  "title": "Lambo Wholesale (trade only)",
  "description": "Search the catalog and get a checkout link. No prices.",
  "version": "1.0.0",
  "websiteUrl": "https://lambowholesale.com",
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://lambowholesale.com/mcp",
      "supportedProtocolVersions": [
        "2026-07-28",
        "2025-11-25",
        "2025-06-18",
        "2025-03-26"
      ]
    }
  ],
  "tools": [
    {
      "name": "search_products",
      "title": "Search products",
      "description": "Search the catalog by text. Returns only products that are in stock and orderable, with their variant_id values. No prices: Lambo prices show only to signed-in approved accounts on the website.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "Search text."
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20,
            "description": "Results to return (default 10, max 20)."
          }
        },
        "required": [
          "query"
        ]
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "count": {
            "type": "integer",
            "description": "Number of products returned."
          },
          "products": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            },
            "description": "In-stock, orderable products with their variant_id values."
          },
          "error": {
            "type": "string",
            "description": "Present only when isError is true."
          },
          "notices": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Trade-only and handling notices that ride on every result."
          }
        },
        "additionalProperties": true
      }
    },
    {
      "name": "get_product",
      "title": "Get a product",
      "description": "One product by handle: description, categories, lab report link and its orderable variants with variant_id values. No prices.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "handle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "Product handle."
          }
        },
        "required": [
          "handle"
        ]
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "product": {
            "type": "object",
            "additionalProperties": true,
            "description": "One product with its orderable variants."
          },
          "error": {
            "type": "string",
            "description": "Present only when isError is true."
          },
          "notices": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Trade-only and handling notices that ride on every result."
          }
        },
        "additionalProperties": true
      }
    },
    {
      "name": "build_cart",
      "title": "Build a cart link and get a checkout link",
      "description": "Checks variant_id and quantity pairs (max 25 lines, quantity 1-99 each) and returns a checkout_url for the buyer to open on the website, where the items are added to the buyer's own cart once signed in with an approved account. No cart is created here. Payment, address, age and license checks all happen on the website, never in chat. Always give the buyer the checkout_url.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "minItems": 1,
            "maxItems": 25,
            "items": {
              "type": "object",
              "properties": {
                "variant_id": {
                  "type": "string",
                  "description": "variant_id from search_products or get_product."
                },
                "quantity": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 99
                }
              },
              "required": [
                "variant_id",
                "quantity"
              ]
            }
          }
        },
        "required": [
          "items"
        ]
      },
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "checkout_url": {
            "type": "string",
            "description": "Website link the buyer opens to add these lines to their own cart."
          },
          "expires_at": {
            "type": "string",
            "description": "ISO 8601 time the link stops working."
          },
          "lines": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            },
            "description": "Accepted lines: variant_id, title, quantity."
          },
          "rejected": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            },
            "description": "Lines that could not be added, each with a reason."
          },
          "error": {
            "type": "string",
            "description": "Present only when isError is true."
          },
          "notices": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Trade-only and handling notices that ride on every result."
          }
        },
        "additionalProperties": true
      }
    },
    {
      "name": "get_trade_requirements",
      "title": "Trade account requirements",
      "description": "What a new wholesale buyer needs to open a trade account: product-type shipping restrictions for a state, vape limits for that state, the accepted resale document types, the file rule, the 21+ rule and what happens after they apply. This does not decide whether every product ships to that state. Ask the buyer for their 2-letter state and whether they want nicotine or hemp vapes. Never ask for or accept a license number, file, password, EIN, address, email or phone in chat: those go on the website form.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "state": {
            "type": "string",
            "pattern": "^[A-Za-z]{2}$",
            "description": "2-letter US state code, e.g. TX."
          },
          "wants_vapes": {
            "type": "boolean",
            "description": "True if the buyer wants to buy nicotine or hemp vapes."
          }
        },
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string",
            "description": "Present only when isError is true."
          },
          "notices": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Trade-only and handling notices that ride on every result."
          }
        },
        "additionalProperties": true
      }
    },
    {
      "name": "start_trade_application",
      "title": "Start a trade application",
      "description": "Returns the website link where the buyer applies for a trade account, with their state, resale document type and vape choice preselected, plus a checklist of what to have ready. The buyer completes the application on the website; nothing is collected in chat. Always give the buyer the apply_url.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "state": {
            "type": "string",
            "pattern": "^[A-Za-z]{2}$",
            "description": "2-letter US state code, e.g. TX."
          },
          "resale_doc_kind": {
            "type": "string",
            "enum": [
              "sellers_permit",
              "state_resale_certificate",
              "multistate_uniform"
            ],
            "description": "Which resale document the buyer will use."
          },
          "wants_vapes": {
            "type": "boolean",
            "description": "True if the buyer wants to buy nicotine or hemp vapes."
          }
        },
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "apply_url": {
            "type": "string",
            "description": "Website link where the buyer completes the application."
          },
          "error": {
            "type": "string",
            "description": "Present only when isError is true."
          },
          "notices": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Trade-only and handling notices that ride on every result."
          }
        },
        "additionalProperties": true
      }
    }
  ]
}