create_price

create_price

Set product prices optimized for global markets using country-specific overrides. Adjust pricing based on purchasing power parity, local currencies, and economic conditions to maximize conversion rates.

Instructions

This tool will create a new price for a product in Paddle.

When using unitPriceOverrides:

Group countries based on purchasing power parity (PPP), not just currency zones
Create separate overrides for countries with different economic conditions even if they share the same currency (e.g., Greece and Ireland should have different price points)
Adjust prices relative to local economic conditions - higher in wealthy markets, lower in developing economies
For optimal conversion rates, set prices using local market research and willingness-to-pay data
Use local currencies where preferred by the customer

Example unitPriceOverrides structure: [ { "countryCodes": ["GB"], "unitPrice": { "amount": "8500", "currencyCode": "GBP" } }, { "countryCodes": ["IE"], "unitPrice": { "amount": "9500", "currencyCode": "EUR" } }, { "countryCodes": ["GR"], "unitPrice": { "amount": "6500", "currencyCode": "EUR" } }, { "countryCodes": ["IN"], "unitPrice": { "amount": "30000", "currencyCode": "INR" } }, { "countryCodes": ["CN"], "unitPrice": { "amount": "20000", "currencyCode": "CNY" } } ]

Input Schema

Name	Required	Description
`billingCycle`	No	For subscription prices, defines the recurring billing period
`customData`	No	A JSON object of custom metadata. Limited to 50 keys, with key names up to 40 characters
`description`	Yes	A description of this price that will be displayed to customers
`name`	No	The name of the price
`productId`	Yes	The ID of the product this price is for
`quantity`	No	Quantity limits for this price
`trialPeriod`	No	For subscription prices with a trial, defines the trial period duration
`unitPrice`	Yes	The base price details
`unitPriceOverrides`	No	Country-specific price overrides. Used for regional pricing

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "billingCycle": {
      "additionalProperties": false,
      "description": "For subscription prices, defines the recurring billing period",
      "properties": {
        "frequency": {
          "description": "How many intervals make up one billing cycle (e.g., 2 weeks, 3 months)",
          "type": "number"
        },
        "interval": {
          "description": "The billing period unit (day, week, month, or year)",
          "enum": [
            "day",
            "week",
            "month",
            "year"
          ],
          "type": "string"
        }
      },
      "required": [
        "interval",
        "frequency"
      ],
      "type": "object"
    },
    "customData": {
      "additionalProperties": {},
      "description": "A JSON object of custom metadata. Limited to 50 keys, with key names up to 40 characters",
      "type": "object"
    },
    "description": {
      "description": "A description of this price that will be displayed to customers",
      "type": "string"
    },
    "name": {
      "description": "The name of the price",
      "type": "string"
    },
    "productId": {
      "description": "The ID of the product this price is for",
      "type": "string"
    },
    "quantity": {
      "additionalProperties": false,
      "description": "Quantity limits for this price",
      "properties": {
        "maximum": {
          "description": "The maximum quantity that can be purchased. Must be greater than minimum if specified",
          "type": "number"
        },
        "minimum": {
          "description": "The minimum quantity that can be purchased. Must be at least 1 if specified",
          "type": "number"
        }
      },
      "type": "object"
    },
    "trialPeriod": {
      "additionalProperties": false,
      "description": "For subscription prices with a trial, defines the trial period duration",
      "properties": {
        "frequency": {
          "description": "How many intervals make up the trial period (e.g., 14 days, 1 month)",
          "type": "number"
        },
        "interval": {
          "description": "The trial period unit (day, week, month, or year)",
          "enum": [
            "day",
            "week",
            "month",
            "year"
          ],
          "type": "string"
        }
      },
      "required": [
        "interval",
        "frequency"
      ],
      "type": "object"
    },
    "unitPrice": {
      "additionalProperties": false,
      "description": "The base price details",
      "properties": {
        "amount": {
          "description": "The price amount in the smallest currency unit (e.g., cents). Must be a positive integer represented as a string",
          "type": "string"
        },
        "currencyCode": {
          "description": "The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP)",
          "type": "string"
        }
      },
      "required": [
        "amount",
        "currencyCode"
      ],
      "type": "object"
    },
    "unitPriceOverrides": {
      "description": "Country-specific price overrides. Used for regional pricing",
      "items": {
        "additionalProperties": false,
        "properties": {
          "countryCodes": {
            "description": "List of two-letter ISO 3166-1 alpha-2 country codes where this override applies",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "unitPrice": {
            "additionalProperties": false,
            "description": "The override price details",
            "properties": {
              "amount": {
                "description": "The override price amount in the smallest currency unit. Must be a positive integer represented as a string",
                "type": "string"
              },
              "currencyCode": {
                "description": "The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP)",
                "type": "string"
              }
            },
            "required": [
              "amount",
              "currencyCode"
            ],
            "type": "object"
          }
        },
        "required": [
          "countryCodes",
          "unitPrice"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "productId",
    "description",
    "unitPrice"
  ],
  "type": "object"
}

Paddle MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Paddle MCP Server

Related Tools

MCP directory API