NetSuite Ecommerce MCP Server

Create a powerful Model Context Protocol (MCP) server for NetSuite SuiteCommerce in minutes with our AI Gateway. This guide walks you through setting up seamless ecommerce integration with omnichannel capabilities and instant OAuth authentication.

About NetSuite SuiteCommerce API

NetSuite SuiteCommerce provides a complete ecommerce platform that unifies online, in-store, and mobile shopping experiences. It offers B2B and B2C capabilities with deep integration to NetSuite ERP, enabling real-time inventory, pricing, and customer data across all channels.

Key Capabilities

• Website Management: Multi-site ecommerce platform
• Product Catalog: Advanced product information management
• Shopping Experience: Personalized customer journeys
• Order Management: Unified order processing
• Customer Portal: Self-service capabilities
• Marketing Tools: Promotions and campaigns
• Mobile Commerce: Responsive design
• B2B Features: Account hierarchies and pricing

API Features

• Commerce API: Catalog and cart management
• Customer API: Account management
• Order API: Order processing
• OAuth 2.0: Secure authentication
• Search API: Product discovery
• Promotion API: Discount management
• Analytics API: Commerce insights
• Real-time Sync: Live inventory

What You Can Do with NetSuite Ecommerce MCP Server

The MCP server transforms SuiteCommerce API into a natural language interface, enabling AI agents to:

Catalog Management

• Product Management

  • "Create new product listing"
  • "Update product information"
  • "Manage product variants"
  • "Set product availability"

• Category Structure

  • "Create category hierarchy"
  • "Assign products to categories"
  • "Manage navigation menus"
  • "Set category rules"

• Digital Assets

  • "Upload product images"
  • "Manage videos"
  • "Create 360views"
  • "Organize media library"

Pricing & Promotions

• Price Management

  • "Set product pricing"
  • "Create price levels"
  • "Manage quantity breaks"
  • "Configure dynamic pricing"

• Promotions

  • "Create discount codes"
  • "Set up BOGO offers"
  • "Configure free shipping"
  • "Schedule flash sales"

• Customer Pricing

  • "Set customer-specific prices"
  • "Create contract pricing"
  • "Manage price lists"
  • "Apply volume discounts"

Shopping Experience

• Cart Management

  • "View abandoned carts"
  • "Send cart reminders"
  • "Apply discounts"
  • "Manage saved carts"

• Checkout Process

  • "Configure checkout flow"
  • "Set payment methods"
  • "Manage shipping options"
  • "Handle tax calculation"

• Personalization

  • "Show recommendations"
  • "Create wishlists"
  • "Track browsing behavior"
  • "Personalize content"

Order Management

• Order Processing

  • "Process new orders"
  • "Update order status"
  • "Handle cancellations"
  • "Manage returns"

• Fulfillment

  • "Create fulfillment requests"
  • "Generate shipping labels"
  • "Track packages"
  • "Handle dropshipping"

• Customer Communication

  • "Send order confirmations"
  • "Provide shipping updates"
  • "Handle inquiries"
  • "Process feedback"

Customer Management

• Account Management

  • "Create customer accounts"
  • "Manage profiles"
  • "Track purchase history"
  • "Handle preferences"

• B2B Features

  • "Manage account hierarchies"
  • "Set credit limits"
  • "Configure approval workflows"
  • "Handle purchase orders"

• Loyalty Programs

  • "Track loyalty points"
  • "Manage tiers"
  • "Apply rewards"
  • "Send member communications"

Omnichannel Commerce

• Channel Management

  • "Sync inventory across channels"
  • "Unified pricing"
  • "Consistent promotions"
  • "Cross-channel fulfillment"

• Store Integration

  • "Enable BOPIS"
  • "Ship from store"
  • "In-store returns"
  • "Endless aisle"

• Marketplace Integration

  • "List on marketplaces"
  • "Sync inventory"
  • "Manage orders"
  • "Update listings"

Analytics & Reporting

• Sales Analytics

  • "Track revenue metrics"
  • "Monitor conversion rates"
  • "Analyze cart abandonment"
  • "Measure AOV"

• Customer Analytics

  • "Segment customers"
  • "Track lifetime value"
  • "Analyze behavior"
  • "Monitor retention"

• Product Performance

  • "Best sellers report"
  • "Inventory velocity"
  • "Category performance"
  • "Search analytics"

Marketing Integration

• Email Marketing

  • "Trigger transactional emails"
  • "Send newsletters"
  • "Create campaigns"
  • "Track engagement"

• SEO Management

  • "Optimize URLs"
  • "Manage meta tags"
  • "Create sitemaps"
  • "Handle redirects"

• Social Commerce

  • "Share products"
  • "Enable social login"
  • "Track social traffic"
  • "User-generated content"

Prerequisites

• Access to Cequence AI Gateway
• NetSuite account with SuiteCommerce
• API access enabled
• Ecommerce administrator role

Step 1: Configure SuiteCommerce API Access

1.1 Enable Ecommerce Features

1. Go to Setup > Company > Enable Features
2. Under SuiteCommerce tab, enable:
   • SuiteCommerce
   • SuiteCommerce Advanced (if applicable)
   • Multiple Websites
   • Shopping Cart

1.2 Create Commerce Integration

1. Navigate to Setup > Integration > Manage Integrations
2. Create new integration:
   • Name: "AI Gateway Commerce Integration"
   • OAuth 2.0: Enabled
   • Commerce API: Enabled

1.3 Configure Permissions

Required permissions:

• Commerce Catalog: Full
• Commerce Orders: Full
• Commerce Customers: Full
• Commerce Marketing: Full

1.4 Save Credentials

Record:

• Client ID
• Client Secret
• Account ID
• Website ID

Step 2-4: Standard Setup

Follow standard steps to access AI Gateway, find NetSuite Ecommerce API, and create MCP server.

Step 5: Configure API Endpoints

1. Base URL: https://{accountId}.suitetalk.api.netsuite.com
2. Select endpoints:
   • Commerce endpoints
   • Catalog endpoints
   • Order endpoints
   • Customer endpoints
3. Click Next

Step 6: MCP Server Configuration

1. Name: "NetSuite Ecommerce"
2. Description: "SuiteCommerce platform integration"
3. Configure production mode
4. Click Next

Step 7: Configure Authentication

1. Authentication Type: OAuth 2.0
2. Configure OAuth URLs
3. Enter credentials
4. Set website context

Available NetSuite Ecommerce API Scopes

Commerce Operations

• Catalog Management

  • Products
  • Categories
  • Pricing
  • Inventory

• Order Processing

  • Shopping cart
  • Checkout
  • Payment
  • Fulfillment

Customer Experience

• Account Management

  • Registration
  • Profiles
  • Preferences
  • History

• Personalization

  • Recommendations
  • Wishlists
  • Recently viewed
  • Custom content

Marketing & Analytics

• Promotions

  • Discounts
  • Coupons
  • Campaigns
  • Loyalty

• Analytics

  • Traffic
  • Conversions
  • Revenue
  • Behavior

Recommended Scope Combinations

For Ecommerce Managers:

Catalog (Full)
Orders (Full)
Customers (Read)
Promotions (Full)
Analytics (Read)

For Marketing Teams:

Catalog (Read)
Promotions (Full)
Customers (Read)
Analytics (Full)
Content (Full)

Step 8-10: Complete Setup

Configure security, choose deployment, and deploy.

Using Your NetSuite Ecommerce MCP Server

With Claude Desktop

{
  "servers": {
    "netsuite-ecommerce": {
      "url": "your-mcp-server-url",
      "auth": {
        "type": "oauth2",
        "client_id": "your-client-id",
        "client_secret": "your-client-secret",
        "account_id": "your-account-id",
        "website_id": "your-website-id"
      }
    }
  }
}

Natural Language Commands

• "Create a 20% off promotion for the holiday sale"
• "Show me top selling products this month"
• "Update inventory for SKU-12345 across all channels"
• "Process pending orders from the last hour"
• "Generate abandoned cart recovery emails"

API Integration Example

// Initialize MCP client
const mcpClient = new MCPClient({
  serverUrl: 'your-mcp-server-url',
  auth: {
    type: 'oauth2',
    clientId: 'your-client-id',
    clientSecret: 'your-client-secret',
    accountId: 'your-account-id',
    websiteId: 'your-website-id'
  }
});

// Product management
const product = await mcpClient.netsuite.ecommerce.createProduct({
  displayName: 'Premium Wireless Headphones',
  itemId: 'WH-PREMIUM-001',
  category: 'Electronics/Audio/Headphones',
  description: {
    short: 'High-quality wireless headphones with noise cancellation',
    long: 'Experience premium audio with our flagship wireless headphones...'
  },
  pricing: {
    onlinePrice: 299.99,
    compareAtPrice: 399.99,
    cost: 125.00
  },
  images: [
    {
      url: 'https://cdn.example.com/wh-premium-001-main.jpg',
      alt: 'Premium Wireless Headphones - Main View',
      isPrimary: true
    }
  ],
  inventory: {
    quantityAvailable: 500,
    isInStock: true,
    trackInventory: true
  },
  attributes: {
    color: ['Black', 'Silver', 'Rose Gold'],
    batteryLife: '30 hours',
    connectivity: 'Bluetooth 5.0',
    features: ['Noise Cancellation', 'Touch Controls', 'Fast Charging']
  },
  seo: {
    pageTitle: 'Premium Wireless Headphones | Best Noise Cancelling',
    metaDescription: 'Shop our premium wireless headphones with 30-hour battery...',
    urlFragment: 'premium-wireless-headphones'
  }
});

console.log(`Created product: ${product.internalId}`);

// Create promotion
const promotion = await mcpClient.netsuite.ecommerce.createPromotion({
  name: 'Holiday Sale 2025',
  code: 'HOLIDAY25',
  type: 'percentageOff',
  value: 25,
  startDate: '2025-12-01',
  endDate: '2025-12-31',
  conditions: {
    minimumOrderValue: 100,
    customerGroups: ['all'],
    categories: ['Electronics', 'Home & Garden']
  },
  stackable: false,
  usageLimit: {
    perCustomer: 3,
    total: 1000
  }
});

// Shopping cart operations
const cart = await mcpClient.netsuite.ecommerce.getCart({
  sessionId: 'customer-session-123'
});

console.log(`\nShopping Cart:`);
console.log(`Items: ${cart.items.length}`);
console.log(`Subtotal: $${cart.subtotal}`);

// Add item to cart
const updatedCart = await mcpClient.netsuite.ecommerce.addToCart({
  sessionId: 'customer-session-123',
  item: {
    internalId: product.internalId,
    quantity: 2,
    options: {
      color: 'Black'
    }
  }
});

// Apply promotion
const cartWithPromo = await mcpClient.netsuite.ecommerce.applyPromotion({
  cartId: updatedCart.id,
  promoCode: 'HOLIDAY25'
});

console.log(`Discount Applied: $${cartWithPromo.discountAmount}`);
console.log(`New Total: $${cartWithPromo.total}`);

// Process checkout
const order = await mcpClient.netsuite.ecommerce.processCheckout({
  cartId: cartWithPromo.id,
  customer: {
    email: 'customer@example.com',
    firstName: 'John',
    lastName: 'Doe'
  },
  shippingAddress: {
    attention: 'John Doe',
    addressLine1: '123 Main St',
    city: 'San Francisco',
    state: 'CA',
    zip: '94105',
    country: 'US'
  },
  shippingMethod: 'standard',
  payment: {
    method: 'creditCard',
    cardNumber: '4111111111111111', // Test card
    expiryMonth: '12',
    expiryYear: '2027',
    cvv: '123'
  }
});

console.log(`\nOrder Created: ${order.tranId}`);
console.log(`Total: $${order.total}`);
console.log(`Status: ${order.status}`);

// Customer account management
const customer = await mcpClient.netsuite.ecommerce.createCustomerAccount({
  email: 'newcustomer@example.com',
  password: 'SecurePassword123!',
  firstName: 'Jane',
  lastName: 'Smith',
  company: 'ABC Corporation',
  emailPreferences: {
    marketing: true,
    transactional: true
  },
  b2bSettings: {
    isB2B: true,
    creditLimit: 10000,
    paymentTerms: 'Net 30',
    taxExempt: false
  }
});

// B2B features - create quote
const quote = await mcpClient.netsuite.ecommerce.createQuote({
  customer: customer.internalId,
  items: [
    {
      item: 'BULK-ITEM-001',
      quantity: 1000,
      requestedPrice: 45.00
    }
  ],
  expirationDate: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000),
  notes: 'Volume discount requested for annual contract'
});

// Abandoned cart recovery
const abandonedCarts = await mcpClient.netsuite.ecommerce.getAbandonedCarts({
  hoursAbandoned: 24,
  minimumValue: 50,
  hasEmail: true
});

console.log(`\nAbandoned Carts: ${abandonedCarts.length}`);
for (const cart of abandonedCarts) {
  console.log(`Cart ID: ${cart.id}`);
  console.log(`Customer: ${cart.customerEmail}`);
  console.log(`Value: $${cart.total}`);
  console.log(`Abandoned: ${cart.abandonedDate}`);
  
  // Send recovery email
  await mcpClient.netsuite.ecommerce.sendCartRecoveryEmail({
    cartId: cart.id,
    template: 'abandoned_cart_reminder',
    incentive: {
      type: 'percentage',
      value: 10,
      code: `SAVE10-${cart.id}`
    }
  });
}

// Product recommendations
const recommendations = await mcpClient.netsuite.ecommerce.getRecommendations({
  type: 'frequently_bought_together',
  productId: product.internalId,
  limit: 5
});

console.log('\nRecommended Products:');
for (const rec of recommendations) {
  console.log(`- ${rec.displayName}: $${rec.price}`);
  console.log(`  Confidence: ${rec.confidenceScore}%`);
}

// Inventory sync across channels
const inventorySync = await mcpClient.netsuite.ecommerce.syncInventory({
  items: ['WH-PREMIUM-001'],
  channels: ['website', 'amazon', 'retail_stores'],
  strategy: 'allocate_by_velocity'
});

console.log('\nInventory Allocation:');
for (const allocation of inventorySync.allocations) {
  console.log(`${allocation.channel}: ${allocation.quantity} units`);
}

// Analytics and reporting
const analytics = await mcpClient.netsuite.ecommerce.getAnalytics({
  metrics: [
    'revenue',
    'orders',
    'conversionRate',
    'averageOrderValue',
    'cartAbandonmentRate'
  ],
  period: 'last_30_days',
  compareToLastPeriod: true
});

console.log('\nEcommerce Performance:');
console.log(`Revenue: $${analytics.revenue.current.toLocaleString()} (${analytics.revenue.change > 0 ? '+' : ''}${analytics.revenue.change}%)`);
console.log(`Orders: ${analytics.orders.current} (${analytics.orders.change > 0 ? '+' : ''}${analytics.orders.change}%)`);
console.log(`Conversion Rate: ${analytics.conversionRate.current}% (${analytics.conversionRate.change > 0 ? '+' : ''}${analytics.conversionRate.change}pp)`);
console.log(`AOV: $${analytics.averageOrderValue.current} (${analytics.averageOrderValue.change > 0 ? '+' : ''}${analytics.averageOrderValue.change}%)`);

// SEO management
const seoUpdate = await mcpClient.netsuite.ecommerce.updateSEO({
  type: 'category',
  id: 'electronics',
  seo: {
    title: 'Electronics & Gadgets | Best Deals | Your Store',
    description: 'Shop the latest electronics and gadgets at unbeatable prices...',
    canonicalUrl: 'https://store.com/electronics',
    robots: 'index, follow',
    structuredData: {
      '@type': 'CollectionPage',
      name: 'Electronics',
      description: 'Our electronics collection'
    }
  }
});

// Customer segmentation
const segments = await mcpClient.netsuite.ecommerce.createCustomerSegment({
  name: 'High Value Customers',
  criteria: [
    {
      field: 'lifetimeValue',
      operator: 'greaterThan',
      value: 1000
    },
    {
      field: 'lastPurchase',
      operator: 'within',
      value: '90days'
    }
  ],
  actions: [
    {
      type: 'applyTag',
      value: 'VIP'
    },
    {
      type: 'setPriceLevel',
      value: 'vip_pricing'
    }
  ]
});

// Real-time monitoring
const monitor = await mcpClient.netsuite.ecommerce.startMonitoring({
  events: [
    'orderPlaced',
    'cartAbandoned',
    'lowInventory',
    'priceChange'
  ],
  thresholds: {
    inventoryLevel: 10,
    cartValue: 500
  }
});

monitor.on('event', async (event) => {
  console.log(`Commerce Event: ${event.type}`);
  console.log(`Details: ${JSON.stringify(event.data)}`);
  
  if (event.type === 'lowInventory') {
    await handleLowInventory(event.data);
  }
});

Common Use Cases

Online Store Management

• Product catalog maintenance
• Pricing and promotions
• Inventory synchronization
• Order processing

Customer Experience

• Personalization
• Loyalty programs
• Customer service
• Account management

B2B Commerce

• Account hierarchies
• Contract pricing
• Quote management
• Approval workflows

Omnichannel Operations

• Unified inventory
• Cross-channel fulfillment
• Consistent pricing
• Channel analytics

Security Best Practices

1. Data Security:

   • PCI compliance
   • Secure payment handling
   • Customer data protection
   • SSL certificates

2. Access Control:

   • Role-based permissions
   • API authentication
   • Session management
   • IP restrictions

3. Integration Security:

   • OAuth 2.0 only
   • Token encryption
   • Webhook validation
   • Rate limiting

Troubleshooting

Common Issues

1. Product Sync

   • Verify SKU mapping
   • Check categories
   • Review attributes
   • Validate pricing

2. Order Processing

   • Check payment gateway
   • Verify shipping methods
   • Review tax calculation
   • Test checkout flow

3. Performance Issues

   • Optimize queries
   • Use caching
   • Batch updates
   • Monitor API limits

Getting Help

• Documentation: AI Gateway Docs
• Support: support@cequence.ai
• NetSuite Help: help.netsuite.com

---