Available Tools

Available Tools

The Eraya MCP Server provides 16 tools across four categories:

  • Store & Configuration — list_stores, switch_store, get_eraya_schema

  • Experiments & Results — list_experiments, get_experiment_details, get_experiment_results, get_experiment_statistics, get_experiment_orders

  • Store Data & Analytics — get_store_orders, get_products, get_product_analytics, get_business_kpis, get_test_recommendations

  • Shopify Store Data — list_collections, list_pages, search_policies


Store & Configuration

list_stores

List all Shopify stores your Eraya account has access to. Shows which store is currently active for the session.

Parameters: None

Example response:

{
  "currentStoreId": "64a1f2e3c4d5e6f7a8b9c0d1",
  "stores": [
    {
      "id": "64a1f2e3c4d5e6f7a8b9c0d1",
      "name": "My Shopify Store",
      "isCurrent": true
    },
    {
      "id": "64a1f2e3c4d5e6f7a8b9c0d2",
      "name": "My Second Store",
      "isCurrent": false
    }
  ]
}

switch_store

Switch the active store for this session. All subsequent tool calls will use the selected store. Call list_stores first to find available store IDs.

Note: The target store must be on an active Eraya Pro plan.

Parameters:

  • storeId (required): The ID of the store to switch to (use list_stores to find IDs)

Example response:


get_eraya_schema

Returns the complete Eraya data schema: test types, order property naming conventions, collection names, data flow, and a guide on which tool to use for each analytics task.

Recommended: Call this at the start of a session to help the AI understand your store data before querying it.

Parameters: None

Example response:


Experiments & Results

list_experiments

List all A/B experiments for the active store. Returns all test types by default. Filter by status and/or test type.

Parameters:

  • status (required): Filter by test status — "active", "completed", or "all"

  • testType (optional): Filter by test type — "price", "shipping", "theme", "content", "redirect", "checkout", "template", or "offer"

Example response:


get_experiment_details

Get the full configuration of a specific experiment: variations, goals, targeting, traffic allocation, and run dates.

Parameters:

  • experimentId (required): The ID of the experiment

  • testType (required): The type of test — "price", "shipping", "theme", "content", "redirect", "checkout", "template", or "offer"

Example response:


get_experiment_results

Get session-based funnel analytics for an experiment: sessions → add-to-cart → purchases, broken down by variation, device type, and visitor type (new vs. returning).

Parameters:

  • experimentId (required): The ID of the experiment

  • testType (required): The type of test — "price", "shipping", "theme", "content", "redirect", "checkout", "template", or "offer"

  • startDate (optional): Start date filter (YYYY-MM-DD). Defaults to test start date.

  • endDate (optional): End date filter (YYYY-MM-DD). Defaults to today or test end date.

Example response:


get_experiment_statistics

Get pre-computed Bayesian statistics for an experiment. Includes win probability, revenue lift, credible intervals, statistical significance, and per-variation conversion rate, revenue, and AOV.

Use this tool for winner determination and reporting. Statistics are computed nightly. More accurate than get_experiment_results for significance analysis.

Parameters:

  • experimentId (required): The ID of the experiment

  • asOfDate (optional): Get stats for a specific date (YYYY-MM-DD). Defaults to the most recent snapshot.

Example response:


get_experiment_orders

Retrieve raw Shopify orders attributed to a specific experiment. Useful for revenue deep-dives, AOV analysis, and per-variation purchasing behaviour.

Parameters:

  • experimentId (required): The ID of the experiment

  • testType (required): The type of test — "price", "shipping", "theme", "content", "redirect", "checkout", "template", or "offer"

  • startDate (optional): Start date filter (ISO format, e.g. 2026-01-01)

  • endDate (optional): End date filter (ISO format, e.g. 2026-05-01)

  • productIds (optional): Array of Shopify product ID strings to filter orders by specific products. Use get_products to find IDs.

  • limit (optional): Number of orders to return (max 500, default 100)

  • skip (optional): Number of orders to skip for pagination (default 0)

Example response:

Privacy: Customer names, email addresses, phone numbers, and billing addresses are automatically stripped from all order responses.


Store Data & Analytics

get_store_orders

Retrieve all store orders for a date range regardless of experiment. Useful for analysing overall revenue trends, discount usage, product popularity, and customer purchasing behaviour.

Parameters:

  • startDate (optional): Start date (ISO format, e.g. 2026-01-01)

  • endDate (optional): End date (ISO format, e.g. 2026-05-01)

  • productIds (optional): Array of Shopify product ID strings to filter to specific products

  • limit (optional): Number of orders to return (max 500, default 100)

  • skip (optional): Number of orders to skip for pagination (default 0)

Example response:

Privacy: Customer names, email addresses, phone numbers, and billing addresses are automatically stripped from all order responses.


get_products

Retrieve the full product catalogue including variants, prices, inventory levels, and status.

Parameters:

  • search (optional): Search by product name or tags

  • status (optional): Filter by product status — "active", "draft", or "archived"

  • limit (optional): Number of products to return (max 500, default 100)

  • skip (optional): Number of products to skip for pagination (default 0)

Example response:


get_product_analytics

Retrieve daily per-product analytics: page views, add-to-cart events, orders, revenue, units sold, and price. Useful for understanding product performance trends over time.

Parameters:

  • productId (optional): Filter to a specific product ID

  • startDate (optional): Start date (YYYY-MM-DD)

  • endDate (optional): End date (YYYY-MM-DD)

  • limit (optional): Number of records to return (max 500, default 100)

  • skip (optional): Number of records to skip for pagination (default 0)

Example response:


get_business_kpis

Get store-level daily KPIs: sessions, revenue, conversion rate, and average order value (AOV). Useful for tracking overall store health trends.

Parameters:

  • period (required): Preset period — "last7days", "last30days", or "last90days"

  • startDate (optional): Custom start date (YYYY-MM-DD). Overrides period when provided with endDate.

  • endDate (optional): Custom end date (YYYY-MM-DD). Overrides period when provided with startDate.

Example response:


Shopify Store Data

list_collections

List product collections in the Shopify store. Useful for understanding catalogue structure, finding collection handles for redirect or content tests, or browsing how products are organised.

Parameters:

  • query (optional): Filter collections by title (case-insensitive substring match)

  • limit (optional): Number of collections to return (max 250, default 50)

  • after (optional): Cursor for pagination (endCursor from a previous response)

Example response:


list_pages

List content pages in the Shopify store (About Us, FAQ, Contact, Terms of Service, etc.). Useful for finding pages to run content or redirect tests on.

Parameters:

  • query (optional): Filter pages by title (case-insensitive substring match)

  • limit (optional): Number of pages to return (max 250, default 50)

  • after (optional): Cursor for pagination (endCursor from a previous response)

Example response:


search_policies

Retrieve store policies: privacy policy, refund policy, terms of service, shipping policy, and subscription policy. Useful for answering customer policy questions or analysing policy content.

Parameters:

  • query (optional): Filter policies by keyword in title or body (case-insensitive). Omit to return all policies.

Example response:

Last updated