Use the Speak AI MCP server tool get_analysis_quote to check whether a media file
can be analysed as audio or video, and what it will cost, before running
ask_ai_chat with analysisInput.
What does it do?
Check whether a media file can be analysed as audio or video, and what it will cost,
before running ask_ai_chat with analysisInput. Returns { eligible, credits,
seconds } and, when not eligible, 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 premium opt-in and the server-wide switch, so call it before committing to
an expensive run.
Parameters
get_analysis_quote takes 3 parameters, 2 of them required.
| Name | Type | Required | Description |
|---|---|---|---|
mediaId |
string | Yes | Media file to price |
analysisInput |
enum: audio, video | Yes | ‘audio’ to hear the recording, ‘video’ to also see it. Video costs substantially more because frames dominate. |
modelId |
string | No | Optional model id to price against. Omit for the workspace default. |
Behaviour
The Speak AI MCP server publishes these behaviour hints for get_analysis_quote.
- 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
- Ask AI Chat lists the rest of the Ask 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.