X (Twitter)LinkedInGitHubDiscordYouTube

FullStory MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with FullStory MCP or direct API to inspect sessions, analyze events, manage exports, and review recording settings through natural language.

Get started for freeGet a demo
FullStory logoFullStory
Api Key

FullStory is a digital experience analytics platform for tracking user sessions, events, recordings, privacy rules, and organization data. It helps teams understand customer behavior, debug friction, and improve product experiences faster.

30 Tools

Try FullStory now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
FullStory
Try asking
TOOLS

Supported Tools

Every FullStory action and event your agent gets out of the box.

Cancel Operation

Irreversibly request cancellation of a cancelable in-progress FullStory operation, currently intended for segment exports.

Create Annotation

Add a persistent annotation to the FullStory timeline for a point or time range.

Create Element Block

Create a beta FullStory element recording or masking rule.

Create Extraction Rule

Create and immediately activate one FullStory beta extraction rule using the provider's nested rule, source, and mapping contract.

Delete Element Block

Permanently delete a custom FullStory privacy element-block rule.

Delete User Data

Permanently delete a FullStory user and their associated data by FullStory-generated ID.

Get FullStory Account

Validate the connected API key and return its FullStory organization, identity, and API-key role.

Get Element Block

Get one FullStory privacy element-block rule by ID, including its exact selector source, recording or masking operation, platforms, and editability.

Get Extraction Rule

Get one FullStory beta extraction rule by ID, including its archive state and complete nested source and mappings.

Get Import Status

Get status and success/error counts for an asynchronous FullStory event or user import job.

Get Operation

Get detailed status, progress, operation-specific results, and failure details for one asynchronous FullStory operation.

Get Organization Quotas

Return current FullStory session and server-event quota usage, limits, and quota periods.

Get Recording Settings

Get one current FullStory recording-settings category.

Get Segment

Get metadata and the FullStory app URL for one segment.

Get User

Retrieve one user by FullStory-generated user ID, including profile fields and a FullStory app link.

Import Events

Start an asynchronous import of 1 to 50,000 server events.

Import Users

Start an asynchronous upsert import of 1 to 50,000 users.

List Datasets

List beta datasets readable by the connected FullStory organization.

List Element Blocks

Return one page of custom and built-in FullStory privacy element-block rules.

List Extraction Rules

List all FullStory beta extraction rules matching one required scope and optional filters, together with current active-rule usage and limits.

List Import Records

Return one page of successful or failed records from a FullStory event or user import job, including failure details when requested.

List Operations

Return one page of asynchronous FullStory operations, optionally filtered by state or type.

List Recording Settings History

Return one page of historical FullStory recording settings for blocking, domain, geo, privacy, features, or targeting.

List Segments

Return one page of FullStory segments, optionally filtered by creator.

List Sessions

Find recent FullStory session replay links by application UID, email, or exact session UID.

Search Users

Find FullStory users by UID, email, display name, or identification state.

Set Extraction Rule Archived

Archive a FullStory beta extraction rule to stop future capture, or unarchive it to resume capture.

Update Element Block

Fully replace an editable beta FullStory element recording or masking rule.

Update Extraction Rule

Partially update a FullStory beta extraction rule using last-write-wins semantics.

Upsert User

Create or update one FullStory user.

SETUP GUIDE

Connect FullStory MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for FullStory
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'Create a FullStory export for checkout error events from last week'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect FullStory API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute FullStory Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Find FullStory sessions with JavaScript errors from yesterday'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute FullStory actions with your Agent

Why Use Composio?

AI Native FullStory Integration

  • Supports both FullStory MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable session, event, and export actions
  • Rich coverage for reading, writing, and querying FullStory experience data

Managed Auth

  • Secure API key handling so agents don't need hard-coded FullStory credentials
  • Central place to manage, scope, and revoke FullStory access
  • Per user and per environment credentials for safer analytics workflows

Agent Optimized Design

  • Tools are tuned for AI agents to understand FullStory users, events, sessions, exports, and recording settings
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access FullStory
  • Scoped, least privilege access to FullStory organization and analytics resources
  • Full audit trail of agent actions to support review and compliance
FAQ

Frequently asked questions

Yes, FullStory requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with FullStory.It takes 30 seconds.

Managed auth, hosted MCP servers, and every FullStory tool your agent needs.Free to start.

Start building