Skip to main content
Glama

Mint a study interview invite

prism_interviews_create

Creates a one-on-one AI-led interview on a study and returns the invite link to forward — the guest needs no account. The transcript stays on the study and joins the next analysis run (it never lands in Compass). focusPrompt briefs the interviewer on what to dig into; omitted, it explores the study's territory. May return needs_confirmation.

Input Schema

NameRequiredDescriptionDefault
studyIdYes
workspaceNoWorkspace slug. Personal tokens with no default workspace MUST pass this; tokens with a default can override per call. Ignored for workspace API keys.
approvalIdNo
focusPromptNo
intervieweeNameNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.9/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations cover the safety profile (mutation with destructiveHint=false, openWorldHint=true). Beyond that, the description adds real behavioral detail: the guest needs no account, the transcript persists on the study and feeds the next analysis run, and the call 'May return needs_confirmation'. That last one is valuable but unexplained — the agent isn't told why or what to do next.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four dense sentences, front-loaded with purpose and return value before the focusPrompt fallback. Every sentence carries information; the only mild drag is the trailing needs_confirmation clause, which is stated without enough context to be fully usable.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema, the description correctly takes on return-value explanation and names the invite link plus the needs_confirmation possibility. For a five-parameter mutation tool it is close to complete, but approvalId — likely the input that resolves needs_confirmation — is left entirely undocumented.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is only 20% (workspace is the sole documented param), so the description must carry more. It does clarify focusPrompt — briefs the interviewer on what to dig into, otherwise it explores the study's territory — which is genuine added meaning, but approvalId and intervieweeName are never explained, and the plausible link between approvalId and the advertised needs_confirmation response is left for the agent to guess.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (creates) plus the resource (a one-on-one AI-led interview on a study) and its output (invite link to forward). It also implicitly distinguishes itself from the similarly named compass_interviews_create by noting the transcript 'never lands in Compass', which is exactly the kind of sibling differentiation an agent needs.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description makes the use case clear — mint a link you forward to a guest who needs no account — and explains focusPrompt's default behavior when omitted. However, it never states when to pick this over compass_interviews_create, prism_panels_run, or prism_series_launch_wave, which all sit nearby and could plausibly produce research sessions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources