# Elastic Path MCP

> Elastic Path allows your AI agent to manage complex headless commerce workflows directly from natural language prompts. You can inspect default customer carts, track detailed purchase histories, retrieve store navigation structures, and verify account details without ever logging into a dashboard.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** commerce-api, cart-management, headless-commerce, retail-tech, api-orchestration

## Description

This MCP connects your AI client directly to the data powering modern e-commerce sites. Forget jumping between separate dashboards just to answer a customer question or test a flow. You can ask your agent to check a user's default profile or pull up all the line items from a specific purchase ID, and it handles the whole thing. It lets you understand the full context of a shopper—what they put in their cart, what countries are supported, and if their account details are correct.

It’s built for developers who need to inspect API responses or support staff needing instant data retrieval. By connecting this MCP through Vinkius, your agent gets access to all these commerce tools, allowing you to manage everything from initial site discovery to final order status using only plain language.

## Tools

### create_token
Authenticates your agent and generates a secure OAuth2 token needed to access data.

### get_searches
Gets the configuration and entry points used by the site's search functionality for a given scope.

### get_account
Reads specific details about an existing user account for a given scope.

### get_countries
Lists all supported geographies or countries associated with your store's scope.

### get_default_cart
Retrieves the contents of a user's default shopping cart for a specific storefront area.

### get_default_profile
Reads the basic profile information and metadata for a defined scope.

### get_navigations
Fetches the main navigational entry points and structures used on the storefront.

### get_purchase
Returns comprehensive details about a specific order, including its status, total value, and all line items.

### get_registration_form
Retrieves the necessary fields required for creating a new user account within a scope.

## Prompt Examples

**Prompt:** 
```
Show me the default cart for the 'mobee' scope.
```

**Response:** 
```
I've retrieved the default cart for 'mobee'. It currently contains 3 items with a total value of $145.00. Would you like to see the specific line items?
```

**Prompt:** 
```
What is the status of purchase ID '12345' in the 'mobee' scope?
```

**Response:** 
```
The purchase '12345' is marked as 'COMPLETE'. The transaction was finalized on Oct 24th for a total of $89.99.
```

**Prompt:** 
```
List the available countries for our store scope.
```

**Response:** 
```
I've fetched the supported geographies. Your store currently supports shipping and billing in 5 countries: USA, Canada, UK, Germany, and France.
```

## Capabilities

### Check customer cart contents
Reads the default shopping cart for a specified store scope.

### Track purchase details and history
Retrieves specific order data, including status, total costs, and every item purchased.

### View user account information
Reads a customer's profile or retrieves the necessary form fields for registration.

### Determine store capabilities
Finds supported countries, navigation entry points, and general search configurations for a storefront.

## Use Cases

### A customer asks about an old order.
The support agent simply tells the AI: 'What's the status of purchase ID 987?' The agent uses get_purchase, and instead of making the user wait while the agent switches between ERP and commerce dashboards, a full report pops up showing if the transaction was COMPLETE or FAILED.

### A developer needs to verify cart rules.
The dev types: 'Show me what items are in the default cart for scope XYZ.' The agent uses get_default_cart, confirming that the correct tax rates and discount logic are applied before writing the checkout microservice. This saves hours of manual testing.

### A marketing team is launching internationally.
The manager asks: 'Which countries should we support for this market?' The agent uses get_countries, confirming that only USA and Canada are available for billing, preventing the site from showing incorrect options to users.

### A user needs a new account.
The agent runs get_registration_form. This immediately provides the required metadata fields needed by the support team—like specific phone number formats or mandatory legal agreements—so they can guide the customer through sign-up accurately.

## Benefits

- Instantly resolve customer questions. Instead of asking a user to send screenshots, you can ask your agent to run the get_purchase tool with an ID; it returns the complete order status, totals, and line items immediately.
- Keep developers focused on code, not APIs. Use the get_default_cart or get_navigations tools to test complex data structures directly from your chat interface, simulating a live user session without writing boilerplate API calls.
- Manage global operations easily. Quickly verify supported markets by calling get_countries, ensuring that both shipping and billing are configured correctly before launching in a new region.
- Better support experience across multiple systems. With the get_account tool, you can pull up key customer metadata or use get_default_profile to confirm user status without ever leaving your helpdesk window.
- Streamline site discovery. You don't have to manually check every corner of the store setup. Use get_searches and get_navigations to understand how a shopper actually finds content, improving troubleshooting speed.

## How It Works

The bottom line is: you get instant, deep access to structured e-commerce data through simple chat commands.

1. Subscribe to this MCP and provide your Elastic Path Cortex URL along with an Access Token.
2. Connect the credentials in your preferred AI client (Claude, Cursor, etc.).
3. Ask your agent a question about commerce data—for example, 'What was the status of purchase ID X' or 'Show me the default cart for scope Y'.

## Frequently Asked Questions

**How does Elastic Path MCP get purchase details?**
The get_purchase tool retrieves detailed purchase information, including the status (COMPLETE or FAILED), total costs, and all line items. You just need to provide a specific Purchase ID.

**Can I use Elastic Path MCP for cart management?**
Yes, you can read the default shopping cart using the get_default_cart tool. This allows your agent to tell you exactly what items are currently in the user's basket.

**What if I need account metadata for a new user?**
You use the get_registration_form tool. It retrieves all the necessary fields and data points required to set up a new profile, ensuring nothing is missed during signup.

**Does Elastic Path MCP help with site navigation testing?**
The get_navigations tool allows you to fetch the main entry points for your store. This is crucial for developers who need to map out how users move through the site structure.

**Is this MCP suitable for multi-country operations?**
Absolutely. The get_countries tool lets you check supported geographies, making it easy to confirm if a customer's location is valid for billing or shipping right away.

**Can I check the status of a specific purchase using its ID?**
Yes! Use the `get_purchase` tool with the store scope and purchase ID. It will return the status (such as COMPLETE or FAILED), order totals, and a list of items.

**How do I retrieve the navigation structure for my storefront?**
Simply use the `get_navigations` tool providing your store scope. This will fetch the entry points for your store's categories and links.

**Is it possible to see the default cart for a specific scope?**
Yes, the `get_default_cart` tool allows you to read the default cart for any specified scope, including optional zoom parameters for linked data.