Amazon Ads API MCP

{"components":{"schemas":{"AccountInfo":{"properties":{"id":{"description":"Identifier for sellers and vendors. Note that this value is not unique and may be the same across marketplace.","readOnly":true,"type":"string"},"marketplaceStringId":{"description":"The identifier of the marketplace to which the account is associated.","readOnly":true,"type":"string"},"name":{"description":"Account name.","readOnly":true,"type":"string"},"subType":{"description":"The account subtype.","enum":["KDP_AUTHOR","AMAZON_ATTRIBUTION"],"readOnly":true,"type":"string"},"type":{"$ref":"#/components/schemas/AccountType"},"validPaymentMethod":{"description":"Only present for Vendors, this returns whether the Advertiser has set up a valid payment method or not.","readOnly":true,"type":"boolean"}}},"AccountType":{"description":"The `seller` and `vendor` account types are associated with Sponsored Ads APIs. The `agency` account type is associated with DSP and Data Provider APIs.","enum":["vendor","seller","agency"],"readOnly":true,"type":"string"},"Profile":{"properties":{"accountInfo":{"$ref":"#/components/schemas/AccountInfo"},"countryCode":{"$ref":"#/components/schemas/countryCode"},"currencyCode":{"description":"The currency used for all monetary values for entities under this profile.\n|Region|`countryCode`|Country Name|`currencyCode`|\n|-----|------|------|------|\n|NA|BR|Brazil|BRL|\n|NA|CA|Canada|CAD|\n|NA|MX|...","enum":["BRL","CAD","MXN","USD","AED","EUR","EGP","INR","PLN","SAR","SEK","TRY","GBP","AUD","JPY","SGD","ZAR"],"readOnly":true,"type":"string"},"dailyBudget":{"description":"Note that this field applies to Sponsored Product campaigns for seller type accounts only. Not supported for vendor type accounts.","readOnly":false,"type":"number"},"profileId":{"format":"int64","type":"integer"},"timezone":{"description":"The time zone used for all date-based campaign management and reporting.\n|Region|`countryCode`|Country Name|`timezone`|\n|------|-----|-----|------|\n|NA|BR|Brazil|America/Sao_Paulo|\n|NA|CA|Canada|Ameri...","enum":["Africa/Cairo","America/Sao_Paulo","America/Los_Angeles","Asia/Dubai","Asia/Kolkata","Asia/Riyadh","Asia/Singapore","Asia/Tokyo","Australia/Sydney","Europe/Amsterdam","Europe/Dublin","Europe/Istanbul","Europe/London","Europe/Paris","Europe/Stockholm","Europe/Warsaw","Europe/Brussels","Africa/Johannesburg"],"readOnly":true,"type":"string"}}},"ProfileResponse":{"properties":{"code":{"type":"string"},"details":{"type":"string"},"profileId":{"format":"int64","type":"integer"}}},"countryCode":{"description":"The countryCode for a given country\n|Region|`countryCode`|Country Name|\n|------|-----|-------|\n|NA|BR|Brazil|\n|NA|CA|Canada|\n|NA|MX|Mexico|\n|NA|US|United States|\n|EU|AE|United Arab Emirates|\n|EU|BE|Be...","enum":["BR","CA","MX","US","AE","BE","DE","EG","ES","FR","IE","IN","IT","NL","PL","SA","SE","TR","UK","AU","JP","SG","ZA"],"readOnly":true,"type":"string"}},"securitySchemes":{"bearerAuth":{"scheme":"bearer","type":"http"},"oauth2AuthorizationCode":{"description":"Login with Amazon. For more information see [Login with Amazon authorization code grant](https://developer.amazon.com/docs/login-with-amazon/authorization-code-grant.html).","flows":{"authorizationCode":{"authorizationUrl":"https://www.amazon.com/ap/oa","scopes":{"cpc_advertising:campaign_management":"Modify your advertising campaigns and access performance data"},"tokenUrl":"https://api.amazon.com/auth/o2/token"}},"type":"oauth2"}}},"info":{"title":"Amazon Ads API - Profiles","version":"3.0"},"openapi":"3.0.3","paths":{"/v2/profiles":{"get":{"description":"Note that this operation does not return a response unless the current account has created at least one campaign using the advertising console.","operationId":"listProfiles","parameters":[{"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"}},{"description":"Filters response to include profiles that have permissions for the specified Advertising API program only.","in":"query","name":"apiProgram","schema":{"default":"campaign","enum":["billing","campaign","paymentMethod","store","report","account","posts"],"type":"string"}},{"description":"Filters response to include profiles that have specified permissions for the specified Advertising API program only. Currently, the only supported access level is `view` and `edit`.","in":"query","name":"accessLevel","schema":{"default":"view","enum":["edit","view"],"type":"string"}},{"description":"Filters response to include profiles that are of the specified types in the comma-delimited list. Default is all types. Note that this filter performs an inclusive AND operation on the types.","in":"query","name":"profileTypeFilter","schema":{"enum":["seller","vendor","agency"],"type":"string"}},{"description":"Filter response to include profiles that have valid payment methods. Default is to include all profiles.","in":"query","name":"validPaymentMethodFilter","schema":{"enum":["true","false"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Profile"},"maxItems":5000,"type":"array"}}},"description":"Success."}},"summary":"Gets a list of profiles.","tags":["Profiles"]},"put":{"description":"Note that this operation is only used for Sellers using Sponsored Products. This operation is not enabled for vendor type accounts.","operationId":"updateProfiles","parameters":[{"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"}}],"requestBody":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Profile"},"type":"array"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ProfileResponse"},"type":"array"}}},"description":"success"}},"summary":"Update the daily budget for one or more profiles.","tags":["Profiles"]}},"/v2/profiles/{profileId}":{"get":{"description":"This operation does not return a response unless the current account has created at least one campaign using the advertising console.","operationId":"getProfileById","parameters":[{"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"}},{"in":"path","name":"profileId","required":true,"schema":{"format":"int64","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Profile"}}},"description":"Success."}},"summary":"Gets a profile specified by identifier.","tags":["Profiles"]}}},"servers":[{"url":"https://advertising-api.amazon.com"}],"tags":[{"name":"Profiles"}]}