Amazon Ads API MCP

{"components":{"callbacks":{},"examples":{},"headers":{},"links":{},"parameters":{"APIScopeHeader":{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input.","in":"header","name":"Amazon-Advertising-API-Scope","required":true,"schema":{"type":"string"}},"ClientIdHeader":{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"type":"string"}}},"requestBodies":{},"responses":{},"schemas":{"AccountBudgetFeatureFlagsError":{"description":"The Error Response Object.","properties":{"code":{"description":"An enumerated code for machine use.","enum":["ENTRY_NOT_FOUND","INVALID_PARAMETER_VALUE","OK"],"type":"string"},"details":{"description":"A human-readable description of the response.","type":"string"}},"type":"object"},"FeatureFlags":{"description":"Feature flags for account budget, which denotes that advertiser Opted In/Out from specific budget feature.","properties":{"isOptedOutForAverageDailyBudgetIncrease":{"description":"Denotes the opt in/out decision for AverageDailyBudgetIncrease feature. If the entity spends less than your daily budget, the unspent amount can be used to increase your daily budget to 100% (if opted in) or 25% (if opted out) in other days of calendar month.","type":"boolean"}},"type":"object"},"GetAccountBudgetFeatureFlagsResponse":{"description":"Response to get account budget feature flags information.","properties":{"featureFlags":{"$ref":"#/components/schemas/FeatureFlags"}},"type":"object"},"UpdateAccountBudgetFeatureFlagsRequest":{"description":"Request to update account budget feature flags information.","properties":{"featureFlags":{"$ref":"#/components/schemas/FeatureFlags"}},"required":["featureFlags"],"type":"object"},"UpdateAccountBudgetFeatureFlagsResponse":{"description":"Response for update account budget feature flags information.","properties":{"code":{"description":"An enumerated code for machine use.","enum":["ENTRY_NOT_FOUND","INVALID_PARAMETER_VALUE","OK"],"type":"string"},"details":{"description":"A human-readable description of the response.","type":"string"}},"type":"object"}},"securitySchemes":{}},"info":{"title":"Advertisers","version":"3.0"},"openapi":"3.0.1","paths":{"/accountBudgets/featureFlags":{"get":{"description":"Gets account budget feature flags information.\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_view\"]","operationId":"getAccountBudgetFeatureFlags","parameters":[{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/APIScopeHeader"}],"responses":{"200":{"content":{"application/vnd.accountBudgetFeatureFlags.v1+json":{"schema":{"$ref":"#/components/schemas/GetAccountBudgetFeatureFlagsResponse"}}},"description":"Successful operation."},"400":{"content":{"application/vnd.accountBudgetFeatureFlagsError.v1+json":{"schema":{"$ref":"#/components/schemas/AccountBudgetFeatureFlagsError"}}},"description":"Bad Request."},"401":{"content":{"application/vnd.accountBudgetFeatureFlagsError.v1+json":{"schema":{"$ref":"#/components/schemas/AccountBudgetFeatureFlagsError"}}},"description":"Unauthorized - Request failed because user is not authenticated or is not allowed to invoke the operation."},"403":{"content":{"application/vnd.accountBudgetFeatureFlagsError.v1+json":{"schema":{"$ref":"#/components/schemas/AccountBudgetFeatureFlagsError"}}},"description":"Forbidden - Request failed because user does not have access to a specified resource."},"429":{"content":{"application/vnd.accountBudgetFeatureFlagsError.v1+json":{"schema":{"$ref":"#/components/schemas/AccountBudgetFeatureFlagsError"}}},"description":"Too Many Requests - Request was rate-limited. Retry later."},"500":{"content":{"application/vnd.accountBudgetFeatureFlagsError.v1+json":{"schema":{"$ref":"#/components/schemas/AccountBudgetFeatureFlagsError"}}},"description":"Internal Server Error - Something went wrong on the server. Retry later and report an error if unresolved."}},"summary":"Gets account budget feature flags information.","tags":["Advertiser"]},"post":{"description":"Creates or Updates account budget feature flags information.\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_view\",\"advertiser_campaign_edit\"]","operationId":"updateAccountBudgetFeatureFlags","parameters":[{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/APIScopeHeader"}],"requestBody":{"content":{"application/vnd.accountBudgetFeatureFlags.v1+json":{"schema":{"$ref":"#/components/schemas/UpdateAccountBudgetFeatureFlagsRequest"}}},"required":true},"responses":{"200":{"content":{"application/vnd.accountBudgetFeatureFlags.v1+json":{"schema":{"$ref":"#/components/schemas/UpdateAccountBudgetFeatureFlagsResponse"}}},"description":"Successful operation."},"400":{"content":{"application/vnd.accountBudgetFeatureFlagsError.v1+json":{"schema":{"$ref":"#/components/schemas/AccountBudgetFeatureFlagsError"}}},"description":"Bad Request."},"401":{"content":{"application/vnd.accountBudgetFeatureFlagsError.v1+json":{"schema":{"$ref":"#/components/schemas/AccountBudgetFeatureFlagsError"}}},"description":"Unauthorized - Request failed because user is not authenticated or is not allowed to invoke the operation."},"403":{"content":{"application/vnd.accountBudgetFeatureFlagsError.v1+json":{"schema":{"$ref":"#/components/schemas/AccountBudgetFeatureFlagsError"}}},"description":"Forbidden - Request failed because user does not have access to a specified resource."},"429":{"content":{"application/vnd.accountBudgetFeatureFlagsError.v1+json":{"schema":{"$ref":"#/components/schemas/AccountBudgetFeatureFlagsError"}}},"description":"Too Many Requests - Request was rate-limited. Retry later."},"500":{"content":{"application/vnd.accountBudgetFeatureFlagsError.v1+json":{"schema":{"$ref":"#/components/schemas/AccountBudgetFeatureFlagsError"}}},"description":"Internal Server Error - Something went wrong on the server. Retry later and report an error if unresolved."}},"summary":"Creates or Updates account budget feature flags information.","tags":["Advertiser"]}}}}