Elastic Path Composable Commerce MCP Server

Connect your AI assistant to Elastic Path Composable Commerce with comprehensive access to your entire e-commerce platform. This server provides tools spanning every core service — order management, product catalog, catalog views, pricing, promotions, currencies, custom data extensions, cart operations, and advanced analytics — through the Model Context Protocol.

What You Get

• Complete Commerce Platform: Tools covering every major service - orders, products, catalog views, pricing, promotions, currencies, data extensions, carts, accounts, and analytics
• Product Management: Full PIM capabilities with hierarchies, attributes, and catalog management
• Catalog Views: Storefront-ready product browsing with published catalogs, categories, and search
• Pricing Control: Pricebooks, modifiers, volume pricing, and currency management
• Marketing Tools: Promotion creation, rule management, and campaign tracking
• Custom Extensions: Create custom APIs, fields, and data structures for your unique needs
• Advanced Analytics: Deep insights into sales performance, trends, and customer behavior
• Real-time Operations: Direct access to live EPCC data and operations across all services
• Secure Access: Your EPCC credentials stay private and are never shared
• Easy Setup: Configure once, access everything

Quick Setup

Installation

Option 1: NPX (Recommended - No Install)

Add to your MCP client configuration (configuration location and format may vary by client):

{
  "mcpServers": {
    "epcc-commerce": {
      "command": "npx",
      "args": ["-y", "@elasticpath/elasticpath-mcp"],
      "env": {
        "EPCC_CLIENT_ID": "your-epcc-client-id",
        "EPCC_CLIENT_SECRET": "your-epcc-client-secret",
        "EPCC_BASE_URL": "https://useast.api.elasticpath.com"
      }
    }
  }
}

To upgrade: The latest version will be automatically fetched on restart of your MCP client. To use a specific version, add @version to the package name (e.g., @elasticpath/[email protected]).

Option 2: Global Install

Install the package globally:

npm install -g @elasticpath/elasticpath-mcp

Add to your MCP client configuration:

{
  "mcpServers": {
    "epcc-commerce": {
      "command": "elasticpath-mcp",
      "env": {
        "EPCC_CLIENT_ID": "your-epcc-client-id",
        "EPCC_CLIENT_SECRET": "your-epcc-client-secret",
        "EPCC_BASE_URL": "https://useast.api.elasticpath.com"
      }
    }
  }
}

To upgrade: Run npm install -g @elasticpath/elasticpath-mcp@<version> with the desired version and restart your MCP client.

Option 3: From Source

For development or customization:

git clone <repository-url>
cd elasticpath-mcp
npm install
npm run build

Add to your MCP client configuration:

{
  "mcpServers": {
    "epcc-commerce": {
      "command": "node",
      "args": ["/absolute/path/to/elasticpath-mcp/dist/src/local.js"],
      "env": {
        "EPCC_CLIENT_ID": "your-epcc-client-id",
        "EPCC_CLIENT_SECRET": "your-epcc-client-secret",
        "EPCC_BASE_URL": "https://useast.api.elasticpath.com"
      }
    }
  }
}

Get Your EPCC Credentials

You'll need your EPCC application credentials:

• Client ID: Found in your EPCC application settings
• Client Secret: The secret key for your EPCC application

Test It Out

Restart your MCP client and try asking:

• "Show me order metrics for the last 30 days in USD"
• "Get me the details for order ABC123"
• "Show me all products in the Electronics hierarchy"
• "Create a 15% discount promotion for Black Friday"
• "What's the current USD to EUR exchange rate?"
• "Create a custom API for product reviews"

What You Can Ask

Order Management

Get order details, create new orders, and track order status:

Get details for order 12345
Show me all orders from last week
Create a new order for customer abc123

Cart Operations

Manage shopping carts throughout the customer journey:

Create a new cart named "Holiday Shopping"
Add 3 units of product XYZ to cart ABC
Apply promotion code "SAVE20" to cart ABC
Show me all active carts
Checkout cart 789 with customer details

Product Management (PIM)

Comprehensive product catalog and hierarchy management:

Get product details for SKU ABC123
Create a new product in the Electronics category
Show me all products in the Clothing hierarchy
Update product attributes and descriptions
Get all PIM job statuses

Catalog View (Storefront)

Browse published catalogs with customer-facing pricing and navigation:

Show me all published catalogs
Get products from the main storefront catalog
Search for "smartphone" in the electronics catalog
Show me the Electronics category and its subcategories
Get all products in the Clothing/Shirts category
Show me the breadcrumb path for product ABC123

Pricing & Pricebooks

Advanced pricing strategies and volume discounts:

Show me all pricebooks and their product counts  
Create a volume pricing tier for bulk orders
Add price modifiers for seasonal discounts
Get current pricing for product SKU-789

Promotions & Marketing

Campaign creation and rule management:

Get all active promotions
Create a 10% off promotion for category Electronics
Update promotion rules and conditions
Show promotion performance metrics

Currency Management

Multi-currency support and exchange rates:

List all available currencies
What's the current USD to EUR exchange rate?
Update exchange rates for GBP
Create a new currency configuration

Custom APIs

Custom APIs and flexible data structures:

Create a custom API for product reviews
Add rating and comment fields to reviews API
Show all custom APIs in the system
Create a customer loyalty points system

Payment & Transaction Processing

Handle payments, refunds, and transaction tracking:

Show all transactions for order 12345
Refund $50 from transaction TX789
Show payment status for order ABC

Sales Analytics

Get comprehensive metrics and insights:

Show me order summary for Q1 2024 in USD
Show daily order counts for the last 2 weeks
Show hourly revenue trends for Black Friday in USD
Show weekly discount amounts for December in EUR

Available Tools

Tools are organized by Elastic Path domain and follow a predictable <action>_<resource> naming convention (e.g., get_orders, create_pim_product, update_rule_promotion). Your MCP client automatically lists every available tool with its full description and input schema — that listing is always the source of truth for the current tool set.

| Domain | What you can do | |---|---| | Orders & Carts | List, inspect, and create orders; manage carts and cart items; apply and remove promotion codes; checkout carts; view transactions and process refunds | | Analytics & Data Warehouse | Order metrics summaries and count, value, and discount time series | | Product Information Management (PIM) | Manage products, hierarchies, and nodes; product-to-node assignments and reverse lookups; build child products; monitor import/export jobs | | Catalog View | Storefront-ready access to published catalogs: browse and search products, hierarchies, nodes, and breadcrumbs with customer-facing pricing and availability | | Pricebooks & Pricing | Manage pricebooks, product prices (including volume tiers), and price modifiers; replicate pricebooks | | Promotions & Marketing | List, inspect, create, and update Rule Promotions; list and create their promotion codes | | Currency Management | Manage currency configurations and look up currencies by ISO code | | Custom APIs (Data Extensions) | Manage custom API definitions, fields, and entries; access entries by slug | | Accounts | Manage accounts, addresses, members, memberships, tags, and user authentication info | | Store Setup | Guided store bootstrap helpers (disabled unless explicitly enabled) |

To browse the full tool list outside an MCP client, run the MCP inspector: npm run debug:build.

Important Notes for Analytics:

• All timestamps are in UTC timezone
• Monetary values are returned in smallest currency subunits (cents for USD/CAD, pence for GBP, etc.)
• The server automatically converts values for display (e.g., 155860 subunits = CAD 1,558.60)

Configuration Details

Required Settings

| Setting | Description | Example | |---------|-------------|---------| | EPCC_CLIENT_ID | Your EPCC application client ID | abc123def456 | | EPCC_CLIENT_SECRET | Your EPCC application secret | secret_xyz789 | | EPCC_BASE_URL | Your EPCC API endpoint | https://useast.api.elasticpath.com |

Configuration Methods

MCP Client Configuration (Recommended) Your MCP client handles all environment setup. Add the credentials to your client's configuration file as shown in the Installation section above. Most MCP clients follow a similar JSON configuration format.

Local Development Only If you're developing or testing the server directly (outside of an MCP client), create a .env file:

cp .env.example .env
# Edit .env with your credentials

Response Format Options

Many tools support parameters to control the shape and size of responses, helping you manage context tokens:

| Parameter | Values | Description | |-----------|--------|-------------| | output_format | friendly (default), raw | Controls how output is formatted. Friendly returns human-readable text; raw returns JSON. | | detail_level | concise (default), full | Controls how much data is returned. Concise includes essential fields; full includes all fields. |

Available combinations:

• Friendly format (default): Human-readable text, always concise
• Raw + concise: Reduced JSON with essential fields only
• Raw + full: Complete JSON with all fields from the API

The detail_level parameter only applies when output_format is set to raw. Friendly format is always concise by design.

How It Works

1. Authentication: The server automatically authenticates with EPCC using your credentials
2. Token Management: Access tokens are refreshed automatically as needed
3. Query Processing: Your questions are converted to EPCC Data Warehouse API calls
4. Data Formatting: Results are formatted for easy reading

Troubleshooting

Tools don't appear in my client

• Check that your MCP client configuration is valid JSON
• Verify the path to dist/src/local.js is correct
• Make sure you've run npm run build

"EPCC is not configured" error

• Double-check your EPCC_CLIENT_ID, EPCC_CLIENT_SECRET, and EPCC_BASE_URL
• Ensure your EPCC application has the necessary permissions

"No data returned" responses

• Verify your date ranges use the correct format (RFC3339 with milliseconds)
• Check that you have data for the requested time period
• Ensure your EPCC client has access to the Data Warehouse service

Connection timeouts

• Your EPCC application may need Data Warehouse API access enabled
• Check your EPCC application's rate limits

Development

Build the server:

npm run build

Run with debugging:

npm run debug

Watch mode for development:

npm run dev

Requirements

• Node.js 18 or later
• An EPCC account with Data Warehouse access
• MCP-compatible client (such as Claude Desktop, Continue, or any client supporting the Model Context Protocol)

Made for the EPCC community. Questions? Open an issue or contribute improvements.

Additional Resources

• Elastic Path Composable Commerce Documentation - Official EPCC API documentation
• Model Context Protocol - MCP specification and guides
• EPCC Developer Portal - Implementation guides and tutorials