Tool Reference
Amazon Catalog MCP Tool Reference
Amazon Seller Central MCP reference for catalog tools: product details, sales ranks, A+ Content, variations, reviews, listing quality, and write tools for listings, prices, and quantities.
Related paths
Hosted Amazon Seller Central MCP overview for Claude, ChatGPT, and custom agents.
Amazon seller data layerHow ads, inventory, orders, catalog, ranking, finance, and fulfillment data are structured for agents.
Claude connection walkthroughStep-by-step path from Seller Central OAuth to a Claude connector or MCP config.
ChatGPT Seller Central setupChatGPT-specific setup and examples for Amazon seller data through MCP.
Tools (12)
read
get_product_details
readGet product info for a specific ASIN from the catalog. Title, brand, product type, images, dimensions, status, and BSR (Best Sellers Rank).
When to use
Look up detailed product information for a specific ASIN, including title, dimensions, images, and current BSR.
Parameters2
| Name | Type | Description |
|---|---|---|
asin* | string | ASIN to look up. |
include_raw_rows | boolean (true) | Set false to return a compact row preview. Defaults to true; large result sets are capped automatically to keep the response manageable. |
* required
Tips
- Check item_status to verify the product is in an active state.
- BSR (sales_rank) gives a relative indicator of sales volume within the category.
- Image URLs and bullet_points are useful for listing audit workflows.
Related tools
get_sales_ranks
readGet Best Sellers Rank (BSR) across your catalog. Returns rank, category, title, and brand for all ASINs with BSR data.
When to use
Monitor BSR across your entire catalog to identify top sellers and products losing rank.
Parameters6
| Name | Type | Description |
|---|---|---|
asin | string | Filter by ASIN. |
max_rank | number | Only show ASINs with BSR less than or equal to this value. |
sort_by | enum (sales_rank) | Column to sort by: sales_rank, asin, title. |
sort_order | enum (asc) | Sort direction: asc or desc. Default asc shows best rank first. |
limit | number (20) | Max rows to return (1-1000). |
include_raw_rows | boolean (true) | Set false to return a compact row preview. Defaults to true; large result sets are capped automatically to keep the response manageable. |
Tips
- Use max_rank=10000 to focus on products in the top 10,000 of their category.
- Lower BSR means higher sales velocity. Track BSR trends over time by running this daily.
- Compare BSR against actual sales data from get_sales_velocity to validate.
get_aplus_status
readCheck A+ Content status for your listings. Shows content documents with their approval status, associated ASINs, and last update time. Requires Brand Registry.
When to use
Audit which listings have A+ Content, check approval statuses, and identify products that are missing enhanced content.
Tips
- A+ Content typically improves conversion rates by 3-10%, so identify ASINs without it.
- Check the status field for content that may be pending review or rejected.
- Cross-reference the ASINs list against your active listings to find gaps.
Watch out
- Requires Brand Registry enrollment. Returns empty results if Brand Registry is not active.
get_variations
readGet parent/child variation relationships for an ASIN. Shows the variation family tree including variation theme (size, color, etc.) and all child ASINs.
When to use
Understand the variation family structure for a product, find all child ASINs under a parent, or determine if an ASIN is a parent or child.
Parameters1
| Name | Type | Description |
|---|---|---|
asin* | string | Parent or child ASIN to look up variation relationships for. |
* required
Tips
- Pass either a parent or child ASIN and the tool will show the full family tree.
- The variation theme (size, color, etc.) tells you which attribute differentiates the children.
- Use this to identify all child ASINs when you need to check inventory or pricing across the family.
get_listing_quality
readGet weekly Listings Items API quality snapshots. view=summary returns listing completeness and issue counts; view=issues returns Amazon issue codes, affected attributes, and raw issue details.
When to use
Use this to inspect listing completeness, Amazon listing issue signals, missing content, offer/fulfillment availability counts, and source-provided issue details.
Parameters14
| Name | Type | Description |
|---|---|---|
asin | string | Filter by ASIN. |
sku | string | Filter by SKU. |
sort_order | enum (desc) | Sort direction: asc or desc. |
limit | number (20) | Max rows to query (1-1000). Use a higher limit when the user asks for all matching rows; large responses are capped automatically. |
view | enum (summary) | summary returns listing completeness and issue counts; issues returns Amazon issue details. |
snapshot_date | string | Optional snapshot date (YYYY-MM-DD). Defaults to latest listing quality snapshot. |
include_synthetic_skus | boolean (false) | Include reimbursement placeholder SKUs such as FBA...missing1. |
quality_status | enum | summary view only. Filter by healthy, incomplete, warning, error, or not_found. |
has_issues | boolean | summary view only. True returns listings with issue_count > 0; false returns zero-issue rows. |
severity | enum | issues view only. Filter by ERROR, WARNING, or INFO. |
issue_code | string | issues view only. Filter listings containing a specific Amazon issue code. |
attribute_name | string | issues view only. Filter listings containing an issue for this attribute name. |
sort_by | enum (issue_count) | Sort column. Allowed columns depend on view. |
include_raw_rows | boolean (true) | Set false to return a compact row preview. Defaults to true; large result sets are capped automatically to keep the response manageable. |
Tips
- Use view="summary" to scan listing completeness and issue counts.
- Use view="issues" to inspect Amazon issue codes, affected attributes, and raw issue JSON.
- Filter by asin or sku when reviewing one listing before an update_listing preview.
Watch out
- Snapshots refresh weekly. For a live 'is this ASIN buyable right now' check, fan out across get_buybox_status, get_listing_restrictions, and get_fba_eligibility (all live SP-API), and cross-reference get_suppressed_listings.
get_catalog_cleanup
readReturn listing quality signals from snapshots: Amazon errors, warnings, missing core content, offer and fulfillment gaps, and thin listing content.
When to use
Inspect listing quality states across Amazon issues, missing content, offer availability, and fulfillment availability.
Parameters6
| Name | Type | Description |
|---|---|---|
asin | string | Filter by ASIN. |
sku | string | Filter by seller SKU. |
snapshot_date | string | Snapshot date (YYYY-MM-DD). Defaults to latest listing quality snapshot. |
cleanup_focus | enum (all) | Focus category: all, amazon_error, amazon_warning, missing_core_content, offer_or_fulfillment_gap, or content_depth_gap. |
include_healthy | boolean (false) | Include healthy listings after cleanup items. |
limit | number (20) | Max cleanup rows to return (1-100). |
Tips
- Run with cleanup_focus=amazon_error to return rows with Amazon error-level listing issues.
- Use cleanup_focus=missing_core_content to find listings missing title, brand, or main image.
- Use cleanup_reasons and issue_attribute_names to group rows by captured listing quality signal.
Watch out
- The tool reads weekly listing quality snapshots; it does not perform live Seller Central validation. Use update_listing in preview mode before submitting changes.
write
create_listing
writeValidate or submit a new listing request to Amazon using the Listings Items API. Defaults to validation preview mode and requires confirm=true plus an idempotency key to submit.
When to use
Validate or submit a new product listing to Amazon, including all required attributes like title, brand, and product identifiers.
Parameters5
| Name | Type | Description |
|---|---|---|
sku* | string | Seller SKU for the listing (1-40 characters). |
product_type* | string | Amazon product type (e.g. SHIRT, LUGGAGE, HEALTH_PERSONAL_CARE). |
attributes* | object | Listing attributes object (max 50KB). Common keys: item_name, brand, bullet_point, product_description, externally_assigned_product_identifier (UPC/EAN), list_price, main_product_image_locator.Values follow Amazon attribute format. Check Amazon product type definitions for required attributes. |
confirm | boolean | Defaults to false for validation preview. Set true to submit the listing creation. |
idempotency_key | string | Required when confirm=true. Reusing the same key blocks duplicate submissions. |
* required
Tips
- Use get_listing_restrictions first to verify you are allowed to list in this category.
- Check the response for validation issues, which indicate missing or malformed attributes.
- Run preview first, then submit with confirm=true and a unique idempotency_key once the preview is valid.
- For variation children, include the parent ASIN in the attributes object.
- The submission may be accepted with status ACCEPTED but still require review before going live.
Watch out
- Requires a Seller ID in the account configuration. Returns an error if Seller Central is not connected.
update_listing
writeUpdate Amazon listing attributes by SKU through the Listings Items API. Runs in preview mode by default and requires confirm=true plus an idempotency key to submit.
When to use
Change listing content attributes such as title, bullets, description, keywords, or images after reviewing the current Amazon listing state.
Parameters5
| Name | Type | Description |
|---|---|---|
sku* | string | Seller SKU for the listing to update. |
product_type | string | Optional Amazon product type override. Usually read from the current listing. |
patches* | array | Attribute patches to submit. Each item includes attribute, op (add, replace, delete, or merge), and value unless op=delete. Max 20 attributes per call. |
confirm | boolean (false) | Preview by default. Set true to submit the listing patch to Amazon. |
idempotency_key | string | Required when confirm=true. Reusing the same key blocks duplicate listing updates. |
* required
Tips
- Call it once without confirm to review current attribute values and the exact patch set.
- Use Amazon Listings Items API attribute format for values, such as item_name: [{ value: "New title", marketplace_id: "ATVPDKIKX0DER" }].
- Use a stable idempotency_key for the business action, such as listing-SKU-attribute-YYYYMMDD.
- Use update_price and update_inventory_quantity for price and fulfillment availability fields.
Watch out
- Requires Seller Central credentials and a Seller ID. Confirmed submissions are recorded in action history with pre-submit current values and submitted values.
update_price
writeSubmit Amazon listing price updates by SKU through the Listings Items API. Runs Amazon validation preview by default and requires confirm=true plus an idempotency key to submit.
When to use
Change one or more listing prices after reviewing the current listing state and confirming the exact listing patch submission.
Parameters3
| Name | Type | Description |
|---|---|---|
updates* | array | Price updates to submit. Each item includes sku and price, with optional minimum_seller_allowed_price and maximum_seller_allowed_price guardrails. Max 25 SKUs per call. |
confirm | boolean (false) | Validation preview by default. Set true to submit price patches to Amazon. |
idempotency_key | string | Required when confirm=true. Reusing the same key blocks duplicate price update submissions. |
* required
Tips
- Call it once without confirm to preview exact SKUs, target prices, and Amazon validation output.
- Use a stable idempotency_key for the business action, such as price-SKU-YYYYMMDD.
- Set minimum and maximum seller allowed prices when you want Amazon-side bounds around the new price.
- The tool patches the top-level purchasable_offer attribute for each SKU.
Watch out
- Requires Seller Central credentials and a Seller ID. Confirmed price submissions are capped at $10,000 per item price and are recorded in action history as submitted values.
update_inventory_quantity
writeUpdate seller-fulfilled listing inventory quantities by SKU through the Listings Items API. Runs in preview mode by default and requires confirm=true plus an idempotency key to submit.
When to use
Change available listing quantities after reviewing current fulfillment availability, especially to mark seller-fulfilled SKUs in stock or out of stock.
Parameters3
| Name | Type | Description |
|---|---|---|
updates* | array | Quantity updates to submit. Each item includes sku and quantity, plus optional fulfillment_channel_code, lead_time_to_ship_max_days, and product_type. Max 25 SKUs per call. |
confirm | boolean (false) | Preview by default. Set true to submit listing patches to Amazon. |
idempotency_key | string | Required when confirm=true. Reusing the same key blocks duplicate quantity updates. |
* required
Tips
- Call it once without confirm to preview current quantity, ASIN, product type, and the target quantity.
- Use quantity=0 to mark a seller-fulfilled SKU out of stock.
- Use a stable idempotency_key for the business action, such as inv-SKU-YYYYMMDD.
- The default fulfillment_channel_code is DEFAULT, the seller-fulfilled offer channel.
Watch out
- Requires Seller Central credentials and a Seller ID. FBA stock is controlled by Amazon inventory and inbound workflows; use this for listing fulfillment availability, not to directly mutate FBA warehouse stock.
live api
get_product_reviews
live apiSummarize Amazon Customer Feedback review topics for a child ASIN. Returns top positive and negative topics, mentions, occurrence percentages, star-rating impact, snippets, and subtopics.
When to use
Understand what customers praise or complain about for a product without reading individual reviews manually.
Parameters2
| Name | Type | Description |
|---|---|---|
asin* | string | Child ASIN to look up review topics for. |
sort_by | enum (MENTIONS) | Sort topics by MENTIONS or STAR_RATING_IMPACT. |
* required
Tips
- Use negative topics to group complaint themes by mentions, occurrence percentage, and star-rating impact.
- Use STAR_RATING_IMPACT when you care more about rating movement than mention volume.
- Compare child ASIN metrics against parent and browse-node metrics to see whether an issue is product-specific.
Watch out
- Amazon refreshes Customer Feedback data weekly. The API requires enough review volume and expects a child ASIN.
Related tools
get_review_trends
live apiShow six-month Amazon Customer Feedback review topic trends for a child ASIN. Returns monthly occurrence percentages for top positive and negative review topics.
When to use
Track whether key praise or complaint themes are getting better or worse over the last six months.
Parameters1
| Name | Type | Description |
|---|---|---|
asin* | string | Child ASIN to look up review topic trends for. |
* required
Tips
- Use this after get_product_reviews to see whether a complaint is persistent or newly emerging.
- Look for increasing negative-topic occurrence after packaging, supplier, or listing changes.
- Compare parent and browse-node percentages to separate product-specific issues from category-wide patterns.
Watch out
- Amazon refreshes Customer Feedback data weekly. The API requires enough review volume and expects a child ASIN.