mcp-transkriptor
Allows transcription of files from Dropbox via public URL.
Allows transcription of files from Google Drive via public URL.
Allows transcription of live Google Meet meetings.
Allows transcription of YouTube videos via URL.
Allows transcription of live Zoom meetings.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-transkriptorTranscribe my latest meeting recording"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-transkriptor
Local MCP server wrapping the Transkriptor developer API. Transcribe audio, video, public URLs (YouTube / Google Drive / Dropbox / OneDrive), and live meetings (Google Meet / Microsoft Teams / Zoom); fetch transcription content and AI summaries; export TXT / SRT / PDF / DOCX; manage files, folders, custom vocabulary and webhooks; text-to-speech; and AI-chat knowledgebases. stdio transport.
Requirements
A Transkriptor API key — see https://developer.transkriptor.com (authentication)
Related MCP server: Deepgram MCP Server
Setup
git clone https://github.com/mickaelxd/mcp-transkriptor.git
cd mcp-transkriptor
cp .env.example .env # then paste your TRANSKRIPTOR_API_KEY
uv syncRun / test
uv run mcp-transkriptor # starts the stdio server (Ctrl-C to stop)Register in Claude Code
claude mcp add transkriptor -s user -- \
uv run --directory /absolute/path/to/mcp-transkriptor mcp-transkriptorUse the absolute path to your clone. Other MCP clients: point them at the same
uv run --directory <path> mcp-transkriptor command over stdio.
Configuration
Env var | Required | Purpose |
| yes | Sent as |
| no | Sandbox for |
Tools
Transcribe:
transcribe_local_file,transcribe_url,transcribe_meetingRead:
get_file_content,get_file_detail,get_meeting_detail,get_summary,list_files,list_folders,get_user_detailsExport / edit:
export_transcription,rename_file,delete_fileVocabulary:
set_custom_vocabulary,get_custom_vocabulary,delete_custom_vocabularyWebhooks:
create_webhook,list_webhooks,delete_webhookText-to-speech:
text_to_speechAI chat:
list_knowledgebases,create_knowledgebase,add_file_to_knowledgebase,create_chat_session,chat_with_knowledgebase
Base URL https://api.tor.app/developer, rate limit 1000 req/min. Everything keys
off the order_id returned by a transcribe call.
Security
Your API key grants full account access.
.envis gitignored — keep it that way. Treat the key like a password and rotate it if it leaks.This server exposes destructive tools (
delete_file,delete_webhook, andset_custom_vocabulary, which replaces existing vocabulary). If you run your MCP client without a tool-confirmation gate, an autonomous agent — or indirect prompt injection via transcription content the model reads — could trigger them. Prefer a client that confirms tool calls.transcribe_local_fileuploads file contents to a third party (tor.app). KeepTRANSKRIPTOR_ALLOWED_DIRnarrow; never point it at a directory holding secrets.get_user_detailsechoes account fields returned by the API; avoid pasting its raw output into shared logs.Webhooks require a public HTTP endpoint to receive events. This server can create / list / delete them, but does not host a receiver.
License
MIT — see LICENSE.
Available Tools
25 toolsadd_file_to_knowledgebaseC
Add a Transkriptor transcription file to an AI Chat knowledgebase.
| Name | Required | Description | Default |
|---|---|---|---|
| order_id | Yes | ||
| knowledge_base_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden for behavioral disclosure. It only states the basic action without explaining side effects (e.g., whether it replaces existing files, whether it requires specific permissions, or what happens if arguments are invalid). The behavior around duplicate files or error conditions is completely opaque.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, concise sentence that immediately conveys the core functionality. It is front-loaded and contains no extraneous words. However, it sacrifices completeness for brevity, missing critical details that could be added without much length.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 2 required parameters, no annotations, and an output schema not detailed, the description is insufficient. It does not explain prerequisites (e.g., file must exist, KB must exist), error handling, or what the output represents. The tool is a mutation with no behavioral context, leaving the agent underinformed.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description should compensate by explaining parameters. However, it gives no details about 'order_id' or 'knowledge_base_id'. While the parameter names are somewhat self-explanatory ('order_id' likely refers to a transcription order, 'knowledge_base_id' to the KB), no additional semantics are provided to confirm valid values or formatting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('Add') and the resource ('Transkriptor transcription file to an AI Chat knowledgebase'), specifying the verb and resource distinctly. It differentiates from sibling tools like create_knowledgebase (which creates a KB) and chat_with_knowledgebase (which chats), making the tool's purpose unambiguous.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It does not mention prerequisites (e.g., the file must already be transcribed via transcribe_local_file, or the knowledgebase must exist via create_knowledgebase), nor does it indicate when not to use it or what conditions trigger its use.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
chat_with_knowledgebaseC
Send a message to an AI Chat knowledgebase session.
| Name | Required | Description | Default |
|---|---|---|---|
| message | Yes | ||
| session_id | Yes | ||
| knowledge_base_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description bears full responsibility for behavioral disclosure. It only states the basic action, omitting details about responses, side effects, or state changes.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence with no wasted words, but it is too brief to convey necessary information. Conciseness is not an asset when it undermines clarity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool likely returns a response from the AI, yet the description omits this. Given an output schema exists, the description should at least hint at the return value. It also lacks context about session management or rate limits.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, and the description adds no meaning to the parameters. The schema names are self-explanatory but the description fails to clarify usage or format, e.g., where to obtain knowledge_base_id.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'Send a message' and the resource 'AI Chat knowledgebase session', indicating the action and target. However, it does not distinguish this tool from siblings like 'create_chat_session', which could be confused.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is given on when to use this tool versus alternatives, nor are prerequisites (e.g., an existing session) mentioned. The agent receives no context for proper selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
create_chat_sessionC
Create a chat session inside a knowledgebase.
| Name | Required | Description | Default |
|---|---|---|---|
| knowledge_base_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
There are no annotations, and the description does not disclose any behavioral traits. The tool could be read-only or have side effects; the agent is given no information about authorization requirements, rate limits, or impact on system state.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely short (one sentence) but lacks critical details, making it under-specified rather than concise. It fails to leverage the brief format effectively by omitting necessary information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite the presence of an output schema, the description does not hint at what the tool returns (e.g., session ID, status). Combined with missing annotations and parameter details, the description is insufficient for a complete understanding of the tool's role.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 0% description coverage, and the description does not explain the meaning of the 'knowledge_base_id' parameter beyond the schema field title. The agent is left to guess the format, constraints, or source of the ID.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action (create a chat session) and the target resource (inside a knowledgebase). However, it does not differentiate from the sibling tool 'chat_with_knowledgebase', which could be interpreted as similar functionality. The verb-resource pairing is specific but lacks sibling context.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives such as 'chat_with_knowledgebase'. There are no prerequisites, exclusions, or use-case examples. The agent must infer usage from the name alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
create_knowledgebaseC
Create an AI Chat knowledgebase.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden of behavioral disclosure. It only states 'Create' without mentioning side effects (e.g., duplicate handling), required permissions, or response format. This is insufficient for an agent to understand consequences.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is very concise (one sentence), but it lacks structure such as section headers or bullet points. While front-loaded, it does not organize information effectively for a 1-parameter tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite low complexity (1 parameter, output schema exists), the description is too minimal. It does not explain what an AI Chat knowledgebase is, any default behaviors, or how it relates to sibling tools. The output schema's presence only partially compensates.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema description coverage is 0%, and the tool description adds no meaning to the single 'name' parameter beyond its type and requirement. The agent gains no insight into valid formats, length constraints, or purpose of the parameter.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action (create) and resource (AI Chat knowledgebase), making the primary purpose evident. However, it does not differentiate from sibling tools like 'create_chat_session' or 'create_webhook' beyond the resource name.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool vs alternatives, such as 'add_file_to_knowledgebase' or 'chat_with_knowledgebase'. There is no context on prerequisites, conditions, or preferred scenarios.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
create_webhookB
Register a webhook URL for completed transcriptions. Your webhook URL must be reachable by Transkriptor.
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| folder_id | No | ||
| export_format | No | Json | |
| paragraph_size | No | ||
| include_timestamps | No | ||
| is_single_paragraph | No | ||
| include_speaker_names | No | ||
| merge_same_speaker_segments | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description bears full responsibility. It mentions the reachability requirement but omits behavioral details such as whether the URL is validated immediately, whether the webhook is idempotent, or what happens on registration (e.g., does it return a webhook ID?).
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise (two sentences) but sacrifices essential parameter information. It could be restructured to include brief parameter guidance without becoming verbose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 8 parameters and an output schema (present but not described), the description is incomplete. It does not mention return values, how multiple webhooks are handled, or the frequency of notifications, leaving the agent without full context.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With 0% schema description coverage, the description must explain parameters, but it only mentions 'url'. The remaining 7 parameters (folder_id, export_format, paragraph_size, etc.) are left unexplained despite having enums and defaults.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states the action ('register a webhook URL') and the trigger event ('for completed transcriptions'). It also includes a reachability constraint, distinguishing it from sibling tools like delete_webhook or list_webhooks.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides clear context for when to use (registering a webhook for completed transcriptions) and a prerequisite (URL must be reachable), but does not explicitly mention when not to use or alternative methods.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
delete_custom_vocabularyB
Delete current custom vocabulary.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so the description carries full burden. It states deletion but omits key behavioral details: irreversibility, required permissions, side effects. For a destructive action, this is insufficient.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Extremely concise: one sentence, no fluff. Every word is necessary, but the brevity sacrifices useful detail like prerequisites or consequences.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no parameters and an existing output schema, the description should still set expectations for a deletion tool. It fails to mention irreversibility or confirmation, leaving the agent underinformed.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
No parameters exist, so schema coverage is 100%. The description adds context by specifying 'current' vocabulary, which clarifies what is being deleted beyond the empty schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description 'Delete current custom vocabulary' clearly states the action and resource. It distinguishes from siblings (get, set, etc.) by specifying deletion. However, 'current' is somewhat vague and could be clarified.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use vs alternatives. The description does not mention prerequisites, consequences, or alternative tools (e.g., set_custom_vocabulary for modification). Usage must be inferred.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
delete_fileC
Delete all files associated with an order_id. Use carefully.
| Name | Required | Description | Default |
|---|---|---|---|
| order_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries full burden. It discloses that the tool is destructive ('delete', 'Use carefully'), but lacks details on reversibility, permissions required, or side effects. The output schema exists but the description does not clarify behavioral aspects beyond deletion.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is very short (two sentences) and front-loaded with the core action. The second sentence 'Use carefully' adds a warning but is minimal. Overall concise, though the warning could be more specific.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite having an output schema, the description omits important context such as whether this action is irreversible, if it requires specific permissions, or what happens to related entities. For a destructive tool with no annotations, more context is needed to ensure safe and correct usage.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0%, meaning no descriptions in the input schema. The description does not add any meaning to the 'order_id' parameter beyond the parameter name itself. The agent gains no additional understanding of what values are valid or how to format the id.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'delete' and the resource 'all files associated with an order_id'. It distinguishes from sibling tools like 'rename_file' and 'get_file_detail', though it could explicitly note that it deletes multiple files at once.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Only a generic warning 'Use carefully' is provided. No explicit guidance on when to use this tool versus alternatives, prerequisites, or conditions that should be checked before invocation. Sibling tools like 'delete_custom_vocabulary' and 'delete_webhook' are distinct, but the description does not help an agent decide if this is the correct action.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
delete_webhookB
Delete a webhook by webhookType.
| Name | Required | Description | Default |
|---|---|---|---|
| webhook_type | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, and the description does not disclose behavioral traits such as irreversibility, required permissions, error handling, or side effects. This is minimal for a mutation tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise with a single sentence, no redundancy. It could be slightly more informative without losing conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity and presence of an output schema, the description is adequate but does not explain return values or confirmation. It meets minimal completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With 0% schema coverage, the description adds meaning by stating the parameter is used for identification ('by webhookType'). However, it does not specify valid values or format, leaving the parameter underspecified.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action 'Delete a webhook' and the identifier 'by webhookType'. It effectively distinguishes from sibling tools like create_webhook and list_webhooks.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description lacks guidance on when to use this tool versus alternatives, and does not mention prerequisites like verifying that the webhook exists before deletion.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
export_transcriptionC
Export a transcription as txt, srt, pdf, or docx.
| Name | Required | Description | Default |
|---|---|---|---|
| order_id | Yes | ||
| export_type | No | txt | |
| paragraph_size | No | ||
| include_timestamps | No | ||
| is_single_paragraph | No | ||
| include_speaker_names | No | ||
| merge_same_speaker_segments | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It merely says 'export' without explaining whether the export returns a file URL, downloads directly, or requires further actions. Side effects like storage consumption, rate limits, or auth requirements are not mentioned.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
While the description is very concise (one sentence), it is under-specified. It is not a model of conciseness because it omits essential information. The structure is front-loaded but lacks depth, making it insufficient for correct tool invocation.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite complexity (7 params, 1 required, enums, boolean flags) and an existing output schema, the description provides no context about return values, parameter interactions, or usage examples. It is far from complete for an agent to correctly select and invoke this tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 7 parameters with 0% description coverage (no titles or descriptions). The tool description adds no explanation for any parameter. For example, 'paragraph_size', 'is_single_paragraph', 'merge_same_speaker_segments' are left completely ambiguous. The description fails to compensate for the schema's lack of documentation.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action (export) and the resource (a transcription), and lists the exact output formats (txt, srt, pdf, docx). This distinguishes it from sibling tools like 'get_file_content' or 'get_summary' which serve different purposes.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives such as 'get_file_content', 'get_summary', or 'transcribe_*' tools. There is no mention of prerequisites (e.g., a completed transcription) or scenarios where this tool is appropriate or inappropriate.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_custom_vocabularyA
Get current custom vocabulary.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It only states 'Get' which implies read-only, but lacks details about authentication requirements, error states (e.g., no vocabulary exists), or any side effects. Minimal disclosure.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single short sentence that is front-loaded with the key action. Every word is necessary and there is no verbose filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool is very simple with no parameters and an output schema exists (not shown but indicated). The description is brief but covers the essential purpose. Could add context about what the vocabulary consists of, but overall adequate.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
No parameters exist, so schema coverage is 100%. Baseline for 0 parameters is 4, and the description adds no param info, which is acceptable.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action 'Get current custom vocabulary.' It uses a specific verb and resource, and it distinguishes itself from sibling tools like set_custom_vocabulary and delete_custom_vocabulary.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool versus alternatives. The usage is implied by the name and description, but no when-not or alternative suggestions are provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_file_contentC
Get completed transcription content by order_id.
| Name | Required | Description | Default |
|---|---|---|---|
| order_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description must carry full burden. It implies read-only operation but does not disclose behavior for incomplete transcriptions, invalid order_ids, or response format.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence is concise but under-specified. It is front-loaded but does not earn its place fully due to lacking details.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Simple tool with 1 param and output schema exists, so return values are not needed. However, missing context about completion requirement and usage scenarios.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema has 1 required param 'order_id' with 0% description coverage. Description mentions 'by order_id' confirming purpose but lacks format, constraints, or examples.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description states verb 'Get', resource 'transcription content', and method 'by order_id'. It is clear but does not differentiate from siblings like 'export_transcription' or 'get_file_detail'.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives. Among 24 sibling tools, no exclusions or comparisons are provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_file_detailB
Get metadata/details for a transcription file by order_id.
| Name | Required | Description | Default |
|---|---|---|---|
| order_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Without annotations, the description only indicates a read operation. It does not disclose error handling, authorization requirements, or other behavioral traits beyond the basic purpose.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise and front-loaded, with a single sentence directly stating the action and key qualifier. No wasted words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the presence of an output schema, the description does not need to detail return values. However, it misses prerequisites or constraints (e.g., file existence, permissions) that would improve completeness for a simple tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description adds minimal meaning to the order_id parameter beyond its name, stating it is used to identify the file. Schema description coverage is 0%, but the parameter name is self-explanatory.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it retrieves metadata/details for a transcription file using order_id, distinguishing it from sibling tools like get_file_content or list_files.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit usage guidelines or alternative tools are mentioned. The description implies use when metadata is needed for a specific file, but lacks when-not-to-use or comparison to similar tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_meeting_detailC
Get meeting details by meeting order_id.
| Name | Required | Description | Default |
|---|---|---|---|
| order_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the full burden of behavioral disclosure. It only states 'Get meeting details' without mentioning read-only nature, authentication, error conditions, or any side effects.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is very concise (one short sentence) and front-loaded. However, it is too brief to be fully effective. It earns its place but lacks necessary detail.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool is simple (single param, output schema exists), the description is minimal. It does not explain the context of 'meeting' or how order_id relates to other tools. The agent would need additional knowledge to use it correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must compensate. It adds 'by meeting order_id' but does not explain what order_id represents, its format, or how to obtain it. The single parameter is poorly described.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'Get' and resource 'meeting details', and specifies the identifier 'order_id'. It distinguishes from sibling tools like get_file_detail or get_summary.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives, no prerequisites or exclusions. The description does not mention anything about context or when not to use it.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_summaryB
Get AI-generated summary for a transcription. Not every transcription has a summary.
| Name | Required | Description | Default |
|---|---|---|---|
| order_id | Yes | ||
| download_summary_json | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must disclose behavioral traits. It only states the purpose and a condition on availability, but does not mention that the operation is read-only, has no side effects, or any other behavioral details.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is very concise with two sentences. The first sentence states the purpose, and the second adds an important condition. No unnecessary words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
While the output schema exists and can describe return values, the description lacks parameter explanations and does not fully compensate for the missing schema descriptions. It is incomplete for a 2-parameter tool with 0% schema coverage.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description should explain the parameters. It does not mention 'order_id' or 'download_summary_json', leaving their meaning and usage unclear.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool retrieves an AI-generated summary for a transcription, using a specific verb and resource. It is distinct from sibling tools which perform other actions like transcribing, deleting, or listing.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description mentions that not every transcription has a summary, providing a condition for when the tool might return no result. However, it lacks explicit guidance on when to use this tool versus alternatives or any prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_user_detailsA
Get Transkriptor account/user details, such as remaining minutes.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations are absent, so description carries the burden. It indicates a read operation with no side effects, but doesn't disclose authentication requirements or data freshness. Acceptable for a simple get.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single, front-loaded sentence with no wasted words. Perfectly concise.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no parameters and an output schema present, the description is adequate. Could list more fields, but the example suffices for a simple operation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
No parameters exist, so baseline is 4. Description adds value by mentioning an example of returned data (remaining minutes), beyond the empty schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool retrieves account/user details, with a specific example (remaining minutes). It distinctively differs from sibling tools focused on files, webhooks, etc.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives or any prerequisites. The description only states what it does without context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
list_filesA
List files in the Transkriptor account. Without folder_id, returns root/unfiled files only. Pass a folder_id (from list_folders) to list files inside that folder.
| Name | Required | Description | Default |
|---|---|---|---|
| folder_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It describes two operation modes but does not disclose behavioral traits like read-only nature, pagination, or rate limits. The output schema exists, covering return values, but additional context would be helpful.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three concise sentences: first states the purpose, second and third provide usage details. No redundant information, well-structured and easy to parse.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the output schema documents return values, the description adequately explains input behavior. However, it could mention if pagination or filtering is supported, which is common for list operations.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description provides complete semantic meaning for the single parameter folder_id, explaining that omitting it returns root files and including it lists files in that folder. Since schema description coverage is 0%, the description fully compensates.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool lists files in the Transkriptor account, with a specific default behavior (root/unfiled files) and the ability to list files inside a folder via folder_id. This distinguishes it from sibling tools like list_folders or get_file_detail.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly tells the user when to use the tool without folder_id (root files) and with folder_id (files in that folder). It provides clear context, though it does not explicitly state when not to use it or mention alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
list_foldersA
List folders in the Transkriptor account. Each item has folder_id and folder_name.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries full burden. It discloses return items have folder_id and folder_name, but does not mention read-only nature, authorization, or pagination.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, no unnecessary words. Front-loaded with the action, then specifies return fields. Highly concise and well-structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple list tool with no parameters and output schema present, the description provides the essential return field names. However, it could be more complete by mentioning if pagination or ordering options exist.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Input schema has no parameters, so description adds no param info. Baseline 4 is appropriate given schema coverage is 100% and no parameter documentation needed.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool lists folders in the Transkriptor account, with a specific verb and resource. It distinguishes from siblings by being the only folder-listing tool.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool versus alternatives, but the purpose is straightforward and no sibling folder tools exist that might cause confusion.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
list_knowledgebasesB
List AI Chat knowledgebases.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, and the description lacks behavioral details such as output format, pagination, or ordering. A simple list operation should disclose basic behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise (3 words), front-loading the purpose. It is appropriately sized for a simple operation, though a bit more context could be added.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given low complexity and the presence of an output schema, the description is minimally adequate. It could mention that it returns a list of knowledgebases with identifiers, but the output schema fills that gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
There are 0 parameters and 100% schema coverage. The description adds no parameter information, but the baseline for 0 parameters is 4, and no further explanation is needed.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'List AI Chat knowledgebases', specifying the verb and resource. It distinguishes from siblings like create_knowledgebase, though no explicit differentiation is provided.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for listing knowledgebases but offers no guidance on when to use versus alternatives like create_knowledgebase or chat_with_knowledgebase.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
list_webhooksA
List all webhooks, or view a specific webhook by webhookType.
| Name | Required | Description | Default |
|---|---|---|---|
| webhook_type | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It does not disclose behavioral traits like read-only nature, absence of side effects, or any prerequisites, leaving the agent to infer that the tool is safe.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, front-loaded sentence that conveys the core functionality without extraneous words. Every part adds value.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity and existence of an output schema, the description is adequate but still has gaps: it does not explain the parameter's possible values or any prerequisites for having webhooks to list.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, and the description only implies that 'webhook_type' filters results. It does not specify valid values, format, or constraints, leaving the agent without enough information to correctly populate the parameter.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'list' and the resource 'webhooks', and includes two distinct use cases: listing all or filtering by a specific type. This differentiates it from sibling tools like create/delete_webhook.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides clear context for when to use the tool—either to list all webhooks or view a specific one by type. However, it lacks explicit exclusions or mention of alternatives, such as when to use other tools instead.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
rename_fileC
Rename an existing transcription file.
| Name | Required | Description | Default |
|---|---|---|---|
| order_id | Yes | ||
| file_name | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description must carry the full burden of behavioral disclosure. It only states 'rename' without explaining side effects, permissions, or return value, leaving significant gaps.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence, which is concise but lacks structure. It provides no additional details, making it minimally adequate but not well-organized.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given that there is an output schema and two required parameters with no descriptions, the tool description is incomplete. It does not explain how to use the parameters correctly or what the output represents.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 0% description coverage, and the tool description does not clarify the meaning of 'order_id' or 'file_name'. There is no indication of which parameter is the new name, adding no value beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'rename' and the resource 'transcription file', making the action unambiguous. There are no sibling tools that rename files, so it is easily distinguishable.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives, such as deleting and re-uploading a file. The description offers no context for decision-making.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
set_custom_vocabularyA
Replace custom vocabulary with the provided words/phrases. Maximum 1000 words/phrases. Maximum 6 words per phrase.
| Name | Required | Description | Default |
|---|---|---|---|
| words | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, but the description uses 'Replace' to indicate overwriting behavior and includes limits, adding necessary behavioral context.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences with front-loaded purpose and no wasted words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Tool is simple replacement; limits are given, output schema exists, and description covers key behavior completely.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema has 0% description coverage for the single parameter, but description adds meaning by specifying 'words/phrases' and the phrase limit.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'Replace' and resource 'custom vocabulary', distinguishing it from siblings like delete_custom_vocabulary.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides constraints (max 1000 words/phrases, max 6 words per phrase) but lacks explicit guidance on when to use vs alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
text_to_speechA
Generate speech from text. Pro voices may support emotion; Lite voices do not.
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | ||
| emotion | No | ||
| language | No | pt-BR | |
| speed_rate | No | ||
| voice_name | No | Ravi Ananda | |
| generate_subtitle | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description bears full responsibility for behavioral disclosure. It partially addresses behavior by noting that Pro voices may support emotion while Lite voices do not, but does not reveal other traits such as authentication requirements, rate limits, or what happens if emotion is used with a Lite voice.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two sentences, front-loaded with the core purpose. Every word is useful, no redundancy or filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given six parameters and the presence of an output schema, the description is incomplete. It does not describe what is returned (e.g., audio file, base64), nor does it explain non-obvious parameters like speed_rate or language format. The agent would need to infer or experiment to use the tool effectively.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With 0% schema description coverage, the description must compensate but only adds minimal context for the emotion parameter. It does not explain text, language, speed_rate, voice_name, or generate_subtitle, leaving the agent to guess their meaning and valid values.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool generates speech from text, which is a specific verb and resource. It distinguishes from sibling tools like transcribe_* which do the opposite.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies when to use (to generate speech) but does not explicitly state when not to use or mention alternatives. No exclusions are provided, and the agent must infer usage context from the lack of similar tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
transcribe_local_fileA
Upload and transcribe a local audio/video file. The file must be inside TRANSKRIPTOR_ALLOWED_DIR. Returns an order_id used to check results later.
| Name | Required | Description | Default |
|---|---|---|---|
| service | No | Standard | |
| language | No | pt-BR | |
| file_path | Yes | ||
| folder_id | No | ||
| triggering_word | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries full burden. It discloses that the tool returns an order_id for later result checking, but lacks details on authentication, file size limits, supported formats, or error behavior (e.g., if file not in allowed dir).
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two sentences long, front-loaded with the primary purpose, and every sentence adds value. No redundant or filler text.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 5 parameters and a sibling set with multiple transcription tools, the description is incomplete. It covers file_path and return value (order_id) but omits service, language, folder_id, and triggering_word. The output schema exists, so return value details are not needed, but parameter roles remain unclear.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, meaning the description adds no explanation for the 5 parameters (service, language, folder_id, triggering_word). Only file_path is implied. The description adds minimal meaning beyond the schema's structure.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool uploads and transcribes a local audio/video file, distinguishing it from siblings like transcribe_url. It also mentions a key constraint (file must be in TRANSKRIPTOR_ALLOWED_DIR) and the return of an order_id.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for local files but does not explicitly contrast with sibling tools such as transcribe_url for remote files or transcribe_meeting. The prerequisite about ALLOWED_DIR is mentioned but not expanded into when-to-use guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
transcribe_meetingB
Send Transkriptor bot to a Google Meet, Microsoft Teams, or Zoom meeting. Returns an order_id.
| Name | Required | Description | Default |
|---|---|---|---|
| meeting_url | Yes | ||
| meeting_bot_name | No | ||
| meeting_language | No | pt-BR | |
| summary_template_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so the description must fully convey behaviors. It states the bot is 'sent' and returns an order_id, but omits important details like required permissions, processing time, recording behavior, or error conditions. Minimal transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Extremely concise: two sentences capturing the core action and output. No redundant words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite having output schema, the description does not explain how the order_id should be used or what happens after. With four parameters and no schema coverage, the description leaves the agent guessing about optional behaviors and default language. Incomplete for effective invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%. The description only mentions the meeting URL implicitly by naming platforms, but fails to explain the purpose or constraints of meeting_bot_name, meeting_language, or summary_template_id. Adds no value beyond the parameter names.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action: sending a bot to transcribe meetings from Google Meet, Microsoft Teams, or Zoom, and specifies the return value (order_id). It differentiates from sibling tools like transcribe_local_file and transcribe_url by explicitly targeting live online meetings.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Implicitly indicates use for live meetings via supported platforms, but lacks explicit guidance on when not to use it (e.g., for recorded meetings) or alternatives. No mention of prerequisites or fallbacks.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
transcribe_urlA
Transcribe a publicly accessible URL, such as YouTube, Google Drive, Dropbox, or OneDrive. Returns an order_id used to check results later.
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| service | No | Standard | |
| language | No | pt-BR | |
| file_name | No | ||
| folder_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Discloses the asynchronous nature (returns order_id to check later), which adds value beyond no annotations. However, lacks details on side effects, access requirements, or error states. With no annotations, more could be expected.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two concise sentences, front-loaded with the action and return value. No extraneous information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Describes the basic flow (transcribe URL, get order_id) but omits parameter details, output schema specifics, and behavior under error conditions. Adequate for a simple tool but not comprehensive.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0%: description only mentions 'publicly accessible URL' for the url parameter, but ignores service, language, file_name, and folder_id. Users are left to infer their meaning from names only.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Clearly states the verb 'transcribe' and the resource 'publicly accessible URL', with examples (YouTube, Google Drive, Dropbox, OneDrive). Distinguishes from sibling tools like transcribe_local_file and transcribe_meeting.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Implied usage by listing supported URL types, but does not explicitly state when to use this tool versus alternatives, nor provides prerequisites or when-not-to-use conditions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
25 tool updates
v0.1.0- First observed
add_file_to_knowledgebase - First observed
chat_with_knowledgebase - First observed
create_chat_session - First observed
create_knowledgebase - First observed
create_webhook - First observed
delete_custom_vocabulary - First observed
delete_file - First observed
delete_webhook - First observed
export_transcription - First observed
get_custom_vocabulary - First observed
get_file_content - First observed
get_file_detail - First observed
get_meeting_detail - First observed
get_summary - First observed
get_user_details - First observed
list_files - First observed
list_folders - First observed
list_knowledgebases - First observed
list_webhooks - First observed
rename_file - First observed
set_custom_vocabulary - First observed
text_to_speech - First observed
transcribe_local_file - First observed
transcribe_meeting - First observed
transcribe_url
TDQS
Scored across 25 tools
Every tool targets a distinct operation on different entities (transcription, file, vocabulary, webhook, knowledgebase), with no overlapping functionality. The descriptions clearly differentiate their purposes.
All tool names follow a consistent verb_noun pattern using snake_case (e.g., create_knowledgebase, list_files, transcribe_url), with no mixing of conventions or vague verbs.
25 tools is on the higher side but still reasonable given the comprehensive feature set (transcription, file management, export, vocabulary, webhooks, knowledgebase, TTS). Each tool serves a clear purpose without bloat.
The tool surface covers core transcription lifecycle, file operations, vocabulary management, webhooks, and knowledgebase chat. Minor gaps like missing cancellation or status polling tools, but overall well-rounded.
Maintenance
Related MCP Connectors
Transcribe audio & video to text for AI agents: 100+ languages, speaker labels, webhooks.
AI transcription from URLs or files. 119 languages, diarization, SRT/VTT/text export.
- mcpOAuthso.transcribe
Transcribe audio and video into speaker-labelled transcripts, subtitles, clips, and cited Q&A.
Transcribe public videos & audio (YouTube, TikTok, IG) into accurate, timestamped text via API.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables access to Fireflies.ai API for retrieving, searching, and summarizing meeting transcripts with various filtering options and formats.5-
- AlicenseNot gradedqualityDmaintenanceEnables speech-to-text transcription, text-to-speech synthesis, and audio analysis using Deepgram's AI models. Supports features like speaker diarization, sentiment analysis, language detection, and various audio processing capabilities.2MIT
- AlicenseNot gradedqualityDmaintenanceProvides translation capabilities using the DeepL API, supporting text translation between numerous languages, rephrasing, batch translation, document translation, and language detection with formality control.4MIT
- FlicenseAqualityNot gradedmaintenanceProvides access to Whissle AI services for speech-to-text, speaker diarization, translation, and text summarization. It enables users to process various audio formats and manage text content through natural language tools.5-