developer-toolsapi_key

FullStory

FullStory provides digital experience analytics APIs for managing users, events, sessions, exports, recording settings, privacy rules, and related organization data.

Verdict

FullStory captures session replays and behavioral analytics for web and mobile apps. In Switchy, @mentioning FullStory lets your team query user sessions, annotate timelines, and manage privacy rules without leaving the conversation. Product managers can pull session links for bug reports, support reps can find replays matching a customer complaint, and compliance teams can audit or update data masking rules. The API key grants full admin access—including irreversible privacy mutations like deleting user data or changing element blocks—so limit this integration to trusted Projects and confirm destructive operations before running them.

Common use cases

  • Pull session replays matching a support ticket
  • Annotate product launch moments on the timeline
  • Audit active data masking rules for compliance
  • Delete user data for GDPR requests
  • Create extraction rules for custom event tracking

Integration

Vendor
FullStory
Category
developer-tools
Auth
API_KEY
Tools
30
Composio slug
fullstory

Tools

  • Cancel Operation

    Irreversibly request cancellation of a cancelable in-progress FullStory operation, currently intended for segment exports. Confirm the operation before calling because a successful cancellation request cannot be undone.

  • Create Annotation

    Add a persistent annotation to the FullStory timeline for a point or time range. Warning: FullStory provides no matching delete endpoint, so a successful call cannot be cleaned up through this API.

  • Create Element Block

    Create a beta FullStory element recording or masking rule. Requires an Admin API key. Privacy-critical: an incorrect selector, UNMASK action, or live scope can expose sensitive data, while EXCLUDE or MASK can suppress useful recording. Revi

  • Create Extraction Rule

    Create and immediately activate one FullStory beta extraction rule using the provider's nested rule, source, and mapping contract. Extraction can capture sensitive element, URL, header, or body values and can materially increase collected d

  • Delete Element Block
    destructive

    Permanently delete a custom FullStory privacy element-block rule. This is irreversible: removing a block or mask can expose sensitive content in future recordings. Confirm the exact custom rule first; built-in rules cannot be deleted. This

  • Delete User Data
    destructive

    Permanently delete a FullStory user and their associated data by FullStory-generated ID. This is an irreversible privacy mutation; confirm the target before calling.

  • Get Element Block

    Get one FullStory privacy element-block rule by ID, including its exact selector source, recording or masking operation, platforms, and editability. Warning: this exposes privacy-sensitive recording configuration. This API is in beta; funct

  • Get Extraction Rule

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

  • Get FullStory Account

    Validate the connected API key and return its FullStory organization, identity, and API-key role. Do not use the role to infer paid product entitlements.

  • 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. Privacy settings may contain sensitive configuration and large built-in rule sets; the complete provider response is preserved.

  • 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. This permanently adds analytics data; use an idempotency key when retrying.

  • Import Users

    Start an asynchronous upsert import of 1 to 50,000 users. This mutates personal profile data.

  • 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. These rules determine what FullStory records or masks.

  • 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. Privacy history requires an Architect-level API key; the other categories require Standard or higher.

  • 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. Provide at least one selector; session_uid cannot be combined with uid or email. This is a filtered single-page lookup, not an unfiltered or paginat

  • Search Users

    Find FullStory users by UID, email, display name, or identification state. Provide at least one of uid, email, display_name, or is_identified. A no-match 404 is returned as an empty result page.

  • Set Extraction Rule Archived

    Archive a FullStory beta extraction rule to stop future capture, or unarchive it to resume capture. Warning: this changes collection behavior immediately. Archiving does not erase data already collected, and data not captured while the rule

  • Update Element Block

    Fully replace an editable beta FullStory element recording or masking rule. Requires an Admin API key. This is an irreversible privacy configuration update, not a patch: read the existing rule first and provide every required replacement fi

  • Update Extraction Rule

    Partially update a FullStory beta extraction rule using last-write-wins semantics. Provide at least one of name, description, source, or mappings. Omitted fields remain unchanged; read the current rule first. Warning: changing a rule's sour

  • Upsert User

    Create or update one FullStory user. Supplying fullstory_user_id updates that record; otherwise uid identifies an upsert. This mutates personal profile data.

Setup

Setup guide

  1. 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Click 'Add Integration' and select FullStory from the developer tools category. 3. In a separate tab, log into your FullStory account and go to Settings > Integrations & API Keys. 4. Generate a new API key with Admin scope (required for privacy rule management and data deletion). 5. Copy the key and paste it into Switchy's FullStory configuration dialog, then click 'Connect'. 6. Switchy will validate the key against FullStory's API and confirm the connection. 7. Open any Project where you want FullStory available and type '@FullStory' in the chat to see available tools. 8. Test the connection by asking '@FullStory list recent sessions for user ID [example]' or '@FullStory show me the extraction rules currently active'. 9. If the response includes session data or rule details, the integration is working.

What teammates see: by default, memories from FullStory are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Projects have used this MCP together with a given model.

How Switchy teams use it

Not enough Projects yet to publish anonymised usage stats (we require ≥ 50 Projects per week).

Starter prompts

Find Sessions by User

@FullStory show me the last five sessions for user ID 12345. Include session URLs and timestamps so I can review what they experienced.

Annotate Release Event

@FullStory create an annotation for today at 2:00 PM UTC labeled 'v2.4 checkout flow deployed'. This helps us track behavior changes after the release.

Audit Privacy Rules

@FullStory list all element block rules currently active. Show me the selector, action type, and which platforms each rule applies to.

Process Data Deletion

@FullStory delete all data for FullStory user ID 67890. Confirm this is the correct user before proceeding because the deletion is irreversible.

Review Extraction Config

@FullStory get extraction rule ID ext_abc123. Show me the source selector, mapped fields, and whether it's currently active or archived.

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@FullStory show me all active extraction rules capturing form field data in our checkout flow

Output

Here are the 4 active extraction rules targeting checkout elements: 'checkout_email_capture' (extracts email from #email-input, created 2024-01-15), 'payment_method_type' (captures card vs. PayPal selection from .payment-selector, created 2024-02-03), 'promo_code_applied' (extracts coupon field value, created 2024-02-10), and 'shipping_tier_selected' (maps radio button state from form[name='shipping'], created 2024-03-01). All four are live and writing to your data warehouse connector. Note that extraction rules capture raw field values—review each rule's mapping to confirm no PII is being logged unintentionally.

Notes

This read-heavy example demonstrates FullStory's extraction rule introspection, useful for auditing what user input your team is capturing. Before relying on this workflow, confirm your API key has read access to extraction rules. Extraction rules are privacy-critical: they can log sensitive form data (passwords, SSNs, credit cards) if misconfigured, so treat the output as a compliance checklist, not just a feature inventory.

Prompt

@FullStory create an element block to mask all input fields with class 'ssn-field' across web and mobile, effective immediately

Output

Element block created successfully (ID: eb_9x7k2m). This rule now masks all elements matching the CSS selector 'input.ssn-field' on web platforms and the equivalent native selector on iOS and Android. The masking is live in production: any session recorded after this moment will show redacted content for matching fields. FullStory applies this rule retroactively to new playback requests, but existing cached sessions may still show unmasked data for up to 24 hours. Verify the selector in a test session before assuming full coverage—incorrect selectors can leave sensitive fields exposed or over-mask legitimate UI.

Notes

This write example shows FullStory's privacy-critical element blocking in action. The MCP requires an Admin API key for this mutation. The side-effect is immediate and production-impacting: a wrong selector can break session replay UX or fail to mask PII. Always test the selector in a staging environment first. FullStory provides no undo for element blocks created via API—you must delete and recreate if the rule is wrong.

Prompt

@FullStory review the last 7 days of timeline annotations and draft a summary of user-reported issues for our sprint retro

Output

I found 12 annotations in the past week tagged with 'user-report' or 'bug'. Key themes: 5 annotations cite checkout timeout errors (mostly 2024-03-18 to 2024-03-20, coinciding with your payment gateway migration), 3 mention broken image thumbnails in the product gallery (reported by mobile users on iOS 17.4+), 2 flag confusion around the new 'Save for Later' button placement (both from the same user cohort), and 2 are one-off issues (a localization string missing in French, a broken deep link from email). The checkout timeout cluster suggests your migration introduced a latency regression; the image issue may be a WebP compatibility gap. Consider prioritizing the checkout fix and auditing your image CDN's mobile delivery.

Notes

This synthesis example pairs FullStory's annotation retrieval with AI reasoning to surface patterns across qualitative user feedback. The MCP reads annotations but doesn't interpret them—the AI does the clustering and prioritization. Annotations are write-only in FullStory's API (no delete endpoint), so this workflow assumes your team has been disciplined about tagging. Rate limits apply: fetching annotations for high-traffic accounts may require pagination.

Use-case deep-dives

Privacy audit before GDPR review

When FullStory MCP makes compliance prep faster than manual checks

A 6-person SaaS team has a GDPR audit in three weeks and needs to verify which form fields are masked in FullStory recordings. The compliance lead uses this MCP to pull every element block rule, check selectors against the live DOM, and flag gaps where PII might leak. The MCP's Get Element Block and Create Element Block tools let you script the entire audit loop in Switchy: query existing rules, compare to a checklist, push new masks for credit-card inputs or email fields. This works because FullStory's 30 tools cover the full privacy surface—blocks, extractions, user deletion. The threshold: if your team runs more than two audits a year, build the script once and reuse it. If it's a one-time check, the FullStory dashboard is faster.

Session replay triage in support escalations

Why this MCP isn't the right call for live customer troubleshooting

A 12-person support team wants to pull FullStory session replays during Slack escalations to see what the customer clicked before the error. The MCP has 30 tools, but none fetch or embed session replay URLs directly—those live in FullStory's search UI, not the API. You can create annotations to mark the timeline or delete user data after resolution, but the core workflow (search sessions, watch replay, share link) stays in the FullStory dashboard. The MCP shines for privacy mutations and export orchestration, not real-time session lookup. If your support flow is 'find the session, watch it, close the ticket,' skip this integration. If you're scripting bulk annotation or post-incident user-data deletion across 50 sessions, the MCP saves hours.

Automated funnel event extraction at scale

When extraction rules justify the API-key setup cost

A 9-person growth team tracks 40 funnel events (signup clicks, onboarding steps, paywall hits) and wants to pipe FullStory data into their warehouse without manual CSV exports. The MCP's Create Extraction Rule and Get Extraction Rule tools let you define and version-control every extraction in code: which DOM selectors to capture, which URL patterns to match, which custom properties to map. You script the full pipeline in Switchy—create rules, confirm they're live, cancel stale exports if the schema changes. This pays off when you're managing more than 10 extraction rules or rotating them weekly for A/B tests. Below that threshold, FullStory's UI is less overhead. The API key is admin-scoped, so lock it down and audit who can mutate extraction configs.

Frequently asked

What does the FullStory MCP do in Switchy?

It lets your team create session annotations, manage privacy rules, and export user data directly from Switchy's AI workspace. You can block elements from recordings, set up extraction rules for custom events, and delete user data for GDPR requests — all without switching to FullStory's dashboard. The MCP exposes 30 tools covering annotations, privacy controls, and data operations.

Do I need an admin API key to use this MCP?

Yes, for privacy-critical operations like creating or deleting element blocks and extraction rules. Standard API keys work for read-only tasks like fetching existing rules or creating annotations. If your team needs to modify recording masks or data retention policies through Switchy, the person connecting the MCP must have admin access in FullStory.

Can this MCP delete recordings or mask data retroactively?

No. Element blocks and extraction rules only affect future sessions. If you need to scrub existing recordings, use FullStory's dashboard directly. The MCP can delete user data permanently via the Delete User Data tool, but that's a one-way operation — confirm the user ID before running it because FullStory provides no undo.

Why use this MCP instead of FullStory's web UI?

Speed and context. If you're already in Switchy reviewing support tickets or debugging issues, you can annotate the exact session timestamp or export a segment without opening another tab. The MCP also lets you script repetitive privacy tasks — like bulk element blocking — that would take dozens of clicks in the dashboard.

Who on the team should connect this MCP?

Your FullStory admin or a senior engineer who understands your privacy rules. The MCP can permanently expose or hide session data, so the person connecting it needs to know which selectors to block and which extraction rules are safe to activate. Non-admin team members can still use read-only tools once it's connected.

More developer tools MCPs

See all developer tools MCPs →

Data last verified 61 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.