write_product_catalog

Live server: test server (test.mcp.solvimon.com) only.

Defines the catalog structure and charge type, and manages coupons and promotion codes. Hierarchy: product category (optional) → product → product items and features.

Actions: create, update, delete, activate, deactivate, archive, deprecate. Lifecycle actions apply to products, product items, coupons and promotion codes; deactivate to coupons and promotion codes only.

Resource types: product_categories, products, product_items, features, coupons, promotion_codes

Product item model_type options: RECURRING, PER_SEAT, USAGE_BASED (needs a meter_value_calculation_id), ONE_OFF, CREDITS (needs a credit_type_id). Features are non-billable entitlements such as rate limits or feature flags (NUMBER, AMOUNT, ENUM, SWITCH).

{
  "action": "create",
  "resource_type": "product_items",
  "body": {
    "name": "API calls",
    "reference": "api-calls",
    "product_id": "prod_Xw3nQr7KmY2vBs8TfLc41",
    "model_type": "USAGE_BASED",
    "meter_value_calculation_id": "mvc_Jh5tRw9PnX3kMq7VbYd28"
  }
}

Coupons and promotion codes.

• A coupon is always created DRAFT. The result has a summary to confirm before activate.
• If a coupon with the same discount, duration and scope already exists, the create is refused and the existing one is named so you can reuse it. Pass allow_duplicate_terms: true to create it anyway.
• A coupon’s terms can’t be edited. Create a replacement and deactivate the old one. Deactivating stops new redemptions; existing holders keep the discount.
• A promotion code needs an ACTIVE coupon and can only narrow it.

{"action": "create", "resource_type": "coupons", "body": {"name": "Launch 20", "reference": "launch-20", "discount": {"type": "PERCENTAGE", "percentage": "20"}, "duration": {"type": "PERIOD", "period": {"type": "MONTH", "value": 3}}, "maximum_redemptions": 50}}