> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Amazon Seller Central

> **This Connector is in Beta**
>
> Merge has validated Amazon Seller Central against the provider's documented API and not yet verified it against the live one, so its behavior can differ from the documentation. It carries the same tool surface it will have at general availability. [Connectors overview](/merge-agent-handler/connectors/overview) covers the tier and how to turn Beta Connectors off.

**Authentication:** Access token. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow.

## Sample use cases

* List orders placed in the last 24 hours and flag the ones not yet shipped
* Check inventory summaries for every SKU below two weeks of cover
* Create a sales report for last month and fetch it once it finishes

## Available Tools

#### search_catalog_items

Search the Amazon catalog in one marketplace (marketplace_ids required). Look up items by identifiers + identifiers_type...

#### get_catalog_item

Fetch one Amazon catalog item by ASIN for the given marketplace_ids. Use included_data to add summaries, attributes, ide...

#### create_inbound_plan

Start an FBA inbound plan: the entry point to the whole inbound workflow. destination_marketplaces, items (MSKU+quantity...

#### list_inbound_plans

List your FBA inbound plans. Optionally filter by status (ACTIVE, VOIDED, SHIPPED) and sort with sort_by (LAST_UPDATED_T...

#### get_inbound_plan

Fetch one FBA inbound plan by inbound_plan_id (from create_inbound_plan or list_inbound_plans): its status, packing/plac...

#### cancel_inbound_plan

Cancel an FBA inbound plan by inbound_plan_id (from create_inbound_plan or list_inbound_plans). This voids ALL shipments...

#### set_packing_information

Set box-level packing information (dimensions, weight, contents) for an inbound plan (inbound_plan_id from create_inboun...

#### generate_packing_options

Generate packing options for an inbound plan (inbound_plan_id from create_inbound_plan). Creates plan state; call once b...

#### list_packing_options

List the generated packing options for an inbound plan (inbound_plan_id from create_inbound_plan; run generate_packing_o...

#### list_packing_group_items

List the items in a packing group (inbound_plan_id from create_inbound_plan; packing_group_id from a packing option's pa...

#### confirm_packing_option

Confirm the packing option to use for an inbound plan (inbound_plan_id from create_inbound_plan; packing_option_id from...

#### generate_placement_options

Generate placement options (which fulfilment centres the inventory will be placed at) for an inbound plan (inbound_plan\_...

#### list_placement_options

List the generated placement options for an inbound plan (inbound_plan_id from create_inbound_plan; run generate_placeme...

#### confirm_placement_option

Confirm where the inventory will be placed for an inbound plan (inbound_plan_id from create_inbound_plan; placement_opti...

#### generate_transportation_options

Generate transportation (carrier/mode/quote) options for a confirmed placement (inbound_plan_id from create_inbound_plan...

#### list_transportation_options

List the generated transportation options for an inbound plan (inbound_plan_id from create_inbound_plan; run generate_tr...

#### confirm_transportation_options

Confirm the chosen carrier/quote per shipment for an inbound plan (inbound_plan_id from create_inbound_plan; transportat...

#### generate_delivery_window_options

Generate delivery window options for a shipment (inbound_plan_id from create_inbound_plan; shipment_id from get_inbound\_...

#### list_delivery_window_options

List the generated delivery window options for a shipment (inbound_plan_id from create_inbound_plan; shipment_id from ge...

#### confirm_delivery_window_options

Confirm the delivery window for a shipment (inbound_plan_id from create_inbound_plan; shipment_id from get_inbound_plan;...

#### get_shipment

Fetch one inbound shipment (inbound_plan_id from create_inbound_plan; shipment_id from get_inbound_plan): its status, de...

#### list_shipment_items

List the items (MSKU, ASIN, FNSKU, quantity, prep) in an inbound shipment (inbound_plan_id from create_inbound_plan; shi...

#### update_shipment_tracking_details

Update carrier tracking on an inbound shipment (inbound_plan_id from create_inbound_plan; shipment_id from get_inbound_p...

#### get_inbound_operation_status

Poll the status of an asynchronous FBA inbound operation by operation_id (returned by every inbound create/cancel/set/ge...

#### list_inventory_summaries

List FBA (Fulfilled by Amazon) inventory summaries per SKU. granularity_type ('Marketplace'), granularity_id (a marketpl...

#### search_listings_items

Find a seller's own listings (status, offer, attributes, issues) for seller_id (your Merchant Token) and marketplace_ids...

#### patch_listings_item

Patch a listing's offer or content for a SKU (seller_id = Merchant Token; sku and product_type from search_listings_item...

#### get_listings_restrictions

Check whether the seller is approved to list an ASIN before trying (asin from search_catalog_items; seller_id = your Mer...

#### list_orders

List Amazon orders in marketplace_ids (required, e.g. \['ATVPDKIKX0DER'] for US). created_after or last_updated_after is...

#### get_order

Fetch one Amazon order by its AmazonOrderId: status, totals, fulfillment channel, ship dates, buyer/prime flags. Use lis...

#### list_order_items

List the line items of one Amazon order (ASIN, SellerSKU, title, quantity ordered/shipped, item price) by AmazonOrderId....

#### list_reports

List reports you have requested. report_types is required (e.g. \['GET_MERCHANT_LISTINGS_ALL_DATA']); optionally filter b...

#### create_report

Request a new report. report_type and marketplace_ids are required; optionally set a data_start_time/data_end_time windo...

#### get_report

Fetch one report by ID: processingStatus, data window, created time, and report_document_id once DONE. Use list_reports...

#### cancel_report

Cancel a report that is still IN_QUEUE or IN_PROGRESS by its report_id. A report already DONE or CANCELLED cannot be can...

#### list_report_schedules

List the report schedules configured for the given report_types (required), e.g. \['GET_MERCHANT_LISTINGS_ALL_DATA']. Eac...

#### create_report_schedule

Create a recurring report schedule. report_type, marketplace_ids and period are required; period is an ISO 8601 duration...

#### get_report_schedule

Fetch one report schedule by ID: report_type, period, marketplace_ids and next creation time. Use list_report_schedules...

#### cancel_report_schedule

Cancel (delete) a report schedule by its report_schedule_id so it stops generating reports. Use list_report_schedules to...

#### get_report_document

Fetch a report document by its report_document_id to get the presigned download url and its compressionAlgorithm (e.g. G...

#### get_order_metrics

See aggregated order metrics (units, order count, sales) over a date range for marketplace_ids. interval is 'start--end'...