Skip to main content

NetSuite Ecommerce MCP server

NetSuite SuiteCommerce is a complete ecommerce platform delivering B2B and B2C capabilities with seamless integration to inventory, pricing, and customer data. An AI agent using this MCP server can manage product catalogs, create and update orders, configure promotions, manage customer accounts, and execute omnichannel fulfillment—automating store operations and enabling teams to respond to customer needs in real time. Use this integration when you need to sync inventory across channels, process orders, manage pricing and promotions, or provide customers with self-service capabilities.

Setting up an MCP server

This article covers the standard steps for creating an MCP server in AI Gateway and connecting it to an AI client. The steps are the same for every integration — application-specific details (API credentials, OAuth endpoints, and scopes) are covered in the individual application pages.

Before you begin

You'll need:

  • Access to AI Gateway with permission to create MCP servers
  • API credentials for the application you're connecting (see the relevant application page for what to collect)

Create an MCP server

Find the API in the catalog

  1. Sign in to AI Gateway and select MCP Servers from the left navigation.
  2. Select New MCP Server.
  3. Search for the application you want to connect, then select it from the catalog.

Configure the server

  1. Enter a Name for your server — something descriptive that identifies both the application and its purpose (for example, "Zendesk Support — Prod").
  2. Enter a Description so your team knows what the server is for.
  3. Set the Timeout value. 30 seconds works for most APIs; increase to 60 seconds for APIs that return large payloads.
  4. Toggle Production mode on if this server will be used in a live workflow.
  5. Select Next.

Configure authentication

Enter the authentication details for the application. This varies by service — see the Authentication section of the relevant application page for the specific credentials, OAuth URLs, and scopes to use.

Configure security

  1. Set any Rate limits appropriate for your use case and the API's own limits.
  2. Enable Logging if you want AI Gateway to record requests and responses for auditing.
  3. Select Next.

Deploy

Review the summary, then select Deploy. AI Gateway provisions the server and provides a server URL you'll use when configuring your AI client.


Connect to an AI client

Once your server is deployed, you'll need to add it to the AI client your team uses. Select your client for setup instructions:

Tips

  • You can create multiple MCP servers for the same application — for example, a read-only server for reporting agents and a read-write server for automation workflows.
  • If you're unsure which OAuth scopes to request, start with the minimum read-only set and add write scopes only when needed. Most application pages include scope recommendations.
  • You can edit a server's name, description, timeout, and security settings after deployment without redeploying.

Authentication

NetSuite SuiteCommerce uses OAuth 2.0 authentication with account-specific endpoints. Create an integration record in NetSuite under Setup > Integration > Manage Integrations, enable OAuth 2.0 and Commerce API access, and collect your Client ID and Client Secret. The OAuth token URL is https://{accountId}.suitetalk.api.netsuite.com/services/rest/auth/oauth2/v1/token and the authorization URL is https://{accountId}.app.netsuite.com/app/login/oauth2/authorize.nl, where {accountId} is your NetSuite account ID. Required scopes include catalog management, order processing, customer account management, and promotions depending on your storefront needs.

Available tools

The MCP server enables AI agents to manage all aspects of ecommerce operations including catalog, pricing, orders, and customer experience. Tools are organized by commerce function.

Product Catalog Management

ToolDescription
Create productAdd a new product to the catalog with details and availability
Update productModify product name, description, images, or availability
Get product detailsRetrieve product information including pricing and inventory
Create categorySet up a product category or subcategory
Update categoryModify category structure and product assignments

Pricing and Promotions

ToolDescription
Set product priceConfigure standard or tiered pricing for a product
Create promotionSet up a discount, BOGO, or free shipping promotion
Update promotionModify promotion details, dates, or terms
Create discount codeGenerate a coupon or promo code for customers
Get active promotionsRetrieve current promotions and their eligibility rules

Order Management

ToolDescription
Create orderProcess a new customer order (web or B2B)
Get order detailsRetrieve order information, items, and status
Update order statusChange order fulfillment status (e.g., processing to shipped)
Create returnInitiate a return or RMA process
Get order historyRetrieve past orders for a customer

Customer Account Management

ToolDescription
Create customer accountRegister a new customer in the ecommerce platform
Get customer detailsRetrieve customer profile and preferences
Update customer profileModify customer address, payment method, or preferences
Get purchase historyRetrieve customer orders and purchase patterns

Inventory and Fulfillment

ToolDescription
Check inventoryGet product availability across locations
Sync inventoryUpdate inventory levels across channels
Create shipmentGenerate shipping documents and labels
Update fulfillmentTrack shipment status and delivery

Tips

Sync inventory across all sales channels (web, mobile, in-store, marketplace) through the agent in near-real time — stale inventory data causes overselling and customer frustration.

Create dynamic pricing rules (e.g., "10% off for loyalty members" or "free shipping on orders over $100") and have the agent enforce them at checkout to improve conversion without manual override.

Set up product bundles and frequently-bought-together recommendations in NetSuite, then have the agent suggest them during checkout to increase average order value.

Automate order fulfillment routing — when an order arrives, the agent can check inventory across warehouses and route to the nearest location or eligible fulfillment center.

Monitor cart abandonment through scheduled agent queries. Identify high-value abandoned carts and have the agent trigger recovery emails with tailored offers.