apple_set_price
Set app pricing on Apple App Store by specifying price tier ID for paid apps or marking as free. Configure pricing changes with optional start dates.
Instructions
Set app price (free or paid). Use price tier ID from Apple price points.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| appId | Yes | App ID | |
| priceTierId | Yes | Price tier ID (use "0" for free) | |
| startDate | No | ISO 8601 start date |
Implementation Reference
- src/apple/tools.ts:579-608 (handler)The handler logic for apple_set_price, which makes a POST request to create an app price schedule.
handler: async (client, args) => { return client.request(`/apps/${args.appId}/appPriceSchedule`, { method: 'POST', body: { data: { type: 'appPriceSchedules', relationships: { app: { data: { type: 'apps', id: args.appId } }, manualPrices: { data: [{ type: 'appPrices', id: '${new}' }], }, }, }, included: [ { type: 'appPrices', id: '${new}', attributes: { startDate: args.startDate ?? null, }, relationships: { priceTier: { data: { type: 'appPriceTiers', id: args.priceTierId }, }, }, }, ], }, }); }, - src/apple/tools.ts:574-578 (schema)Input schema for apple_set_price tool.
schema: z.object({ appId: z.string().describe('App ID'), priceTierId: z.string().describe('Price tier ID (use "0" for free)'), startDate: z.string().optional().describe('ISO 8601 start date'), }), - src/apple/tools.ts:571-573 (registration)Tool definition for apple_set_price.
const setAppPrice: ToolDef = { name: 'apple_set_price', description: 'Set app price (free or paid). Use price tier ID from Apple price points.',