Use the Speak AI MCP server tool check_analysis_eligibility to check whether a
media file can be analysed as audio or video before running ask_ai_chat with
analysisInput.
What does it do?
Check whether a media file can be analysed as audio or video before running
ask_ai_chat with analysisInput. Returns whether the file is eligible and, when it
is not, a plain-English reason. An unavailable file is a normal result here, not an
error. This is the only check that accounts for both the account’s opt-in and the
server-wide switch, so call it before an audio or video run.
Parameters
check_analysis_eligibility takes 3 parameters, 2 of them required.
| Name | Type | Required | Description |
|---|---|---|---|
mediaId |
string | Yes | Media file to check |
analysisInput |
enum: audio, video | Yes | Which pass to check: ‘audio’ (tone, pacing, delivery) or ‘video’ (also on-screen visuals, gestures, slides). Required. |
modelId |
string | No | Optional model id to check against. Omit for the workspace default. |
Behaviour
The Speak AI MCP server publishes these behaviour hints for
check_analysis_eligibility.
- Only reads data. Does not modify your workspace.
- Does not delete or overwrite existing data.
- Repeating an identical call is safe.
- Stays inside Speak AI. Does not reach other systems.
Related
- AI Chat lists the rest of the AI Chat category.
- Tool reference lists every Speak AI MCP server tool.
- MCP server covers setup, supported clients, and what agents can do once connected.