Session Inspection

Ansight Studio MCP tools for listing devices and sessions, reading captured state, logs, telemetry, annotations, cloud share URLs, and review metadata.

Use these Ansight Studio-owned MCP tools when an agent needs the broad shape of captured sessions, cloud session handoff links, or direct access to captured logs, telemetry, annotations, and review state.

These tool names are the MCP tools/call names exposed by Ansight Studio.

ToolCapability
ansight_list_devicesList connected or historical devices and simulators paired through Ansight Studio.
ansight_list_sessionsList captured Ansight sessions, including historical sessions, with app, device, and capture metadata.
ansight_list_teamsList Ansight cloud teams available to the authenticated Studio account, optionally filtered by name or role.
ansight_share_session_to_teamUpload a captured session to an Ansight cloud team and return the shared session metadata plus the final shareUrl.
ansight_get_session_share_urlResolve the Ansight Portal shareUrl for a shared session id, cloud replay, or local source session that has already been shared.
ansight_get_app_stateReturn the current or last-known app lifecycle state for a live or historical Ansight session.
ansight_get_logsReturn session logs filtered by time range, minimum verbosity, and tags.
ansight_search_logsSearch captured Ansight session logs by keyword across Ansight Studio sessions, with optional app, platform, session, time, verbosity, tag, and source filters.
ansight_get_telemetryReturn captured telemetry filtered by time range, telemetry type, channel id, or channel name.
ansight_get_annotationsReturn session annotations filtered by time range, point-in-time, label text, frame id, and geometry presence.
ansight_inject_annotationCreate or update a session annotation from an agent, recording the annotation source for downstream review.
ansight_update_annotationUpdate an existing session annotation, optionally guarding by its current source.
ansight_delete_annotationDelete an existing session annotation, optionally guarding by its current source.
ansight_tag_sessionReplace, add, or remove captured-session tags and update review metadata such as pin, notes, and name.

ansight_list_sessions and ansight_list_devices accept server-side device filters for platform/platforms, deviceFormFactor/deviceFormFactors, idiom/idioms, osName/osNames, osVersion/osVersions, deviceType/deviceTypes, isVirtual, isEmulator, and deviceClassCode/deviceClassCodes. Supported platform values are android, ios, macos, apple, windows, and other; apple expands to ios plus macos. Supported device types are physical, virtual, emulator, simulator, and sim.

Typical Use

Start with ansight_list_sessions to choose a target session, then use the session-specific tools to inspect raw evidence. Annotation and tag tools let an agent add review notes without changing the original app capture stream.