# Elastic Path MCP for AI Agents AI Agent Connect

> Elastic Path lets you manage headless commerce workflows using natural language. You can inspect carts, track purchase statuses, and grab store navigation data directly through your AI agent. It connects your commerce engine to your agent so you can handle store operations without switching tabs.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_cqkH73YKKwothRflCrERYMPr9uQFROjtKa8g2AyG/ai-agent-connect
- **Tags:** commerce-api, cart-management, headless-commerce, retail-tech, api-orchestration

## Description

Dealing with headless commerce usually means jumping between different dashboards to check a customer's cart or find a specific order ID. This Connector changes that. By connecting your Elastic Path commerce engine to your AI agent, you can just ask questions to get the data you need. You can pull up a user's profile to see their history, check if a purchase actually went through, or find out which countries your store currently supports. It handles the heavy lifting of interacting with the Cortex API so you can focus on the actual work. Whether you're a developer testing store structures or a support lead helping a frustrated customer, it makes getting commerce data a conversation rather than a manual search. You'll find it's a lot faster to just tell your agent what to do than to hunt for the right page in a complex admin panel. You can find this and thousands of other tools in the Vinkius catalog to keep your stack connected.

## Tools

### create_token
Generates an OAuth2 token to authenticate your connection. This allows your agent to securely access your commerce data.

### get_countries
Lists the countries and geographies supported by a scope. It's the fastest way to verify regional shipping settings.

### get_default_cart
Retrieves the primary cart data for a specific scope. Use this to see what items are currently in a store's basket.

### get_default_profile
Fetches the default user profile information for a scope. This provides context on default account settings.

### get_registration_form
Fetches the account registration form for a given scope. Use this to see exactly what data you need for new signups.

### get_searches
Pulls the search entry points for a specific store scope. Use this to see how your storefront handles search queries.

### get_navigations
Gets the navigation entry points for a specific store scope. It helps you understand the storefront's layout and links.

### get_purchase
Returns the status, totals, and line items for a specific purchase ID. It's perfect for quickly checking order details.

### get_account
Reads the details of a specific user account. It helps you quickly view customer data for support or management.

## Prompt Examples

**Prompt:** 
```
What's the status of order 99887 in the 'retail' scope?
```

**Response:** 
```
The order **99887** in the 'retail' scope is marked as **COMPLETE**. Here are the details:

*   **Total:** $142.50
*   **Status:** Completed on Oct 24
*   **Items:**
    *   Leather Boots (x1)
    *   Wool Socks (x2)

Would you like to see the shipping details for this order?
```

**Prompt:** 
```
List the countries we ship to for the 'global' scope.
```

**Response:** 
```
Your store currently supports shipping and billing in the following **5 countries** for the 'global' scope:

*   USA
*   Canada
*   UK
*   Germany
*   France
```

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

**Response:** 
```
I've pulled the default cart for the 'test' scope. It currently contains **2 items** with a total value of **$50.00**.

Would you like me to list the specific line items in this cart?
```

## Capabilities

### Fetch default carts
See what's currently in a store's primary shopping basket.

### Track purchase history
Get real-time status and totals for specific orders.

### Explore store navigation
Pull entry points and search settings for your storefront.

### View user profiles
Access registration data and account metadata for specific scopes.

### Check supported countries
See which regions are eligible for shipping and billing.

### Inspect registration forms
Pull the fields and data needed for new account signups.

## Use Cases

### Checking a failed order
A support rep asks, "What happened with order 12345?" The agent uses get_purchase to show it failed and lists the items.

### Verifying store regions
A manager asks, "Which countries do we ship to?" The agent uses get_countries to list the supported locations for that scope.

### Inspecting cart data
A dev asks, "What's in the default cart for the mobee scope?" The agent uses get_default_cart to return the items and total.

### Reviewing registration
A developer needs to see the signup fields and uses get_registration_form to check the requirements for a new store.

## Benefits

- Stop hunting for orders. Use get_purchase to see totals and status (COMPLETE/FAILED) instantly without opening a browser.
- Speed up support. Use get_account and get_default_profile to get customer context in one go for faster ticket resolution.
- Simplify store audits. Use get_navigations and get_searches to see how your storefront is organized and structured.
- Verify regional settings. Use get_countries to quickly check supported shipping locations for any specific store scope.
- Test commerce flows. Use get_default_cart and get_registration_form to inspect store defaults and signup requirements.

## How It Works

The bottom line is you get a natural language interface for your commerce engine.

1. Subscribe to the Elastic Path MCP on Vinkius.
2. Provide your Elastic Path Cortex URL and your Access Token in the setup.
3. Ask your AI client to check orders, carts, or store settings.

## Frequently Asked Questions

**Can I use the Elastic Path MCP to check my store's shipping regions?**
Yes. You can ask your agent to list the supported countries for any specific scope. It will quickly tell you which regions are eligible for shipping and billing.

**How does the Elastic Path MCP help with customer support?**
It lets support teams pull account details and purchase history instantly. Instead of digging through an admin panel, you can just ask the agent for a customer's order status or profile info.

**Can I see what's in a customer's cart using the Elastic Path MCP?**
You can view the default cart for any store scope. This is helpful for checking default configurations or seeing what's currently in a primary shopping basket.

**Does the Elastic Path MCP work for headless commerce setups?**
Yes, it is specifically designed for headless commerce engines. It connects to the Cortex API to manage workflows like order tracking and store discovery.

**How do I get purchase details using the Elastic Path MCP?**
Just provide the purchase ID to your agent. It will retrieve the status (like Complete or Failed), the total price, and the full list of line items.

**Can the Elastic Path MCP show me my store's navigation?**
It can. You can ask your agent to pull the navigation entry points for a specific scope to see how your storefront is structured and organized.

**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.