# Storylane MCP

> Storylane connects your AI agent directly to your demo infrastructure. It lets you query demo completion rates, create personalized demo links for prospects, and sync detailed engagement data natively. If you need to track how people interact with product demos or manage interactive content links, this is the tool.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** product-demos, interactive-content, lead-engagement, go-to-market, demo-analytics, personalization

## Description

Storylane hooks your AI agent right into your entire demo infrastructure. You use this server to track how people interact with your product demos, letting you query specific completion rates and creating unique links for prospects. It syncs all that engagement data directly into whatever workflow you're running.

Need to know what’s going on in the workspace? Start by getting high-level metadata about the whole Storylane setup using `get_workspace_info`. You can also see who’s logged into the system via `list_users` or check out every team configured with `list_teams`. For immediate user context, `get_me` returns identifying info for the agent's current workspace user.

To manage your content, you first need to know what demos you have. Run `list_demos` and you get a complete list of every demo published in the workspace, along with their primary IDs. Once you pick a specific demo ID, you can grab its metadata and current status using `get_demo`. You'll also want to review all active links tied to that demo by calling `list_demo_links`. Don’t forget that you can tweak existing assets; `update_demo_link` lets you modify settings like expiry dates or redirect URLs for any link.

Creating a trackable link is simple: use `create_demo_link` and it spits out a new, unique URL. When the prospects start clicking that link, your agent can pull deep analytics using `get_demo_analytics`. This tool gives you key metrics like the completion rate or average time spent viewing for any specific demo ID or link. For a full picture of what’s happening across all viewers, run `list_sessions` and you get a comprehensive list of every session record.

If you need to drill down on one person's activity—say, a single lead who left a weird pattern of clicks—you can fetch detailed logs using `get_session_details`. This provides timestamps and specific actions taken during that viewing session. You'll never have to guess how long someone was looking at the pricing screen again.

This suite lets you manage everything from user lists and team counts right down to tracking a single click on slide three of Demo Alpha. It keeps your entire demo funnel visible, giving you actionable data every time you run an inquiry.

## Tools

### create_demo_link
Generates and returns a new, unique URL that tracks demo viewership data for leads.

### get_demo_analytics
Pulls key engagement metrics, like completion rate and average view time, for a specified demo link or ID.

### get_demo
Retrieves metadata and the current status details for one specific product demonstration by its ID.

### get_me
Returns identifying information about the user who is currently authenticated to the Storylane workspace.

### get_session_details
Fetches detailed activity logs for a specific viewer session, including timestamps and actions taken.

### get_workspace_info
Retrieves high-level metadata about the entire Storylane workspace instance, such as billing or owner details.

### list_demo_links
Lists all active demo links associated with a particular product demonstration ID for review.

### list_demos
Returns a complete list of every published demo available within the workspace, including their primary IDs.

### list_sessions
Retrieves a comprehensive list of session analytics records for all viewers who have interacted with demos.

### list_teams
Lists every team configured within the workspace, providing their name and membership count.

### list_users
Provides a list of all user accounts in the workspace, including their roles (admin, viewer, etc.).

### update_demo_link
Modifies specific settings for an existing demo link, such as expiry dates or custom redirect URLs.

## Prompt Examples

**Prompt:** 
```
List all our active product demos.
```

**Response:** 
```
You have 3 active demos: 'Platform Overview', 'Analytics Deep Dive', and 'Admin Panel'.
```

**Prompt:** 
```
Create a personalized link for 'Analytics Deep Dive' for Acme Corp.
```

**Response:** 
```
Personalized link generated: storylane.io/demo/acme-analytics-123
```

**Prompt:** 
```
Show the completion rate for the 'Platform Overview' demo.
```

**Response:** 
```
The 'Platform Overview' demo currently has a 68% completion rate with an average view time of 4m 12s.
```

## Capabilities

### Generate Trackable Links
Create a new, unique URL for a product demo that tracks user clicks and activity.

### Analyze Demo Performance
Retrieve specific engagement metrics—like completion rate or average view time—for any given demo ID.

### List All Demos and Links
Pull a full list of published demos in the workspace, or retrieve every active link associated with one demo.

### View Session Details
Get granular metrics for individual viewing sessions by providing a specific session ID.

### Manage Workspace Data
List all users, teams, and retrieve high-level metadata about the current Storylane workspace setup.

## Use Cases

### The Marketing Team Needs to Benchmark a New Demo
A PMM just launched 'Feature X' demo. Instead of waiting three days for manual data exports, they ask their agent: 'What is the engagement rate for Feature X?' The agent calls `get_demo_analytics` and immediately returns the completion percentage and average view time, letting them adjust the content that afternoon.

### Sales Needs a Customized Link for an Enterprise Client
A sales rep has a meeting with Acme Corp. They know the generic demo link isn't enough. They ask their agent to create a personalized path, running `create_demo_link` and passing in 'Acme Corp' as metadata. The client receives a unique URL that tracks only their specific interaction.

### Ops Needs to Audit All Active Links
The Ops Engineer needs to know if any demo links are about to expire or need updating before the end of the quarter. They run `list_demo_links` for a core product line, getting an immediate list of all active URLs and their current settings.

### Investigating a Suspicious Session
A lead reported that their demo link was viewed multiple times in a short span. The agent uses `list_sessions` to get all records, then calls `get_session_details` on the suspicious ID. This reveals exactly who accessed it and what actions they performed.

## Benefits

- Immediate ROI data: Don't wait for manual reports. Call `get_demo_analytics` to get instant completion rates and average view times for any product demo, telling you exactly where prospects drop off.
- Personalized outreach at scale: Instead of sending a generic link, use `create_demo_link` to generate unique URLs tailored to specific client needs, making your marketing efforts feel one-to-one.
- Full audit trail: Need to know what happened in a session last week? Use `get_session_details` with just the session ID. It pulls every action taken during that viewing period into plain text for review.
- Manage link lifecycles: Links expire, and settings change. You can use `update_demo_link` to extend access or modify parameters on existing links without having to recreate them entirely.
- Audit the setup: Need a full inventory of who's using the system? Run `list_users` and `list_teams`. This shows you exactly who has access and what roles they hold in the workspace.

## How It Works

The bottom line is: your AI agent uses the tool definitions to read available demos, create necessary links, and then run analytics checks against those assets.

1. First, tell your AI agent which demo you want data on. The agent calls `list_demos` to get a list of available demos and their IDs.
2. Next, if you need a link for a prospect, the agent uses `create_demo_link`, passing in the target demo ID and any required custom metadata.
3. Finally, when you're ready to see metrics, the agent calls `get_demo_analytics` using the specific demo or link ID. This pulls the completion rates and engagement data back to your client.

## Frequently Asked Questions

**How do I find out if my demo link is still active? (list_demo_links)**
Run `list_demo_links`. This tool pulls all current links associated with a demo, letting you see their status and whether they are currently published or nearing expiry.

**What should I call to find out the completion rate? (get_demo_analytics)**
You need `get_demo_analytics`. This tool accepts a demo ID or link ID, and it returns the key metrics like completion percentage and average view time.

**Do I need to know the user's email to list all demos? (list_demos)**
No. `list_demos` pulls a complete index of every published demo in the workspace, regardless of which user created it or who is viewing it.

**If I change a link's expiry date, which tool do I use? (update_demo_link)**
Use `update_demo_link`. This tool lets you modify settings like the expiration dates or custom parameters for an existing link without creating a new one.

**What is the difference between list_demos and list_demo_links? (list_demos, list_demo_links)**
`list_demos` shows you the main product content available in your system. `list_demo_links` only shows the specific URLs that have been generated for those demos.

**How do I use `get_me` to verify which user my AI agent is acting as?**
It returns the current authenticated user's profile data. This lets your agent confirm permissions before running complex queries against demo metrics or links, ensuring proper scope management.

**What does `get_session_details` provide about a specific demo viewing instance?**
It provides granular, time-stamped activity for one viewer session. You can track exactly what content was viewed and when, improving forensic analysis of engagement patterns.

**Before querying anything, how can I use the `get_workspace_info` tool?**
It pulls metadata about your entire Storylane environment. This is useful for ensuring your AI agent knows which demos and teams are available before attempting to list or create resources.

**Can I generate a personalized demo link?**
Yes! Provide the prospect's name and the base demo ID, and the agent will return a uniquely tracked URL.

**How do I view the analytics for a specific demo?**
You can ask the AI to summarize views, completion rates, and the most clicked features of any published demo.

**Is it possible to list all active demo flows?**
Yes, querying for active demos will return their titles, IDs, and current engagement scores.