Skip to main content

Adobe Commerce MCP Server

Create a powerful Model Context Protocol (MCP) server for Adobe Commerce (formerly Magento) in minutes with our AI Gateway. This guide walks you through setting up seamless e-commerce integration with enterprise-grade security and instant OAuth authentication.

About Adobe Commerce API​

Adobe Commerce provides a flexible, scalable commerce platform with powerful APIs for managing products, orders, customers, and the entire e-commerce experience. The API enables full control over your online store operations.

Key Capabilities​

  • Product Management: Catalog, inventory, pricing
  • Order Processing: Orders, shipments, invoices
  • Customer Management: Accounts, addresses, segments
  • Cart & Checkout: Shopping cart, payment, shipping
  • Content Management: CMS pages, blocks, widgets
  • Marketing Tools: Promotions, rules, coupons
  • B2B Features: Companies, shared catalogs, quotes
  • Analytics: Sales reports, customer insights

API Features​

  • REST API: Comprehensive endpoints
  • GraphQL API: Flexible queries
  • Bulk API: Large-scale operations
  • Async API: Background processing
  • OAuth 2.0: Secure authentication
  • Webhooks: Real-time events
  • Integration API: Third-party connections
  • Admin API: Store management

What You Can Do with Adobe Commerce MCP Server​

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

Product Management​

  • Product Operations

    • "Create new product with variants"
    • "Update product prices by 10%"
    • "Import product catalog from CSV"
    • "Set product as out of stock"

  • Catalog Management

    • "Create category for summer collection"
    • "Move products to clearance category"
    • "Update category descriptions"
    • "Set category display rules"

  • Inventory Control

    • "Check stock levels for SKU"
    • "Update inventory quantities"
    • "Set low stock alerts"
    • "Transfer stock between warehouses"

Order Management​

  • Order Processing

    • "Show orders pending fulfillment"
    • "Create shipment for order"
    • "Generate invoice"
    • "Process refund request"

  • Order Search

    • "Find orders by customer email"
    • "List orders over $1000"
    • "Show canceled orders today"
    • "Search by payment method"

  • Fulfillment

    • "Create shipping labels"
    • "Update tracking information"
    • "Mark orders as shipped"
    • "Handle partial shipments"

Customer Management​

  • Customer Accounts

    • "Create customer account"
    • "Update customer information"
    • "Reset customer password"
    • "Merge duplicate accounts"

  • Customer Groups

    • "Create VIP customer group"
    • "Assign customers to groups"
    • "Set group pricing rules"
    • "Configure tax classes"

  • Customer Analytics

    • "Show customer purchase history"
    • "Calculate lifetime value"
    • "Identify repeat customers"
    • "Track customer segments"

Cart & Checkout​

  • Cart Management

    • "View abandoned carts"
    • "Send cart recovery emails"
    • "Apply coupon to cart"
    • "Calculate shipping rates"

  • Checkout Configuration

    • "Set payment methods"
    • "Configure shipping options"
    • "Update checkout fields"
    • "Enable guest checkout"

  • Quote Management

    • "Create quote for B2B customer"
    • "Negotiate pricing"
    • "Convert quote to order"
    • "Set quote expiration"

Marketing & Promotions​

  • Price Rules

    • "Create 20% off promotion"
    • "Set buy-one-get-one rule"
    • "Configure tiered pricing"
    • "Schedule flash sale"

  • Coupons

    • "Generate coupon codes"
    • "Set usage limits"
    • "Create customer-specific coupons"
    • "Track coupon usage"

  • Email Marketing

    • "Send promotional emails"
    • "Create newsletter"
    • "Segment email lists"
    • "Track email performance"

Analytics & Reporting​

  • Sales Reports

    • "Show daily sales summary"
    • "Generate revenue by category"
    • "Track bestselling products"
    • "Compare YoY performance"

  • Customer Reports

    • "New customer acquisition"
    • "Customer retention rate"
    • "Average order value"
    • "Purchase frequency"

  • Inventory Reports

    • "Low stock report"
    • "Product performance"
    • "Inventory valuation"
    • "Stock movement history"

Content Management​

  • CMS Pages

    • "Create landing page"
    • "Update homepage content"
    • "Add new blog post"
    • "Manage page hierarchy"

  • Blocks & Widgets

    • "Create promotional banner"
    • "Update footer content"
    • "Add product carousel"
    • "Configure dynamic blocks"

  • Media Management

    • "Upload product images"
    • "Organize media gallery"
    • "Optimize images"
    • "Create image variations"

B2B Features​

  • Company Management

    • "Create company account"
    • "Set credit limits"
    • "Manage company users"
    • "Configure approval rules"

  • Shared Catalogs

    • "Create custom catalog"
    • "Set company-specific pricing"
    • "Restrict product access"
    • "Configure category permissions"

  • Requisition Lists

    • "View requisition lists"
    • "Approve purchase requests"
    • "Set order thresholds"
    • "Track spending limits"

Prerequisites​

  • Access to Cequence AI Gateway
  • Adobe Commerce instance (Cloud or On-premise)
  • Admin access to Commerce Admin
  • API access enabled

Step 1: Configure Adobe Commerce API​

1.1 Access Admin Panel​

  1. Log in to Adobe Commerce Admin
  2. Navigate to System Extensions Integrations
  3. Click Add New Integration

1.2 Create Integration​

  1. Fill in integration details:
    • Name: "AI Gateway MCP Integration"
    • Email: Your admin email
    • Callback URL: 
      https://auth.aigateway.cequence.ai/v1/outbound/oauth/callback
    • Identity Link URL: Leave blank

1.3 Configure API Resources​

  1. Go to API tab
  2. Select resource access:
    • All for full access
    • Or select specific resources:
      • Catalog
      • Sales
      • Customers
      • Marketing
      • Content
      • Reports

1.4 Activate Integration​

  1. Save integration
  2. Click Activate
  3. Authorize the integration
  4. Copy the generated tokens:
    • Consumer Key (Client ID)
    • Consumer Secret
    • Access Token
    • Access Token Secret

Step 2-4: Standard Setup​

Follow standard steps to access AI Gateway, find Adobe Commerce API, and create MCP server.

Step 5: Configure API Endpoints​

  1. Base URL: https://your-store.com/rest
  2. Select Commerce endpoints:
    • Products endpoints
    • Orders endpoints
    • Customers endpoints
    • Cart endpoints
  3. Click Next

Step 6: MCP Server Configuration​

  1. Name: "Adobe Commerce Store"
  2. Description: "E-commerce platform management"
  3. Configure production mode
  4. Click Next

Step 7: Configure Authentication​

  1. Authentication Type: OAuth 2.0
  2. Store URL: Your Adobe Commerce URL
  3. Consumer Key: From integration
  4. Consumer Secret: From integration
  5. Access Token: From integration
  6. Access Token Secret: From integration

Available Adobe Commerce API Scopes​

Catalog Resources​

  • Products

    • Create, read, update, delete products
    • Manage product attributes
    • Handle product media
    • Control inventory

  • Categories

    • Manage category tree
    • Assign products
    • Set display settings
    • Configure permissions

Sales Resources​

  • Orders

    • View and manage orders
    • Process shipments
    • Create invoices
    • Handle refunds

  • Quotes

    • Manage shopping carts
    • B2B quote negotiation
    • Price adjustments
    • Quote conversion

Customer Resources​

  • Customers

    • Account management
    • Address books
    • Customer groups
    • Attributes

  • Company (B2B)

    • Company accounts
    • User hierarchy
    • Credit management
    • Approval workflows

Marketing Resources​

  • Promotions
    • Price rules
    • Cart rules
    • Coupons
    • Related products

For Order Management:

Sales
Customer
Catalog (read)
Directory

For Full Store Management:

All Resources

Step 8-10: Complete Setup​

Configure security, choose deployment, and deploy.

Using Your Adobe Commerce MCP Server​

With Claude Desktop​

{
  "servers": {
    "adobe-commerce": {
      "url": "your-mcp-server-url",
      "auth": {
        "type": "oauth1",
        "consumer_key": "your-consumer-key",
        "consumer_secret": "your-consumer-secret",
        "access_token": "your-access-token",
        "access_token_secret": "your-access-token-secret"
      }
    }
  }
}

Natural Language Commands​

  • "Show orders pending shipment"
  • "Update product price for SKU-123"
  • "Create 15% off coupon for VIP customers"
  • "Check inventory levels for top sellers"
  • "Generate sales report for last month"

API Integration Example​

// Initialize MCP client
const mcpClient = new MCPClient({
  serverUrl: 'your-mcp-server-url',
  auth: {
    type: 'oauth1',
    consumerKey: 'your-consumer-key',
    consumerSecret: 'your-consumer-secret',
    accessToken: 'your-access-token',
    accessTokenSecret: 'your-access-token-secret'
  }
});

// Create product
const product = await mcpClient.adobeCommerce.products.create({
  product: {
    sku: 'SUMMER-SHIRT-001',
    name: 'Summer Cotton T-Shirt',
    price: 29.99,
    status: 1,
    visibility: 4,
    type_id: 'configurable',
    attribute_set_id: 4,
    weight: 0.5,
    extension_attributes: {
      category_links: [
        { position: 0, category_id: '5' }
      ],
      stock_item: {
        qty: 100,
        is_in_stock: true,
        manage_stock: true
      }
    },
    custom_attributes: [
      { attribute_code: 'description', value: 'Comfortable cotton t-shirt' },
      { attribute_code: 'color', value: '49' },
      { attribute_code: 'size', value: '168' }
    ]
  }
});

// Process order
const order = await mcpClient.adobeCommerce.orders.get({
  orderId: '000000145'
});

// Create shipment
const shipment = await mcpClient.adobeCommerce.shipments.create({
  orderId: order.entity_id,
  items: order.items.map(item => ({
    order_item_id: item.item_id,
    qty: item.qty_ordered
  })),
  tracks: [
    {
      track_number: '1Z999AA10123456784',
      title: 'UPS Ground',
      carrier_code: 'ups'
    }
  ]
});

// Create price rule
const priceRule = await mcpClient.adobeCommerce.catalogRules.create({
  name: 'Summer Sale 20% Off',
  description: '20% off all summer collection',
  is_active: true,
  website_ids: [1],
  customer_group_ids: [0, 1, 2, 3],
  from_date: '2025-06-01',
  to_date: '2025-08-31',
  sort_order: 0,
  simple_action: 'by_percent',
  discount_amount: 20,
  stop_rules_processing: false,
  conditions: {
    condition: 'combine',
    aggregator: 'all',
    value: true,
    conditions: [
      {
        condition: 'product',
        attribute: 'category_ids',
        operator: '==',
        value: '15'
      }
    ]
  }
});

// Search customers
const customers = await mcpClient.adobeCommerce.customers.search({
  searchCriteria: {
    filter_groups: [
      {
        filters: [
          {
            field: 'email',
            value: '%@example.com',
            condition_type: 'like'
          }
        ]
      }
    ],
    page_size: 20
  }
});

// Update inventory
await mcpClient.adobeCommerce.inventory.update({
  sourceItems: [
    {
      sku: 'SUMMER-SHIRT-001',
      source_code: 'default',
      quantity: 150,
      status: 1
    }
  ]
});

Common Use Cases​

E-commerce Operations​

  • Order fulfillment automation
  • Inventory synchronization
  • Price management
  • Customer service

Marketing Automation​

  • Promotional campaigns
  • Email marketing
  • Customer segmentation
  • Personalization

B2B Commerce​

  • Company account management
  • Custom pricing
  • Quote negotiation
  • Approval workflows

Analytics & Insights​

  • Sales reporting
  • Customer analytics
  • Product performance
  • Marketing ROI

Security Best Practices​

  1. API Security:

    • Use API tokens over passwords
    • Implement IP whitelisting
    • Monitor API usage
    • Rotate credentials regularly

  2. Data Protection:

    • Encrypt sensitive data
    • Implement PCI compliance
    • Audit access logs
    • Use secure connections

  3. Access Control:

    • Limit API permissions
    • Use role-based access
    • Monitor admin actions
    • Review integrations

Troubleshooting​

Common Issues​

  1. Authentication Errors

    • Verify API credentials
    • Check integration status
    • Validate permissions
    • Review token expiration

  2. API Errors

    • Check endpoint URLs
    • Verify request format
    • Review rate limits
    • Validate data types

  3. Performance Issues

    • Use pagination
    • Implement caching
    • Optimize queries
    • Monitor indexing

Getting Help​