Skip to content
34Five.ai / Documentation
Open Studio ↗
Documentation

Find an answer

Browse popular starting points

DocumentationConnect an Agent
Connect an Agent

MCP Tool Reference

Read workspace identity, team members, Auras™, and Session History.

Studio / MCP v1Reviewed 2026-10-24
Documentation previewDraft content · Staging instructions · Not approved for production
On this pageRead-only toolsIdentity firstPagination and name filtersFinding sessionsReading one sessionErrors and access

Read-only tools #

The server exposes these tools:

ToolPurpose
34five_whoamiIdentify the workspace and principal
34five_list_usersList active Team Members visible to the role
34five_list_aurasList Auras™ visible to the role
34five_list_sessionsFind Session History records
34five_get_sessionRead one session and a bounded transcript window

Identity first #

Call 34five_whoami with no arguments. Confirm the workspace and role before using another tool. A second connection may point to a different workspace.

Pagination and name filters #

List tools accept limit from 1 to 100, default 25, and an optional cursor. Responses contain items, nextCursor, and total. Continue with the returned cursor until it is null. User and Aura™ lists accept an optional name filter.

Finding sessions #

34five_list_sessions accepts since, until, auraId, participant, q, and reportField. Dates use ISO-8601. Results are newest first. Curation interviews are excluded.

The reportField options are risks, actionItems, issues, decisions, and keyPoints. Combine one with q to narrow the search to that report field.

Reading one session #

Pass a returned sessionId to 34five_get_session. Use transcriptOffset and transcriptLimit to request a window of up to 200 lines. Individual lines are capped at 2000 characters. Ask for the smallest useful window.

Errors and access #

See Errors, Limits, and Versioning. The connection's role governs the records returned; these tools do not grant new permissions.

34Five DocumentationPrivacyContent 2b5e203ea2