Paddle MCP Server

Official

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:

  1. Group countries based on purchasing power parity (PPP), not just currency zones
  2. 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)
  3. Adjust prices relative to local economic conditions - higher in wealthy markets, lower in developing economies
  4. For optimal conversion rates, set prices using local market research and willingness-to-pay data
  5. 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

NameRequiredDescriptionDefault
billingCycleNoFor subscription prices, defines the recurring billing period
customDataNoA JSON object of custom metadata. Limited to 50 keys, with key names up to 40 characters
descriptionYesA description of this price that will be displayed to customers
nameNoThe name of the price
productIdYesThe ID of the product this price is for
quantityNoQuantity limits for this price
trialPeriodNoFor subscription prices with a trial, defines the trial period duration
unitPriceYesThe base price details
unitPriceOverridesNoCountry-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" }

You must be authenticated.

Other Tools from Paddle MCP Server

Related Tools

ID: 0pdgnr4eoo