Skip to main content
Glama

TRAECNclaw MCP Skill

正規のTRAECNclaw 0.6.0からコミット 40bcf7707ed9b0ff7938aea8e511d0b87d300705 で生成されました。

TRAECNclawは、ユーザーのMac上でTraeCNデスクトップアプリを操作するためのローカルファーストのMCPサーバーおよびAgent Skillです。このリポジトリは公開配布ミラーであり、ポータブルなSkill、インストール可能なサーバーアーカイブ、来歴、マーケットプレイスのメタデータを保持していますが、非公開の正規履歴は公開していません。

TRAECNclawは、MCPコントラクトバージョン5を公開しており、正確に20個の安定した単一意図ツールを備えています。通常のAgentフローは次のとおりです。

  1. 必要なときだけワークスペースを開きます。

  2. 必要なときだけモデルまたはモードを選択します。

  3. 1つのメッセージを送信し、呼び出し元のコンテキストを解放します。

  4. レガシーMCPクライアントは永続的な通知を受け取ります。最新の2026-07-28ホストはタスクをネゴシエートし、返された正確なタスクIDにサブスクライブできます。

キューイング、待機、リカバリ、日常的な非コマンド質問、タスク所有権、永続的な完了は、ゲートウェイ管理のままです。

ローカルサーバーは改行区切りのstdioを使用し、MCP 2026-07-28を実装し、初期化ベースの2025-11-25および2024-11-05クライアントと互換性を維持しています。TRAECNclawコントラクトバージョン5はツールサーフェスのバージョンであり、MCPプロトコルリビジョンではありません。独立してネゴシエートされる上流ドラフトのio.modelcontextprotocol/tasks拡張はツールを追加しません。

サーバーのインストール

検証済みのチャネルを通じて正確なリリースをインストールします。

npm install --global @luckycat133/traecnclaw@0.6.0
# or, after `brew info` reports 0.6.0
brew install Luckycat133/tap/traecnclaw

対応するGitHub Releaseは、完全なスコープ付きnpm tarballと決定論的なMCPBバンドルも提供します。無関係なスコープなしのtraecnclaw@0.3.1パッケージは歴史的なものであり、現在のインストールパスではありません。

Related MCP server: nuphus-mcp

Agent Skillのインストール

オープンなSkills CLIを使用して公開GitHubリポジトリからインストールします。

npx skills add https://github.com/Luckycat133/traecnclaw-mcp-skill \
  --skill traecnclaw-mcp \
  -g

または、GitHub Releaseから対応するSkillアーカイブをダウンロードします。Skillは.codex/skills/traecnclaw-mcpにあり、assets/mcp-client-config.json、scripts/setup-mcp.js、およびサーバーランチャーが含まれています。Skillをインストールまたは更新した後、Agentホストを再起動してください。

scripts/setup-mcp.jsを使用してサーバーの検出を検証し、ホストエントリを生成します。通常のランタイムは次のとおりです。

Agent host -> local stdio server -> gateway on the same Mac -> TraeCN

サーバーとゲートウェイは、TraeCNと同じユーザー所有のMac上で実行されます。マーケットプレイスのコンテナはstdioスキーマを検査できますが、クラウドコンテナはユーザーのローカルTraeCNデスクトップを透過的に制御できません。

準備されたOfficial Registryメタデータは、ローカルstdioトランスポートを備えたスコープ付きパッケージ@luckycat133/traecnclaw@0.6.0を使用します。Smithery Localは対応する検証済みMCPBバンドルを使用します。廃止されたsmithery.yaml形式は存在しません。

設定

ゲートウェイのデフォルトはTRAECN_GATEWAY_HOST=127.0.0.1およびTRAECN_GATEWAY_PORT=8788です。非ループバックバインドにはTRAECN_GATEWAY_TOKENが必要です。MCPツールプロファイル設定はありません。

ディスカバリチャネル

同じ公開リポジトリが、SkillおよびMCPディレクトリ提出の正規のソースです。ディレクトリのリストが信頼できるのは、そのバージョン、ローカルstdioトランスポート、macOS要件、20ツール数、および生成されたインストールコマンドがこのリリースと一致する場合のみです。

選択されたチャネルには、ClawHub、Glama、skills.sh、AwesomeSkills.dev、MCP.Directory、MCPB/Smithery Local、そして現在の公開パッケージが存在した後のOfficial MCP RegistryおよびPulseMCPが含まれます。他のディレクトリは、フォークを維持するのではなく、同じ来歴とインストールコピーを再利用する必要があります。

Glama

glama.jsonと生成されたルートDockerfileは、ディレクトリ登録、メンテナ検証、セキュリティ/品質スキャン、およびツールスキーマ検査をサポートします。Dockerfileは現在の公開リリースをインストールし、ゲートウェイトークンやモックブリッジを含むことはありません。

TRAECNclawはローカルstdioサーバーとしてリストされるべきです。GlamaがホストするコンテナをユーザーのMacへの自動リモート接続として説明しないでください。

来歴とチャネルの準備状況については、SOURCE_REVISIONおよびrelease-manifest.jsonを参照してください。

Available Tools

20 tools
traecn_answer_questionAnswer TraeCN QuestionA

Resolve an exceptional question from TraeCN that the gateway could not handle mechanically by supplying the user's decision. The gateway routes the answer to the pending visible prompt and reports the outcome. Only call when a pending interaction exists.

NameRequiredDescriptionDefault
answerYesThe user's answer to the pending question.

Output Schema

NameRequiredDescription
codeNoStable machine-readable result or error code.
errorNoError identifier or diagnostic when the operation failed.
statusNoStable operation or task status.
taskIdNoStable gateway task identifier.
changedNoWhether visible TraeCN state changed.
messageNoHuman-readable outcome summary.
successNoWhether the operation succeeded.
retryableNoWhether retrying the same call can succeed later.
nextActionNoSuggested next step after a failure.
conversationIdNoStable TraeCN conversation identifier.
resumedTaskIdsNoGateway tasks resumed automatically after the interaction resolved.
traecn_cancel_taskCancel TraeCN TaskA
Destructive

Cancel one gateway-tracked task by ID. The gateway stops shepherding the work at its next control point and records the cancellation; results already produced remain in task history. Returns the task identity and post-cancellation status.

NameRequiredDescriptionDefault
taskIdYesStable task identifier returned by traecn_send_message.

Output Schema

NameRequiredDescription
codeNoStable machine-readable result or error code.
errorNoError identifier or diagnostic when the operation failed.
statusNoStable operation or task status.
taskIdNoEchoed task identifier.
changedNoWhether visible TraeCN state changed.
messageNoHuman-readable outcome summary.
successNoWhether the operation succeeded.
retryableNoWhether retrying the same call can succeed later.
nextActionNoSuggested next step after a failure.
stopResultNoOutcome of stopping visible generation when the task was mid-flight.
conversationIdNoStable TraeCN conversation identifier.
traecn_create_conversationCreate TraeCN ConversationA

Prepare a fresh TraeCN conversation for a genuinely new context. Returns a native conversation identity when TraeCN has allocated it; an empty draft returns conversationId=null and creationDeferred=true until its first message. Reuses an already-empty draft; otherwise creates another context. Call once per new context.

NameRequiredDescriptionDefault

No parameters

Output Schema

NameRequiredDescription
codeNoStable machine-readable result or error code.
errorNoError identifier or diagnostic when the operation failed.
freshNoWhether the active context is ready for a first message.
actionNoConversation operation performed.
statusNoStable operation or task status.
taskIdNoStable gateway task identifier.
changedNoWhether visible TraeCN state changed.
deletedNoNumber of conversations removed (delete only).
messageNoHuman-readable outcome summary.
successNoWhether the operation succeeded.
retryableNoWhether retrying the same call can succeed later.
nextActionNoSuggested next step after a failure.
actualTitleNoTitle actually visible at decision time (delete mismatch only).
recoverableNoAlways false for deletion; the gateway cannot restore conversations.
expectedTitleNoTitle compared against the visible conversation (delete mismatch only).
conversationIdNoNative identity when allocated; null for an empty draft.
creationDeferredNoTrue when TraeCN will allocate the conversation identity on its first message.
traecn_decide_approvalDecide TraeCN ApprovalA
Destructive

Approve or deny the unsafe or ambiguous command card currently visible in TraeCN. Approval revalidates the exact expectedCommand against the card and requires acknowledgeRisk plus an audit reason recorded locally; denial needs only the decision. Never approve beyond the scope the user authorized.

NameRequiredDescriptionDefault
reasonNoFor approve, a concise authorization reason recorded in the local security audit log.
decisionYesThe approval decision.
acknowledgeRiskNoFor approve, must be true after checking the command against the user-authorized scope.
expectedCommandNoFor approve, the exact command returned with the pending interaction.

Output Schema

NameRequiredDescription
codeNoStable machine-readable result or error code.
errorNoError identifier or diagnostic when the operation failed.
statusNoStable operation or task status.
taskIdNoStable gateway task identifier.
changedNoWhether visible TraeCN state changed.
messageNoHuman-readable outcome summary.
successNoWhether the operation succeeded.
retryableNoWhether retrying the same call can succeed later.
nextActionNoSuggested next step after a failure.
conversationIdNoStable TraeCN conversation identifier.
resumedTaskIdsNoGateway tasks resumed automatically after the interaction resolved.
traecn_delete_conversationDelete TraeCN ConversationA
Destructive

Permanently delete one inactive TraeCN conversation by stable identifier. Requires the exact expectedTitle returned by traecn_list_conversations plus an explicit irreversible-deletion acknowledgement; there is no gateway recovery path.

NameRequiredDescriptionDefault
expectedTitleYesExact title returned by traecn_list_conversations.
conversationIdYesStable identifier returned by traecn_list_conversations.
acknowledgePermanentDeletionYesMust be true to acknowledge that the gateway cannot restore the deleted conversation.

Output Schema

NameRequiredDescription
codeNoStable machine-readable result or error code.
errorNoError identifier or diagnostic when the operation failed.
actionNoConversation operation performed.
statusNoStable operation or task status.
taskIdNoStable gateway task identifier.
changedNoWhether visible TraeCN state changed.
deletedNoNumber of conversations removed (delete only).
messageNoHuman-readable outcome summary.
successNoWhether the operation succeeded.
retryableNoWhether retrying the same call can succeed later.
nextActionNoSuggested next step after a failure.
actualTitleNoTitle actually visible at decision time (delete mismatch only).
recoverableNoAlways false for deletion; the gateway cannot restore conversations.
expectedTitleNoTitle compared against the visible conversation (delete mismatch only).
conversationIdNoStable TraeCN conversation identifier.
traecn_get_taskGet TraeCN TaskA
Read-onlyIdempotent

Read one known gateway task by ID: status plus final result, or the full execution trace with detailLevel 'trace' for diagnosis. Call once when notified of completion or once later when resuming after a disconnect. Not a progress primitive — do not poll in a tight loop.

NameRequiredDescriptionDefault
taskIdYesStable task identifier returned by traecn_send_message.
detailLevelNoresult returns only the final answer (default); trace includes the full visible Trae execution process.

Output Schema

NameRequiredDescription
codeNoStable machine-readable result or error code.
errorNoOriginal task error, or null when no execution error was recorded.
resultNoFinal agent answer payload: text, stable flag, elapsedMs; or code/error when unavailable.
statusNoTask status such as queued, executing, done, error, cancelled, awaiting_review, approval_required.
taskIdNoEchoed task identifier.
changedNoWhether visible TraeCN state changed.
elapsedNoMilliseconds elapsed since creation.
messageNoHuman-readable outcome summary.
successNoWhether the operation succeeded.
lastStepNoMost recent execution step summary (trace level).
metadataNoGateway bookkeeping metadata recorded with the task.
createdAtNoEpoch milliseconds when the task was created.
errorCodeNoStable code when the task itself failed.
retryableNoWhether retrying the same call can succeed later.
stepCountNoNumber of recorded execution steps.
nextActionNoSuggested next step after a failure.
completedAtNoTask completion time: epoch milliseconds, an ISO 8601 timestamp from persisted history, or null when unavailable.
detailLevelNoRequested detail level.
fromHistoryNoTrue when served from persisted history instead of the active queue.
detailWarningNoPresent when trace details could not be fully recovered.
historyStatusNoInternal history status when the task already left the active queue.
conversationIdNoStable TraeCN conversation identifier.
traecn_list_conversationsList TraeCN ConversationsA
Read-onlyIdempotent

List the conversations available in the current TraeCN mode with stable identifiers accepted by conversation-scoped tools. Read-only; call when choosing or verifying conversation context.

NameRequiredDescriptionDefault

No parameters

Output Schema

NameRequiredDescription
codeNoStable machine-readable result or error code.
modeNoTraeCN mode the list belongs to (solo, ide, unknown).
errorNoError identifier or diagnostic when the operation failed.
statusNoStable operation or task status.
taskIdNoStable gateway task identifier.
changedNoWhether visible TraeCN state changed.
messageNoHuman-readable outcome summary.
successNoWhether the operation succeeded.
retryableNoWhether retrying the same call can succeed later.
nextActionNoSuggested next step after a failure.
conversationsNoConversations with stable identifiers.
conversationIdNoStable TraeCN conversation identifier.
traecn_list_modelsList TraeCN ModelsA
Read-onlyIdempotent

List the model names currently offered in the TraeCN UI and the current selection. If Auto hides manual models, report manualModelsHidden without changing modes. Call before select_model whenever the model choice matters.

NameRequiredDescriptionDefault

No parameters

Output Schema

NameRequiredDescription
codeNoStable machine-readable result or error code.
errorNoError identifier or diagnostic when the operation failed.
modelsNo
statusNoStable operation or task status.
taskIdNoStable gateway task identifier.
changedNoWhether visible TraeCN state changed.
currentNoCurrently selected model name.
messageNoHuman-readable outcome summary.
successNoWhether the operation succeeded.
retryableNoWhether retrying the same call can succeed later.
nextActionNoSuggested next step after a failure.
conversationIdNoStable TraeCN conversation identifier.
manualModelsHiddenNoTrue when Auto mode hides manual models from the native picker.
traecn_list_setting_optionsList TraeCN Setting OptionsA
Read-onlyIdempotent

List the visible choices of one dropdown-style setting identified by section and label. Required before select_setting_option; never invent an option value.

NameRequiredDescriptionDefault
labelYesSetting label exactly as returned by traecn_list_settings.
sectionYesSection name exactly as returned by traecn_list_setting_sections.

Output Schema

NameRequiredDescription
codeNoStable machine-readable result or error code.
errorNoError identifier or diagnostic when the operation failed.
labelNoSetting label whose choices were read.
statusNoStable operation or task status.
taskIdNoStable gateway task identifier.
changedNoWhether visible TraeCN state changed.
messageNoHuman-readable outcome summary.
optionsNoSelectable option texts in UI order.
sectionNoSection containing the setting.
successNoWhether the operation succeeded.
retryableNoWhether retrying the same call can succeed later.
nextActionNoSuggested next step after a failure.
conversationIdNoStable TraeCN conversation identifier.
traecn_list_settingsList TraeCN Section SettingsA
Read-onlyIdempotent

List the individual settings and their control types within one section returned by traecn_list_setting_sections. Read-only discovery preceding any setting mutation; never guess a label.

NameRequiredDescriptionDefault
sectionYesSection name exactly as returned by traecn_list_setting_sections.

Output Schema

NameRequiredDescription
codeNoStable machine-readable result or error code.
errorNoError identifier or diagnostic when the operation failed.
itemsNoSettings in the section with their control types.
statusNoStable operation or task status.
taskIdNoStable gateway task identifier.
changedNoWhether visible TraeCN state changed.
messageNoHuman-readable outcome summary.
sectionNoSection that was read.
successNoWhether the operation succeeded.
sectionsNoAll visible section names.
retryableNoWhether retrying the same call can succeed later.
nextActionNoSuggested next step after a failure.
conversationIdNoStable TraeCN conversation identifier.
traecn_list_setting_sectionsList TraeCN Settings SectionsA
Read-onlyIdempotent

List the settings sections currently visible in TraeCN's settings UI. Required first step for any settings operation; never guess a section name.

NameRequiredDescriptionDefault

No parameters

Output Schema

NameRequiredDescription
codeNoStable machine-readable result or error code.
errorNoError identifier or diagnostic when the operation failed.
statusNoStable operation or task status.
taskIdNoStable gateway task identifier.
changedNoWhether visible TraeCN state changed.
messageNoHuman-readable outcome summary.
successNoWhether the operation succeeded.
sectionsNoVisible settings section names in UI order.
retryableNoWhether retrying the same call can succeed later.
nextActionNoSuggested next step after a failure.
conversationIdNoStable TraeCN conversation identifier.
traecn_open_workspaceOpen TraeCN WorkspaceA

Open one absolute local folder path as the active TraeCN workspace and verify it became active before returning. Call before submitting work that depends on a specific project; afterwards do not repeat the path inside the task message.

NameRequiredDescriptionDefault
pathYesAbsolute local folder path.

Output Schema

NameRequiredDescription
cdpNoCDP endpoint coordinates for gateway control.
argsNoLaunch arguments when TraeCN had to be started.
codeNoStable machine-readable result or error code.
errorNoError identifier or diagnostic when the operation failed.
statusNoStable operation or task status.
taskIdNoStable gateway task identifier.
binPathNoTraeCN binary path used by the gateway.
changedNoWhether visible TraeCN state changed.
commandNoLaunch command when TraeCN had to be started.
messageNoHuman-readable outcome summary.
successNoWhether the operation succeeded.
retryableNoWhether retrying the same call can succeed later.
nextActionNoSuggested next step after a failure.
projectPathNoAbsolute folder path that was opened.
reusedWindowNoWhether an existing window was reused instead of spawning one.
alreadyRunningNoWhether TraeCN was already running.
conversationIdNoStable TraeCN conversation identifier.
verifiedWorkspaceNoWorkspace identity detected in the TraeCN window, or a compatible gateway path string.
traecn_select_conversationSelect TraeCN ConversationA

Make one existing conversation the active target for subsequent visible interaction. Returns the confirmed active conversation identity.

NameRequiredDescriptionDefault
conversationIdYesStable identifier returned by traecn_list_conversations.

Output Schema

NameRequiredDescription
codeNoStable machine-readable result or error code.
errorNoError identifier or diagnostic when the operation failed.
actionNoConversation operation performed.
statusNoStable operation or task status.
taskIdNoStable gateway task identifier.
changedNoWhether visible TraeCN state changed.
deletedNoNumber of conversations removed (delete only).
messageNoHuman-readable outcome summary.
successNoWhether the operation succeeded.
retryableNoWhether retrying the same call can succeed later.
nextActionNoSuggested next step after a failure.
actualTitleNoTitle actually visible at decision time (delete mismatch only).
recoverableNoAlways false for deletion; the gateway cannot restore conversations.
expectedTitleNoTitle compared against the visible conversation (delete mismatch only).
conversationIdNoStable TraeCN conversation identifier.
traecn_select_modeSelect TraeCN ModeA
Idempotent

Switch TraeCN between Solo and IDE mode and confirm the resulting active mode. Switching to the current mode succeeds as a no-op. Call only when the requested mode differs.

NameRequiredDescriptionDefault
modeYesTarget UI mode.

Output Schema

NameRequiredDescription
codeNoStable machine-readable result or error code.
modeNoActive mode after the switch.
errorNoError identifier or diagnostic when the operation failed.
statusNoStable operation or task status.
taskIdNoStable gateway task identifier.
changedNoWhether visible TraeCN state changed.
messageNoHuman-readable outcome summary.
successNoWhether the operation succeeded.
retryableNoWhether retrying the same call can succeed later.
nextActionNoSuggested next step after a failure.
previousModeNoMode active before the switch.
alreadyInModeNoTrue when the requested mode was already active (no-op).
conversationIdNoStable TraeCN conversation identifier.
traecn_select_modelSelect TraeCN ModelA
Idempotent

Select one model by exact name from traecn_list_models and confirm the picker state before returning. Selecting the already-active model succeeds as a no-op. Does not wait for model availability or capacity.

NameRequiredDescriptionDefault
modelYesExact model name as returned by traecn_list_models.

Output Schema

NameRequiredDescription
codeNoStable machine-readable result or error code.
errorNoError identifier or diagnostic when the operation failed.
modelNoModel now selected.
queuedNoWhether the model queue is busy after switching.
statusNoStable operation or task status.
taskIdNoStable gateway task identifier.
changedNoWhether visible TraeCN state changed.
messageNoHuman-readable outcome summary.
runningNoWhether generation is running on the model after switching.
successNoWhether the operation succeeded.
canSubmitNoWhether a new task may be submitted immediately.
retryableNoWhether retrying the same call can succeed later.
nextActionNoSuggested next step after a failure.
queueDetailsNoQueue snapshot for the selected model.
switchResultNoDriver-level switch outcome summary.
previousModelNoModel selected before the switch.
conversationIdNoStable TraeCN conversation identifier.
requestedModelNoModel name that was requested.
alreadySelectedNoTrue when the requested model was already active (no-op).
traecn_select_setting_optionSelect TraeCN Setting OptionA

Select one previously listed option for a dropdown setting identified by section and label, and confirm the applied selection. Only values returned by traecn_list_setting_options are valid.

NameRequiredDescriptionDefault
labelYesSetting label exactly as returned by traecn_list_settings.
valueYesOption value exactly as returned by traecn_list_setting_options.
sectionYesSection name exactly as returned by traecn_list_setting_sections.

Output Schema

NameRequiredDescription
codeNoStable machine-readable result or error code.
errorNoError identifier or diagnostic when the operation failed.
labelNoSetting label that was written.
valueNoValue applied to the setting.
resultNoDriver-reported write outcome, including already-in-desired-state.
statusNoStable operation or task status.
taskIdNoStable gateway task identifier.
changedNoWhether visible TraeCN state changed.
messageNoHuman-readable outcome summary.
successNoWhether the operation succeeded.
verifiedNoTrue only when the observed UI value equals the requested value.
retryableNoWhether retrying the same call can succeed later.
nextActionNoSuggested next step after a failure.
controlTypeNoUI control whose value was read back.
conversationIdNoStable TraeCN conversation identifier.
requestedValueNoValue requested by the caller.
traecn_send_messageSend TraeCN TaskA

Submit one user instruction to TraeCN as durable background work and return its stable taskId immediately; the gateway owns queueing, retries, recovery, and result persistence. Use this for every delegated coding request, optionally targeting an existing conversation via conversationId. Do not send follow-up messages to probe progress — track the returned task instead.

NameRequiredDescriptionDefault
messageYesThe exact instruction to execute.
conversationIdNoStable identifier returned by traecn_list_conversations.

Output Schema

NameRequiredDescription
okNoFalse when the gateway rejected the submission.
codeNoStable machine-readable result or error code.
errorNoOriginal task error on replay, or submission rejection diagnostic.
resultNoOriginal captured result on a terminal replay.
statusNoAccepted for new work, or the original terminal status on an idempotent replay.
taskIdNoStable identifier used by traecn_get_task and traecn_cancel_task.
changedNoWhether visible TraeCN state changed.
messageNoHuman-readable outcome summary.
successNoWhether the operation succeeded.
terminalNoTrue when returning the original terminal task without submitting again.
retryableNoWhether retrying the same call can succeed later.
nextActionNoSuggested next step after a failure.
conversationIdNoStable TraeCN conversation identifier.
traecn_set_setting_textSet TraeCN Setting TextA

Enter one text value into the setting field identified by section and label, and confirm what the field contains afterwards.

NameRequiredDescriptionDefault
textYesText content to enter into the field.
labelYesSetting label exactly as returned by traecn_list_settings.
sectionYesSection name exactly as returned by traecn_list_setting_sections.

Output Schema

NameRequiredDescription
codeNoStable machine-readable result or error code.
errorNoError identifier or diagnostic when the operation failed.
labelNoSetting label that was written.
valueNoValue applied to the setting.
resultNoDriver-reported write outcome, including already-in-desired-state.
statusNoStable operation or task status.
taskIdNoStable gateway task identifier.
changedNoWhether visible TraeCN state changed.
messageNoHuman-readable outcome summary.
successNoWhether the operation succeeded.
verifiedNoTrue only when the observed UI value equals the requested value.
retryableNoWhether retrying the same call can succeed later.
nextActionNoSuggested next step after a failure.
controlTypeNoUI control whose value was read back.
conversationIdNoStable TraeCN conversation identifier.
requestedValueNoValue requested by the caller.
traecn_set_setting_toggleSet TraeCN Setting ToggleA
Idempotent

Enable or disable one toggle setting identified by section and label, then read back the applied state. Applying the already-current state succeeds as a no-op.

NameRequiredDescriptionDefault
labelYesSetting label exactly as returned by traecn_list_settings.
enabledYesDesired toggle state.
sectionYesSection name exactly as returned by traecn_list_setting_sections.

Output Schema

NameRequiredDescription
codeNoStable machine-readable result or error code.
errorNoError identifier or diagnostic when the operation failed.
labelNoSetting label that was written.
valueNoValue applied to the setting.
resultNoDriver-reported write outcome, including already-in-desired-state.
statusNoStable operation or task status.
taskIdNoStable gateway task identifier.
changedNoWhether visible TraeCN state changed.
messageNoHuman-readable outcome summary.
successNoWhether the operation succeeded.
verifiedNoTrue only when the observed UI value equals the requested value.
retryableNoWhether retrying the same call can succeed later.
nextActionNoSuggested next step after a failure.
controlTypeNoUI control whose value was read back.
conversationIdNoStable TraeCN conversation identifier.
requestedValueNoValue requested by the caller.
traecn_stop_generationStop Visible GenerationA
Destructive

Stop only the generation currently visible in the named active TraeCN conversation. Visible output may belong to the user or another agent, so this requires acknowledgeUntrackedWork=true plus an audit reason. Prefer cancel_task whenever a gateway task ID exists.

NameRequiredDescriptionDefault
reasonYesConcise reason recorded in the local security audit log.
conversationIdYesStable identifier returned by traecn_list_conversations.
acknowledgeUntrackedWorkYesMust be true to acknowledge that visible work may belong to the user or another agent.

Output Schema

NameRequiredDescription
codeNoStable machine-readable result or error code.
errorNoError identifier or diagnostic when the operation failed.
scopeNoVerified stop scope.
reasonNoDriver-reported failure reason when the stop failed.
statusNoStable operation or task status.
taskIdNoStable gateway task identifier.
changedNoWhether visible TraeCN state changed.
messageNoHuman-readable outcome summary.
successNoWhether the operation succeeded.
retryableNoWhether retrying the same call can succeed later.
nextActionNoSuggested next step after a failure.
conversationIdNoStable TraeCN conversation identifier.
activeConversationIdNoConversation ID actually active (mismatch path).
requestedConversationIdNoConversation ID supplied by the caller (mismatch path).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 8 tool updatesv0.7.1-glama.1
    • Changedtraecn_create_conversation5 fields changed
      • changedOutput schema / description
        Previous value: -"Created conversation operation outcome."New value: +"Fresh conversation or empty draft awaiting a native identity."
      • changedOutput schema / properties / conversationId / description
        Previous value: -"Stable TraeCN conversation identifier."New value: +"Native identity when allocated; null for an empty draft."
      • changedOutput schema / properties / conversationId / type
        Previous value: -"string"New value: +[
        +  "string",
        +  "null"
        +]
      • addedOutput schema / properties / creationDeferred
        Added value: +{
        +  "description": "True when TraeCN will allocate the conversation identity on its first message.",
        +  "type": "boolean"
        +}
      • addedOutput schema / properties / fresh
        Added value: +{
        +  "description": "Whether the active context is ready for a first message.",
        +  "type": "boolean"
        +}
    • Changedtraecn_get_task5 fields changed
      • changedOutput schema / properties / completedAt / description
        Previous value: -"Epoch milliseconds when the task completed."New value: +"Task completion time: epoch milliseconds, an ISO 8601 timestamp from persisted history, or null when unavailable."
      • addedOutput schema / properties / completedAt / format
        Added value: +"date-time"
      • changedOutput schema / properties / completedAt / type
        Previous value: -[
        -  "number",
        -  "null"
        -]New value: +[
        +  "number",
        +  "string",
        +  "null"
        +]
      • changedOutput schema / properties / error / description
        Previous value: -"Error identifier or diagnostic when the operation failed."New value: +"Original task error, or null when no execution error was recorded."
      • changedOutput schema / properties / error / type
        Previous value: -"string"New value: +[
        +  "string",
        +  "null"
        +]
    • Changedtraecn_list_models1 field changed
      • addedOutput schema / properties / manualModelsHidden
        Added value: +{
        +  "description": "True when Auto mode hides manual models from the native picker.",
        +  "type": "boolean"
        +}
    • Changedtraecn_open_workspace4 fields changed
      • addedOutput schema / properties / verifiedWorkspace / additionalProperties
        Added value: +true
      • changedOutput schema / properties / verifiedWorkspace / description
        Previous value: -"Workspace path verified inside the TraeCN window."New value: +"Workspace identity detected in the TraeCN window, or a compatible gateway path string."
      • addedOutput schema / properties / verifiedWorkspace / properties
        Added value: +{
        +  "folderName": {
        +    "description": "Folder name detected in the TraeCN window.",
        +    "type": "string"
        +  },
        +  "rootPath": {
        +    "description": "Detected absolute workspace root, or null when unavailable.",
        +    "type": [
        +      "string",
        +      "null"
        +    ]
        +  }
        +}
      • changedOutput schema / properties / verifiedWorkspace / type
        Previous value: -"string"New value: +[
        +  "string",
        +  "object"
        +]
    • Changedtraecn_select_setting_option3 fields changed
      • addedOutput schema / properties / controlType
        Added value: +{
        +  "description": "UI control whose value was read back.",
        +  "enum": [
        +    "toggle",
        +    "option",
        +    "text"
        +  ],
        +  "type": "string"
        +}
      • addedOutput schema / properties / requestedValue
        Added value: +{
        +  "description": "Value requested by the caller."
        +}
      • addedOutput schema / properties / verified
        Added value: +{
        +  "description": "True only when the observed UI value equals the requested value.",
        +  "type": "boolean"
        +}
    • Changedtraecn_send_message7 fields changed
      • changedOutput schema / description
        Previous value: -"Accepted task identity, or the gateway rejection with reason."New value: +"Accepted task identity, original terminal replay, or gateway rejection with reason."
      • changedOutput schema / properties / error / description
        Previous value: -"Error identifier or diagnostic when the operation failed."New value: +"Original task error on replay, or submission rejection diagnostic."
      • changedOutput schema / properties / error / type
        Previous value: -"string"New value: +[
        +  "string",
        +  "null"
        +]
      • addedOutput schema / properties / result
        Added value: +{
        +  "description": "Original captured result on a terminal replay.",
        +  "type": [
        +    "object",
        +    "null"
        +  ]
        +}
      • changedOutput schema / properties / status / description
        Previous value: -"Acceptance status reported by the gateway."New value: +"Accepted for new work, or the original terminal status on an idempotent replay."
      • changedOutput schema / properties / status / enum
        Previous value: -[
        -  "accepted"
        -]New value: +[
        +  "accepted",
        +  "done",
        +  "error",
        +  "cancelled",
        +  "queue_timeout",
        +  "review_rejected"
        +]
      • addedOutput schema / properties / terminal
        Added value: +{
        +  "description": "True when returning the original terminal task without submitting again.",
        +  "type": "boolean"
        +}
    • Changedtraecn_set_setting_text3 fields changed
      • addedOutput schema / properties / controlType
        Added value: +{
        +  "description": "UI control whose value was read back.",
        +  "enum": [
        +    "toggle",
        +    "option",
        +    "text"
        +  ],
        +  "type": "string"
        +}
      • addedOutput schema / properties / requestedValue
        Added value: +{
        +  "description": "Value requested by the caller."
        +}
      • addedOutput schema / properties / verified
        Added value: +{
        +  "description": "True only when the observed UI value equals the requested value.",
        +  "type": "boolean"
        +}
    • Changedtraecn_set_setting_toggle3 fields changed
      • addedOutput schema / properties / controlType
        Added value: +{
        +  "description": "UI control whose value was read back.",
        +  "enum": [
        +    "toggle",
        +    "option",
        +    "text"
        +  ],
        +  "type": "string"
        +}
      • addedOutput schema / properties / requestedValue
        Added value: +{
        +  "description": "Value requested by the caller."
        +}
      • addedOutput schema / properties / verified
        Added value: +{
        +  "description": "True only when the observed UI value equals the requested value.",
        +  "type": "boolean"
        +}
  2. 20 tool updates
    • First observedtraecn_answer_question
    • First observedtraecn_cancel_task
    • First observedtraecn_create_conversation
    • First observedtraecn_decide_approval
    • First observedtraecn_delete_conversation
    • First observedtraecn_get_task
    • First observedtraecn_list_conversations
    • First observedtraecn_list_models
    • First observedtraecn_list_setting_options
    • First observedtraecn_list_setting_sections
    • First observedtraecn_list_settings
    • First observedtraecn_open_workspace
    • First observedtraecn_select_conversation
    • First observedtraecn_select_mode
    • First observedtraecn_select_model
    • First observedtraecn_select_setting_option
    • First observedtraecn_send_message
    • First observedtraecn_set_setting_text
    • First observedtraecn_set_setting_toggle
    • First observedtraecn_stop_generation

TDQS

A4.1/5.0

Scored across 20 tools

Disambiguation4/5

The tool set is largely cleanly partitioned: tasks, conversations, settings, models/modes, workspace, and interaction handling each have their own verbs. The only genuinely fuzzy pair is cancel_task vs stop_generation, but the description explicitly tells the agent to prefer cancel_task when a task ID exists, and the settings trio (toggle/option/text) is distinguished by control type. A few tools (list_settings vs list_setting_options vs list_setting_sections) are close cousins but the descriptions establish a clear required ordering.

Naming Consistency5/5

Every tool uses the uniform traecn_<verb>_<noun> snake_case pattern (list_, select_, set_, create_, delete_, get_, cancel_, stop_, send_, open_, answer_, decide_). Verbs are used semantically consistently: list_ for read-only discovery, select_ for choosing from a listed set, set_ for applying a value. No camelCase or style mixing anywhere.

Tool Count4/5

Twenty tools is on the heavy side, but the server spans several distinct sub-domains (task lifecycle, conversation lifecycle, settings discovery/mutation, model/mode selection, approvals, workspace), so most tools earn their place. It is borderline rather than bloated, and consolidation of the four settings tools would make it tighter.

Completeness4/5

Coverage is strong across most lifecycles: tasks (send/get/cancel), conversations (list/select/create/delete), settings (sections/list/options/set/select), models and mode, workspace opening, and interactive prompts (answer_question, decide_approval). Minor gaps remain — there is no list_tasks to enumerate tracked work, no conversation rename, and no workspace listing/current-workspace read — but agents can work around these using the returned taskId.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables automation of native Windows desktop applications through screen capture, mouse/keyboard control, and waiting for UI changes, exposing them as MCP tools.
    1
    -
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to perform deterministic Windows desktop and browser automation through MCP, using pre-validated UI Automation and DOM locators for fast, stable execution of ERP and business workflows.
    1
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables MCP clients to automate live browser sessions by having an LLM plan one outcome at a time while a hosted decision model picks elements, actions, values, and completion status. It exposes tools for navigation, direct actions, page reading/snapshots, checks/choices, screenshots, and calling WebMCP tools registered by pages.
    1,461 npm
    MIT