Amazon Ads API MCP

{"components":{"callbacks":{},"examples":{},"headers":{},"links":{},"parameters":{},"requestBodies":{},"responses":{"HexgateBadRequestV1":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad request"},"HexgateForbiddenV1":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Forbidden. The request failed because the user does not have access to the specified resource."},"HexgateInternalServerErrorV1":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error. Something went wrong on the server. Retry later and report an error if unresolved."},"HexgateNotFoundV1":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not Found. The requested resource does not exist or is not visible for the user."},"HexgatePreconditionFailedV1":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The input provided does not meet the required constraints for this operation to be performed successfully."},"HexgateTooManyRequestsV1":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Too Many Requests. The request was rate-limited. Retry later."},"HexgateUnauthorizedV1":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized. The request failed because the user is not authenticated or is not allowed to invoke the operation."}},"schemas":{"Error":{"description":"The error response object.","properties":{"errors":{"items":{"$ref":"#/components/schemas/SubError","properties":{}},"maxItems":10,"type":"array"},"message":{"description":"A human-readable description of the response.","type":"string"},"requestId":{"description":"Request Id that uniquely identifies your request.","type":"string"}}},"ListLocationsRequestBodyV1":{"description":"Resulting locations will match all specified filters","properties":{"filters":{"items":{"$ref":"#/components/schemas/LocationFilterV1"},"type":"array"}},"type":"object"},"LocationCategoryV1":{"description":"The location category.","enum":["CITY","COUNTRY","DMA","POSTAL_CODE","STATE"],"type":"string"},"LocationFilterV1":{"properties":{"field":{"description":"Field to filter by. Supported enums are 'locationId', 'name', and 'category'. The 'name' filter is a fuzzy search. If 'category' is specified, the values must match either 'CITY', 'STATE', 'DMA', 'COUNTRY', or 'POSTAL_CODE'.","enum":["category","locationId","name"],"type":"string"},"values":{"items":{"type":"string"},"type":"array"}},"type":"object"},"LocationIdV1":{"description":"The identifier of the location.","type":"string"},"LocationV1":{"properties":{"category":{"$ref":"#/components/schemas/LocationCategoryV1"},"locationId":{"$ref":"#/components/schemas/LocationIdV1"},"name":{"description":"The location name.","type":"string"}},"type":"object"},"SubError":{"description":"The sub error object.","properties":{"errorType":{"type":"string"},"fieldName":{"type":"string"},"message":{"type":"string"}},"required":["errorType","message"],"type":"object"}},"securitySchemes":{}},"info":{"title":"Locations","version":"3.0"},"openapi":"3.0.1","paths":{"/locations/list":{"post":{"description":"Note: This endpoint is currently limited to US only. Gets a list of location objects after filtering on at least one of **locationId**, **name**, **category**. Each item in the resulting set will match all specified filters.\n\n\n**Requires one of these permissions**:\n[]","operationId":"listLocations","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":"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.","in":"header","name":"Amazon-Advertising-API-Scope","required":true,"schema":{"type":"string"}},{"description":"Token from a previous request. Use in conjunction with the `maxResults` parameter to control pagination of the returned array.","in":"query","name":"nextToken","required":false,"schema":{"type":"string"}},{"description":"Sets the number of locations in the returned array. Use in conjunction with the `nextToken` parameter to control pagination. The range for maxResults is [1,2000] with default as 10. For example, supplying maxResults=20 with a previously returned token will fetch the next 20 items.","in":"query","name":"maxResults","required":false,"schema":{"default":"10","maximum":2000,"minimum":1,"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListLocationsRequestBodyV1"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"description":"List of locations.","properties":{"locations":{"items":{"$ref":"#/components/schemas/LocationV1"},"type":"array"},"nextToken":{"description":"Token used in following requests for pagination.","type":"string"}},"type":"object"}}},"description":"Successful operation."},"400":{"$ref":"#/components/responses/HexgateBadRequestV1"},"401":{"$ref":"#/components/responses/HexgateUnauthorizedV1"},"403":{"$ref":"#/components/responses/HexgateForbiddenV1"},"404":{"$ref":"#/components/responses/HexgateNotFoundV1"},"412":{"$ref":"#/components/responses/HexgatePreconditionFailedV1"},"429":{"$ref":"#/components/responses/HexgateTooManyRequestsV1"},"500":{"$ref":"#/components/responses/HexgateInternalServerErrorV1"}},"summary":"Gets location objects based on one or more filters.","tags":["Locations"]}}}}