# Available Tools

## Organization & Configuration

### list\_organizations

List all Intelligems organizations you have access to. Supports filtering by installation status and sorting.

**Parameters:**

* `isInstalled` (optional): Filter by installation status. Default: `true`
* `sortBy` (optional): Sort field — `"name"`, `"shopId"`, `"createdAt"`, `"lastLogin"`
* `nameContains` (optional): Filter by name (case-insensitive substring match)
* `limit` (optional): Maximum results to return

**Example response:**

json

```json
{
  "organizations": [
    {
      "id": "org_123abc",
      "name": "My Shopify Store",
      "shopId": "12345",
      "isInstalled": true,
      "createdAtTs": "2024-01-15T10:30:00Z",
      "lastLoginTs": "2024-12-01T14:22:00Z"
    }
  ],
  "totalCount": 5,
  "returnedCount": 5,
  "truncated": false
}
```

### get\_organization

Get detailed information about a specific organization including currency, timezone, Shopify settings, and enabled features.

**Parameters:**

* `organization` (optional): Organization name or ID. Uses current organization if omitted.

**Example response:**

json

```json
{
  "id": "org_123abc",
  "name": "My Shopify Store",
  "shopDomain": "mystore.myshopify.com",
  "currency": "USD",
  "timezone": "America/New_York",
  "features": ["price-testing", "content-testing", "offers"]
}
```

### switch\_organization

Switch the active organization context so that subsequent tool calls use a different store or organization. Useful when you have access to multiple organizations and want to work across them in the same session.

**Parameters:**

* `organization` (required): Organization name or ID to switch to.

### list\_integrations

List all active integrations for an organization (Google Analytics, Klaviyo, Recharge, Slack, etc.).

**Parameters:**

* `enabled` (optional): Filter by enabled status
* `integrationName` (optional): Filter by exact integration name
* `nameContains` (optional): Filter by name (case-insensitive substring match)
* `limit` (optional): Maximum results to return
* `organization` (optional): Organization name or ID

**Example response:**

json

```json
{
  "integrations": [
    { "name": "google_analytics", "enabled": true },
    { "name": "recharge", "enabled": true }
  ]
}
```

***

## Experiences & Experiments

### search\_experiences

Search for and discover experiences of any type (experiments, personalizations, etc.). Returns minimal info (id, name, status, type, timestamps, variation count) for discovery purposes.

**Parameters:**

* `status` (optional): Filter by status — `"pending"`, `"started"`, `"ended"`, `"paused"`
* `nameContains` (optional): Filter by name (case-insensitive substring match)
* `sortBy` (optional): Sort field — `"name"`, `"createdAt"`, `"lastUpdate"`, `"startedAt"`, `"endedAt"`
* `sortOrder` (optional): `"asc"` or `"desc"` (default)
* `organization` (optional): Organization name or ID

### search\_experiments

Search specifically for A/B tests and experiments. Returns minimal info for discovery purposes.

**Parameters:** Same as `search_experiences`

### search\_personalizations

Search specifically for personalizations. Returns minimal info for discovery purposes.

**Parameters:** Same as `search_experiences`

### list\_experiments

Get full experiment details including variations, targeting rules, and configuration.

**Parameters:** Same as `search_experiences`

**Example response:**

json

```json
{
  "experiences": [
    {
      "id": "exp_456def",
      "name": "Holiday Price Test",
      "type": "experiment",
      "status": "started",
      "createdAtTs": "2024-12-01T00:00:00Z",
      "variations": [
        { "id": "var_1", "name": "Control", "trafficAllocation": 50 },
        { "id": "var_2", "name": "10% Discount", "trafficAllocation": 50 }
      ],
      "targeting": {
        "countries": ["US", "CA"],
        "deviceTypes": ["desktop", "mobile"]
      }
    }
  ]
}
```

### list\_personalizations

Get full personalization details including variations, targeting rules, and configuration.

**Parameters:** Same as `search_experiences`

### get\_experience

Get detailed information about a specific experience including its variations, targeting rules, and configuration.

**Parameters:**

* `id` (required): The ID of the experience
* `organization` (optional): Organization name or ID

### get\_experience\_metrics\_config

Get the configured success metrics for a specific experience (e.g., revenue, conversion rate, AOV, custom goals). Returns metric configuration, not actual performance data.

**Parameters:**

* `experienceId` (required): The ID of the experience
* `organization` (optional): Organization name or ID

### create\_experience

Create a new experience/experiment.

**Parameters:**

* See your organization's experience configuration for available fields.
* `organization` (optional): Organization name or ID

### update\_experience

Update an existing experience/experiment — modify variations, targeting rules, traffic allocation, or other configuration.

**Parameters:**

* `id` (required): The ID of the experience to update
* `organization` (optional): Organization name or ID

### experience\_action

Perform a lifecycle action on an experience: start, pause, or end it.

**Parameters:**

* `id` (required): The ID of the experience
* `action` (required): The action to perform — `"start"`, `"pause"`, or `"end"`
* `organization` (optional): Organization name or ID

### analyze\_experience

Get actual A/B test performance results, statistical significance, and compare variation performance.

**Parameters:**

* `experienceId` (required): The ID of the experience
* `view` (optional): `"overview"` for main metrics (default), `"audience"` for audience breakdown
* `audience` (optional): Segment to analyze when view is `"audience"` — `"device_type"`, `"visitor_type"`, `"country_code"`, `"source_channel"`, `"source_site"`, `"landing_page_full_path"`
* `analyticsViewType` (required): Analytics view type from the experience's `experienceAnalysis` configuration
* `start` (optional): Start date in ISO 8601 format
* `end` (optional): End date in ISO 8601 format
* `organization` (optional): Organization name or ID

**Example response:**

json

```json
{
  "metrics": {
    "conversionRate": { "control": 3.2, "variation": 3.8, "lift": 18.75 },
    "revenue": { "control": 15420.50, "variation": 17892.30, "lift": 16.03 },
    "confidence": 95.2
  }
}
```

***

## Shopify Store Data

### search\_products

Search the Shopify product catalog by keyword, name, or description.

**Parameters:**

* `query` (required): Search term for product title, description, or tags
* `limit` (optional): Maximum results (default: 20)
* `organization` (optional): Organization name or ID

**Example response:**

json

```json
{
  "results": [
    {
      "id": "7234567890",
      "title": "Organic Cotton T-Shirt",
      "vendor": "My Brand",
      "price": "29.99",
      "variants": 3,
      "tags": ["organic", "sustainable"]
    }
  ],
  "query": "organic cotton"
}
```

### list\_collections

Browse or search product collections in the Shopify store.

**Parameters:**

* `first` (optional): Number of collections to fetch (default: 20)
* `after` (optional): Cursor for pagination
* `query` (optional): Search filter for collection name
* `organization` (optional): Organization name or ID

**Example response:**

json

```json
{
  "collections": [
    {
      "id": "123456789",
      "title": "Holiday Collection",
      "handle": "holiday-collection",
      "productsCount": 24
    }
  ],
  "pageInfo": { "hasNextPage": true, "endCursor": "abc123" },
  "totalFetched": 20
}
```

### list\_pages

Browse or search content pages in the Shopify store (About, Contact, FAQ, Terms, etc.).

**Parameters:**

* `first` (optional): Number of pages to fetch (default: 20)
* `after` (optional): Cursor for pagination
* `query` (optional): Search filter for page title
* `organization` (optional): Organization name or ID

**Example response:**

json

```json
{
  "pages": [
    { "id": "987654321", "title": "About Us", "handle": "about-us" }
  ],
  "pageInfo": { "hasNextPage": false },
  "totalFetched": 5
}
```

### search\_policies

Search store policies, FAQs, shipping info, returns, privacy, and other store rules.

**Parameters:**

* `query` (required): Search term
* `organization` (optional): Organization name or ID

***

## Analytics & Audience Data

### get\_sitewide\_analytics

Get a sitewide analytics summary for the store, including revenue per visitor, net revenue, conversion rate, and other top-level performance metrics. Useful for understanding overall store health independent of any specific experiment.

**Parameters:**

* `organization` (optional): Organization name or ID

All audience analysis tools below require an experience ID and return performance metrics broken down by the specified segment.

### get\_audience\_by\_country

Analyze A/B test performance by visitor country/geography.

**Parameters:**

* `id` (required): The experience ID
* `organization` (optional): Organization name or ID

### get\_audience\_by\_device

Analyze A/B test performance by device type (desktop, mobile, tablet).

**Parameters:**

* `id` (required): The experience ID
* `organization` (optional): Organization name or ID

### get\_audience\_by\_visitor\_type

Compare A/B test performance between new and returning visitors.

**Parameters:**

* `id` (required): The experience ID
* `organization` (optional): Organization name or ID

### get\_audience\_by\_source\_channel

Analyze A/B test performance by traffic acquisition channel (organic, paid, social, email, direct).

**Parameters:**

* `id` (required): The experience ID
* `organization` (optional): Organization name or ID

### get\_audience\_by\_source\_site

Analyze A/B test performance by referring website/domain.

**Parameters:**

* `id` (required): The experience ID
* `organization` (optional): Organization name or ID

### get\_audience\_by\_landing\_page

Analyze A/B test performance by landing page URL.

**Parameters:**

* `id` (required): The experience ID
* `organization` (optional): Organization name or ID

**Example response (applies to all audience tools):**

json

```json
{
  "summary": {
    "segments": [
      {
        "segment": "US",
        "visitors": 15420,
        "conversions": 892,
        "conversionRate": 5.79,
        "revenue": 45230.50
      },
      {
        "segment": "CA",
        "visitors": 3240,
        "conversions": 187,
        "conversionRate": 5.77,
        "revenue": 12450.00
      }
    ]
  }
}
```

***

## Visualization & Charting

### generate\_intelligems\_graph

Generate official Intelligems analytics chart images for an experiment. Returns a branded chart visualization of experiment results that can be shared or embedded in reports.

**Parameters:**

* `experienceId` (required): The ID of the experience
* `organization` (optional): Organization name or ID

### generate\_custom\_graph

Generate a branded Intelligems chart image from raw data. Useful for visualizing custom datasets or metrics that aren't tied to a specific experiment.

**Parameters:**

* `data` (required): The raw data to visualize
* `organization` (optional): Organization name or ID

***

## Custom Events

### list\_custom\_events

List all custom tracking events configured for your organization. Includes page views, click events, scroll depth tracking, and custom JavaScript events.

**Parameters:**

* `organization` (optional): Organization name or ID

**Example response:**

json

```json
{
  "customEvents": [
    {
      "name": "add_to_wishlist",
      "type": "custom",
      "description": "User adds product to wishlist"
    },
    {
      "name": "scroll_depth_50",
      "type": "scroll",
      "description": "User scrolled 50% of page"
    }
  ]
}
```

***

## Offers

### list\_offers

List all offers configured for your organization. Includes tiered discounts, cart discounts, free gifts, and free shipping.

**Parameters:**

* `enabled` (optional): Filter by enabled status
* `isTest` (optional): Filter by test mode status
* `isArchived` (optional): Filter by archived status
* `applicationType` (optional): Filter by discount application type
* `nameContains` (optional): Filter by name (case-insensitive substring match)
* `limit` (optional): Maximum results to return
* `organization` (optional): Organization name or ID

**Example response:**

json

```json
{
  "offers": [
    {
      "id": "offer_789ghi",
      "name": "Free Shipping Over $50",
      "discountApplicationType": "free_shipping",
      "enabled": true,
      "isTest": false,
      "isArchived": false
    }
  ]
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.intelligems.io/developer-resources/mcp-server/available-tools.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.