Amazon Selling Partner Integration

The Amazon Selling Partner integration provides access to manage Amazon Selling Partner search catalog items, list orders, get order, list inventory, list listings through the Integrate MCP server.

Installation

The Amazon Selling Partner integration is included with the SDK:

import { amazonIntegration } from "integrate-sdk/server";

Setup

1. Create an Amazon Selling Partner OAuth App

1. Create an OAuth application for Amazon Selling Partner
2. Configure your redirect URI
3. Note your Client ID and Client Secret

2. Configure the Integration on Your Server

Add the Amazon Selling Partner integration to your server configuration. The integration automatically reads AMAZON_CLIENT_ID and AMAZON_CLIENT_SECRET from your environment variables:

import { createMCPServer, amazonIntegration } from "integrate-sdk/server";
 
export const { client: serverClient } = createMCPServer({
  apiKey: process.env.INTEGRATE_API_KEY,
  integrations: [
    amazonIntegration({
      scopes: ["sellingpartnerapi::notifications", "sellingpartnerapi::migration"], // Optional
    }),
  ],
});

You can override the environment variables by passing explicit values:

amazonIntegration({
  clientId: process.env.CUSTOM_AMAZON_ID,
  clientSecret: process.env.CUSTOM_AMAZON_SECRET,
      scopes: ["sellingpartnerapi::notifications", "sellingpartnerapi::migration"], // Optional
});

3. Client-Side Usage

The default client automatically includes all integrations. You can use it directly:

import { client } from "integrate-sdk";
 
await client.authorize("amazon");
const result = await client.amazon.searchCatalogItems({});
 
console.log(result);

If you're using a custom client, add the integration to the integrations array:

import { createMCPClient, amazonIntegration } from "integrate-sdk";
 
const customClient = createMCPClient({
  integrations: [amazonIntegration()],
});

Configuration Options

export interface AmazonIntegrationConfig {
  clientId?: string;

Default Scopes

These defaults are applied unless you override scopes in the integration config:

• sellingpartnerapi::notifications
• sellingpartnerapi::migration

Tools

amazon_search_catalog_items

Search catalog items

export interface AmazonSearchCatalogItemsParams { "marketplaceIds"?: string;

amazon_list_orders

List orders

export interface AmazonListOrdersParams { "MarketplaceIds"?: string;

amazon_get_order

Get order

export interface AmazonGetOrderParams { order_id: string }

amazon_list_inventory

List inventory

export interface AmazonListInventoryParams { "marketplaceIds"?: string;

amazon_list_listings

List listings

export interface AmazonListListingsParams { seller_id: string;

amazon_patch_listing

Patch listing

export interface AmazonPatchListingParams { seller_id: string;

Notes

• Category: Commerce
• Authentication mode: OAuth