TRAECNclaw MCP
TRAECNclaw MCP Skill
正規のTRAECNclaw 0.6.0からコミット
40bcf7707ed9b0ff7938aea8e511d0b87d300705で生成されました。
TRAECNclawは、ユーザーのMac上でTraeCNデスクトップアプリを操作するためのローカルファーストのMCPサーバーおよびAgent Skillです。このリポジトリは公開配布ミラーであり、ポータブルなSkill、インストール可能なサーバーアーカイブ、来歴、マーケットプレイスのメタデータを保持していますが、非公開の正規履歴は公開していません。
TRAECNclawは、MCPコントラクトバージョン5を公開しており、正確に20個の安定した単一意図ツールを備えています。通常のAgentフローは次のとおりです。
必要なときだけワークスペースを開きます。
必要なときだけモデルまたはモードを選択します。
1つのメッセージを送信し、呼び出し元のコンテキストを解放します。
レガシー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 toolstraecn_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.
| Name | Required | Description | Default |
|---|---|---|---|
| answer | Yes | The user's answer to the pending question. |
Output Schema
| Name | Required | Description |
|---|---|---|
| code | No | Stable machine-readable result or error code. |
| error | No | Error identifier or diagnostic when the operation failed. |
| status | No | Stable operation or task status. |
| taskId | No | Stable gateway task identifier. |
| changed | No | Whether visible TraeCN state changed. |
| message | No | Human-readable outcome summary. |
| success | No | Whether the operation succeeded. |
| retryable | No | Whether retrying the same call can succeed later. |
| nextAction | No | Suggested next step after a failure. |
| conversationId | No | Stable TraeCN conversation identifier. |
| resumedTaskIds | No | Gateway tasks resumed automatically after the interaction resolved. |
traecn_cancel_taskCancel TraeCN TaskADestructive
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.
| Name | Required | Description | Default |
|---|---|---|---|
| taskId | Yes | Stable task identifier returned by traecn_send_message. |
Output Schema
| Name | Required | Description |
|---|---|---|
| code | No | Stable machine-readable result or error code. |
| error | No | Error identifier or diagnostic when the operation failed. |
| status | No | Stable operation or task status. |
| taskId | No | Echoed task identifier. |
| changed | No | Whether visible TraeCN state changed. |
| message | No | Human-readable outcome summary. |
| success | No | Whether the operation succeeded. |
| retryable | No | Whether retrying the same call can succeed later. |
| nextAction | No | Suggested next step after a failure. |
| stopResult | No | Outcome of stopping visible generation when the task was mid-flight. |
| conversationId | No | Stable 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.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| code | No | Stable machine-readable result or error code. |
| error | No | Error identifier or diagnostic when the operation failed. |
| fresh | No | Whether the active context is ready for a first message. |
| action | No | Conversation operation performed. |
| status | No | Stable operation or task status. |
| taskId | No | Stable gateway task identifier. |
| changed | No | Whether visible TraeCN state changed. |
| deleted | No | Number of conversations removed (delete only). |
| message | No | Human-readable outcome summary. |
| success | No | Whether the operation succeeded. |
| retryable | No | Whether retrying the same call can succeed later. |
| nextAction | No | Suggested next step after a failure. |
| actualTitle | No | Title actually visible at decision time (delete mismatch only). |
| recoverable | No | Always false for deletion; the gateway cannot restore conversations. |
| expectedTitle | No | Title compared against the visible conversation (delete mismatch only). |
| conversationId | No | Native identity when allocated; null for an empty draft. |
| creationDeferred | No | True when TraeCN will allocate the conversation identity on its first message. |
traecn_decide_approvalDecide TraeCN ApprovalADestructive
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.
| Name | Required | Description | Default |
|---|---|---|---|
| reason | No | For approve, a concise authorization reason recorded in the local security audit log. | |
| decision | Yes | The approval decision. | |
| acknowledgeRisk | No | For approve, must be true after checking the command against the user-authorized scope. | |
| expectedCommand | No | For approve, the exact command returned with the pending interaction. |
Output Schema
| Name | Required | Description |
|---|---|---|
| code | No | Stable machine-readable result or error code. |
| error | No | Error identifier or diagnostic when the operation failed. |
| status | No | Stable operation or task status. |
| taskId | No | Stable gateway task identifier. |
| changed | No | Whether visible TraeCN state changed. |
| message | No | Human-readable outcome summary. |
| success | No | Whether the operation succeeded. |
| retryable | No | Whether retrying the same call can succeed later. |
| nextAction | No | Suggested next step after a failure. |
| conversationId | No | Stable TraeCN conversation identifier. |
| resumedTaskIds | No | Gateway tasks resumed automatically after the interaction resolved. |
traecn_delete_conversationDelete TraeCN ConversationADestructive
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.
| Name | Required | Description | Default |
|---|---|---|---|
| expectedTitle | Yes | Exact title returned by traecn_list_conversations. | |
| conversationId | Yes | Stable identifier returned by traecn_list_conversations. | |
| acknowledgePermanentDeletion | Yes | Must be true to acknowledge that the gateway cannot restore the deleted conversation. |
Output Schema
| Name | Required | Description |
|---|---|---|
| code | No | Stable machine-readable result or error code. |
| error | No | Error identifier or diagnostic when the operation failed. |
| action | No | Conversation operation performed. |
| status | No | Stable operation or task status. |
| taskId | No | Stable gateway task identifier. |
| changed | No | Whether visible TraeCN state changed. |
| deleted | No | Number of conversations removed (delete only). |
| message | No | Human-readable outcome summary. |
| success | No | Whether the operation succeeded. |
| retryable | No | Whether retrying the same call can succeed later. |
| nextAction | No | Suggested next step after a failure. |
| actualTitle | No | Title actually visible at decision time (delete mismatch only). |
| recoverable | No | Always false for deletion; the gateway cannot restore conversations. |
| expectedTitle | No | Title compared against the visible conversation (delete mismatch only). |
| conversationId | No | Stable TraeCN conversation identifier. |
traecn_get_taskGet TraeCN TaskARead-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.
| Name | Required | Description | Default |
|---|---|---|---|
| taskId | Yes | Stable task identifier returned by traecn_send_message. | |
| detailLevel | No | result returns only the final answer (default); trace includes the full visible Trae execution process. |
Output Schema
| Name | Required | Description |
|---|---|---|
| code | No | Stable machine-readable result or error code. |
| error | No | Original task error, or null when no execution error was recorded. |
| result | No | Final agent answer payload: text, stable flag, elapsedMs; or code/error when unavailable. |
| status | No | Task status such as queued, executing, done, error, cancelled, awaiting_review, approval_required. |
| taskId | No | Echoed task identifier. |
| changed | No | Whether visible TraeCN state changed. |
| elapsed | No | Milliseconds elapsed since creation. |
| message | No | Human-readable outcome summary. |
| success | No | Whether the operation succeeded. |
| lastStep | No | Most recent execution step summary (trace level). |
| metadata | No | Gateway bookkeeping metadata recorded with the task. |
| createdAt | No | Epoch milliseconds when the task was created. |
| errorCode | No | Stable code when the task itself failed. |
| retryable | No | Whether retrying the same call can succeed later. |
| stepCount | No | Number of recorded execution steps. |
| nextAction | No | Suggested next step after a failure. |
| completedAt | No | Task completion time: epoch milliseconds, an ISO 8601 timestamp from persisted history, or null when unavailable. |
| detailLevel | No | Requested detail level. |
| fromHistory | No | True when served from persisted history instead of the active queue. |
| detailWarning | No | Present when trace details could not be fully recovered. |
| historyStatus | No | Internal history status when the task already left the active queue. |
| conversationId | No | Stable TraeCN conversation identifier. |
traecn_list_conversationsList TraeCN ConversationsARead-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.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| code | No | Stable machine-readable result or error code. |
| mode | No | TraeCN mode the list belongs to (solo, ide, unknown). |
| error | No | Error identifier or diagnostic when the operation failed. |
| status | No | Stable operation or task status. |
| taskId | No | Stable gateway task identifier. |
| changed | No | Whether visible TraeCN state changed. |
| message | No | Human-readable outcome summary. |
| success | No | Whether the operation succeeded. |
| retryable | No | Whether retrying the same call can succeed later. |
| nextAction | No | Suggested next step after a failure. |
| conversations | No | Conversations with stable identifiers. |
| conversationId | No | Stable TraeCN conversation identifier. |
traecn_list_modelsList TraeCN ModelsARead-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.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| code | No | Stable machine-readable result or error code. |
| error | No | Error identifier or diagnostic when the operation failed. |
| models | No | |
| status | No | Stable operation or task status. |
| taskId | No | Stable gateway task identifier. |
| changed | No | Whether visible TraeCN state changed. |
| current | No | Currently selected model name. |
| message | No | Human-readable outcome summary. |
| success | No | Whether the operation succeeded. |
| retryable | No | Whether retrying the same call can succeed later. |
| nextAction | No | Suggested next step after a failure. |
| conversationId | No | Stable TraeCN conversation identifier. |
| manualModelsHidden | No | True when Auto mode hides manual models from the native picker. |
traecn_list_setting_optionsList TraeCN Setting OptionsARead-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.
| Name | Required | Description | Default |
|---|---|---|---|
| label | Yes | Setting label exactly as returned by traecn_list_settings. | |
| section | Yes | Section name exactly as returned by traecn_list_setting_sections. |
Output Schema
| Name | Required | Description |
|---|---|---|
| code | No | Stable machine-readable result or error code. |
| error | No | Error identifier or diagnostic when the operation failed. |
| label | No | Setting label whose choices were read. |
| status | No | Stable operation or task status. |
| taskId | No | Stable gateway task identifier. |
| changed | No | Whether visible TraeCN state changed. |
| message | No | Human-readable outcome summary. |
| options | No | Selectable option texts in UI order. |
| section | No | Section containing the setting. |
| success | No | Whether the operation succeeded. |
| retryable | No | Whether retrying the same call can succeed later. |
| nextAction | No | Suggested next step after a failure. |
| conversationId | No | Stable TraeCN conversation identifier. |
traecn_list_settingsList TraeCN Section SettingsARead-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.
| Name | Required | Description | Default |
|---|---|---|---|
| section | Yes | Section name exactly as returned by traecn_list_setting_sections. |
Output Schema
| Name | Required | Description |
|---|---|---|
| code | No | Stable machine-readable result or error code. |
| error | No | Error identifier or diagnostic when the operation failed. |
| items | No | Settings in the section with their control types. |
| status | No | Stable operation or task status. |
| taskId | No | Stable gateway task identifier. |
| changed | No | Whether visible TraeCN state changed. |
| message | No | Human-readable outcome summary. |
| section | No | Section that was read. |
| success | No | Whether the operation succeeded. |
| sections | No | All visible section names. |
| retryable | No | Whether retrying the same call can succeed later. |
| nextAction | No | Suggested next step after a failure. |
| conversationId | No | Stable TraeCN conversation identifier. |
traecn_list_setting_sectionsList TraeCN Settings SectionsARead-onlyIdempotent
List the settings sections currently visible in TraeCN's settings UI. Required first step for any settings operation; never guess a section name.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| code | No | Stable machine-readable result or error code. |
| error | No | Error identifier or diagnostic when the operation failed. |
| status | No | Stable operation or task status. |
| taskId | No | Stable gateway task identifier. |
| changed | No | Whether visible TraeCN state changed. |
| message | No | Human-readable outcome summary. |
| success | No | Whether the operation succeeded. |
| sections | No | Visible settings section names in UI order. |
| retryable | No | Whether retrying the same call can succeed later. |
| nextAction | No | Suggested next step after a failure. |
| conversationId | No | Stable 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.
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Absolute local folder path. |
Output Schema
| Name | Required | Description |
|---|---|---|
| cdp | No | CDP endpoint coordinates for gateway control. |
| args | No | Launch arguments when TraeCN had to be started. |
| code | No | Stable machine-readable result or error code. |
| error | No | Error identifier or diagnostic when the operation failed. |
| status | No | Stable operation or task status. |
| taskId | No | Stable gateway task identifier. |
| binPath | No | TraeCN binary path used by the gateway. |
| changed | No | Whether visible TraeCN state changed. |
| command | No | Launch command when TraeCN had to be started. |
| message | No | Human-readable outcome summary. |
| success | No | Whether the operation succeeded. |
| retryable | No | Whether retrying the same call can succeed later. |
| nextAction | No | Suggested next step after a failure. |
| projectPath | No | Absolute folder path that was opened. |
| reusedWindow | No | Whether an existing window was reused instead of spawning one. |
| alreadyRunning | No | Whether TraeCN was already running. |
| conversationId | No | Stable TraeCN conversation identifier. |
| verifiedWorkspace | No | Workspace 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.
| Name | Required | Description | Default |
|---|---|---|---|
| conversationId | Yes | Stable identifier returned by traecn_list_conversations. |
Output Schema
| Name | Required | Description |
|---|---|---|
| code | No | Stable machine-readable result or error code. |
| error | No | Error identifier or diagnostic when the operation failed. |
| action | No | Conversation operation performed. |
| status | No | Stable operation or task status. |
| taskId | No | Stable gateway task identifier. |
| changed | No | Whether visible TraeCN state changed. |
| deleted | No | Number of conversations removed (delete only). |
| message | No | Human-readable outcome summary. |
| success | No | Whether the operation succeeded. |
| retryable | No | Whether retrying the same call can succeed later. |
| nextAction | No | Suggested next step after a failure. |
| actualTitle | No | Title actually visible at decision time (delete mismatch only). |
| recoverable | No | Always false for deletion; the gateway cannot restore conversations. |
| expectedTitle | No | Title compared against the visible conversation (delete mismatch only). |
| conversationId | No | Stable TraeCN conversation identifier. |
traecn_select_modeSelect TraeCN ModeAIdempotent
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.
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | Target UI mode. |
Output Schema
| Name | Required | Description |
|---|---|---|
| code | No | Stable machine-readable result or error code. |
| mode | No | Active mode after the switch. |
| error | No | Error identifier or diagnostic when the operation failed. |
| status | No | Stable operation or task status. |
| taskId | No | Stable gateway task identifier. |
| changed | No | Whether visible TraeCN state changed. |
| message | No | Human-readable outcome summary. |
| success | No | Whether the operation succeeded. |
| retryable | No | Whether retrying the same call can succeed later. |
| nextAction | No | Suggested next step after a failure. |
| previousMode | No | Mode active before the switch. |
| alreadyInMode | No | True when the requested mode was already active (no-op). |
| conversationId | No | Stable TraeCN conversation identifier. |
traecn_select_modelSelect TraeCN ModelAIdempotent
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.
| Name | Required | Description | Default |
|---|---|---|---|
| model | Yes | Exact model name as returned by traecn_list_models. |
Output Schema
| Name | Required | Description |
|---|---|---|
| code | No | Stable machine-readable result or error code. |
| error | No | Error identifier or diagnostic when the operation failed. |
| model | No | Model now selected. |
| queued | No | Whether the model queue is busy after switching. |
| status | No | Stable operation or task status. |
| taskId | No | Stable gateway task identifier. |
| changed | No | Whether visible TraeCN state changed. |
| message | No | Human-readable outcome summary. |
| running | No | Whether generation is running on the model after switching. |
| success | No | Whether the operation succeeded. |
| canSubmit | No | Whether a new task may be submitted immediately. |
| retryable | No | Whether retrying the same call can succeed later. |
| nextAction | No | Suggested next step after a failure. |
| queueDetails | No | Queue snapshot for the selected model. |
| switchResult | No | Driver-level switch outcome summary. |
| previousModel | No | Model selected before the switch. |
| conversationId | No | Stable TraeCN conversation identifier. |
| requestedModel | No | Model name that was requested. |
| alreadySelected | No | True 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.
| Name | Required | Description | Default |
|---|---|---|---|
| label | Yes | Setting label exactly as returned by traecn_list_settings. | |
| value | Yes | Option value exactly as returned by traecn_list_setting_options. | |
| section | Yes | Section name exactly as returned by traecn_list_setting_sections. |
Output Schema
| Name | Required | Description |
|---|---|---|
| code | No | Stable machine-readable result or error code. |
| error | No | Error identifier or diagnostic when the operation failed. |
| label | No | Setting label that was written. |
| value | No | Value applied to the setting. |
| result | No | Driver-reported write outcome, including already-in-desired-state. |
| status | No | Stable operation or task status. |
| taskId | No | Stable gateway task identifier. |
| changed | No | Whether visible TraeCN state changed. |
| message | No | Human-readable outcome summary. |
| success | No | Whether the operation succeeded. |
| verified | No | True only when the observed UI value equals the requested value. |
| retryable | No | Whether retrying the same call can succeed later. |
| nextAction | No | Suggested next step after a failure. |
| controlType | No | UI control whose value was read back. |
| conversationId | No | Stable TraeCN conversation identifier. |
| requestedValue | No | Value 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.
| Name | Required | Description | Default |
|---|---|---|---|
| message | Yes | The exact instruction to execute. | |
| conversationId | No | Stable identifier returned by traecn_list_conversations. |
Output Schema
| Name | Required | Description |
|---|---|---|
| ok | No | False when the gateway rejected the submission. |
| code | No | Stable machine-readable result or error code. |
| error | No | Original task error on replay, or submission rejection diagnostic. |
| result | No | Original captured result on a terminal replay. |
| status | No | Accepted for new work, or the original terminal status on an idempotent replay. |
| taskId | No | Stable identifier used by traecn_get_task and traecn_cancel_task. |
| changed | No | Whether visible TraeCN state changed. |
| message | No | Human-readable outcome summary. |
| success | No | Whether the operation succeeded. |
| terminal | No | True when returning the original terminal task without submitting again. |
| retryable | No | Whether retrying the same call can succeed later. |
| nextAction | No | Suggested next step after a failure. |
| conversationId | No | Stable 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.
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | Text content to enter into the field. | |
| label | Yes | Setting label exactly as returned by traecn_list_settings. | |
| section | Yes | Section name exactly as returned by traecn_list_setting_sections. |
Output Schema
| Name | Required | Description |
|---|---|---|
| code | No | Stable machine-readable result or error code. |
| error | No | Error identifier or diagnostic when the operation failed. |
| label | No | Setting label that was written. |
| value | No | Value applied to the setting. |
| result | No | Driver-reported write outcome, including already-in-desired-state. |
| status | No | Stable operation or task status. |
| taskId | No | Stable gateway task identifier. |
| changed | No | Whether visible TraeCN state changed. |
| message | No | Human-readable outcome summary. |
| success | No | Whether the operation succeeded. |
| verified | No | True only when the observed UI value equals the requested value. |
| retryable | No | Whether retrying the same call can succeed later. |
| nextAction | No | Suggested next step after a failure. |
| controlType | No | UI control whose value was read back. |
| conversationId | No | Stable TraeCN conversation identifier. |
| requestedValue | No | Value requested by the caller. |
traecn_set_setting_toggleSet TraeCN Setting ToggleAIdempotent
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.
| Name | Required | Description | Default |
|---|---|---|---|
| label | Yes | Setting label exactly as returned by traecn_list_settings. | |
| enabled | Yes | Desired toggle state. | |
| section | Yes | Section name exactly as returned by traecn_list_setting_sections. |
Output Schema
| Name | Required | Description |
|---|---|---|
| code | No | Stable machine-readable result or error code. |
| error | No | Error identifier or diagnostic when the operation failed. |
| label | No | Setting label that was written. |
| value | No | Value applied to the setting. |
| result | No | Driver-reported write outcome, including already-in-desired-state. |
| status | No | Stable operation or task status. |
| taskId | No | Stable gateway task identifier. |
| changed | No | Whether visible TraeCN state changed. |
| message | No | Human-readable outcome summary. |
| success | No | Whether the operation succeeded. |
| verified | No | True only when the observed UI value equals the requested value. |
| retryable | No | Whether retrying the same call can succeed later. |
| nextAction | No | Suggested next step after a failure. |
| controlType | No | UI control whose value was read back. |
| conversationId | No | Stable TraeCN conversation identifier. |
| requestedValue | No | Value requested by the caller. |
traecn_stop_generationStop Visible GenerationADestructive
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.
| Name | Required | Description | Default |
|---|---|---|---|
| reason | Yes | Concise reason recorded in the local security audit log. | |
| conversationId | Yes | Stable identifier returned by traecn_list_conversations. | |
| acknowledgeUntrackedWork | Yes | Must be true to acknowledge that visible work may belong to the user or another agent. |
Output Schema
| Name | Required | Description |
|---|---|---|
| code | No | Stable machine-readable result or error code. |
| error | No | Error identifier or diagnostic when the operation failed. |
| scope | No | Verified stop scope. |
| reason | No | Driver-reported failure reason when the stop failed. |
| status | No | Stable operation or task status. |
| taskId | No | Stable gateway task identifier. |
| changed | No | Whether visible TraeCN state changed. |
| message | No | Human-readable outcome summary. |
| success | No | Whether the operation succeeded. |
| retryable | No | Whether retrying the same call can succeed later. |
| nextAction | No | Suggested next step after a failure. |
| conversationId | No | Stable TraeCN conversation identifier. |
| activeConversationId | No | Conversation ID actually active (mismatch path). |
| requestedConversationId | No | Conversation ID supplied by the caller (mismatch path). |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
8 tool updates
v0.7.1-glama.1- Changed
traecn_create_conversation5 fields changed- changed
Output schema / descriptionPrevious value: -"Created conversation operation outcome."New value: +"Fresh conversation or empty draft awaiting a native identity." - changed
Output schema / properties / conversationId / descriptionPrevious value: -"Stable TraeCN conversation identifier."New value: +"Native identity when allocated; null for an empty draft." - changed
Output schema / properties / conversationId / typePrevious value: -"string"New value: +[ + "string", + "null" +] - added
Output schema / properties / creationDeferredAdded value: +{ + "description": "True when TraeCN will allocate the conversation identity on its first message.", + "type": "boolean" +} - added
Output schema / properties / freshAdded value: +{ + "description": "Whether the active context is ready for a first message.", + "type": "boolean" +}
- Changed
traecn_get_task5 fields changed- changed
Output schema / properties / completedAt / descriptionPrevious 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." - added
Output schema / properties / completedAt / formatAdded value: +"date-time" - changed
Output schema / properties / completedAt / typePrevious value: -[ - "number", - "null" -]New value: +[ + "number", + "string", + "null" +] - changed
Output schema / properties / error / descriptionPrevious value: -"Error identifier or diagnostic when the operation failed."New value: +"Original task error, or null when no execution error was recorded." - changed
Output schema / properties / error / typePrevious value: -"string"New value: +[ + "string", + "null" +]
- Changed
traecn_list_models1 field changed- added
Output schema / properties / manualModelsHiddenAdded value: +{ + "description": "True when Auto mode hides manual models from the native picker.", + "type": "boolean" +}
- Changed
traecn_open_workspace4 fields changed- added
Output schema / properties / verifiedWorkspace / additionalPropertiesAdded value: +true - changed
Output schema / properties / verifiedWorkspace / descriptionPrevious value: -"Workspace path verified inside the TraeCN window."New value: +"Workspace identity detected in the TraeCN window, or a compatible gateway path string." - added
Output schema / properties / verifiedWorkspace / propertiesAdded 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" + ] + } +} - changed
Output schema / properties / verifiedWorkspace / typePrevious value: -"string"New value: +[ + "string", + "object" +]
- Changed
traecn_select_setting_option3 fields changed- added
Output schema / properties / controlTypeAdded value: +{ + "description": "UI control whose value was read back.", + "enum": [ + "toggle", + "option", + "text" + ], + "type": "string" +} - added
Output schema / properties / requestedValueAdded value: +{ + "description": "Value requested by the caller." +} - added
Output schema / properties / verifiedAdded value: +{ + "description": "True only when the observed UI value equals the requested value.", + "type": "boolean" +}
- Changed
traecn_send_message7 fields changed- changed
Output schema / descriptionPrevious value: -"Accepted task identity, or the gateway rejection with reason."New value: +"Accepted task identity, original terminal replay, or gateway rejection with reason." - changed
Output schema / properties / error / descriptionPrevious value: -"Error identifier or diagnostic when the operation failed."New value: +"Original task error on replay, or submission rejection diagnostic." - changed
Output schema / properties / error / typePrevious value: -"string"New value: +[ + "string", + "null" +] - added
Output schema / properties / resultAdded value: +{ + "description": "Original captured result on a terminal replay.", + "type": [ + "object", + "null" + ] +} - changed
Output schema / properties / status / descriptionPrevious value: -"Acceptance status reported by the gateway."New value: +"Accepted for new work, or the original terminal status on an idempotent replay." - changed
Output schema / properties / status / enumPrevious value: -[ - "accepted" -]New value: +[ + "accepted", + "done", + "error", + "cancelled", + "queue_timeout", + "review_rejected" +] - added
Output schema / properties / terminalAdded value: +{ + "description": "True when returning the original terminal task without submitting again.", + "type": "boolean" +}
- Changed
traecn_set_setting_text3 fields changed- added
Output schema / properties / controlTypeAdded value: +{ + "description": "UI control whose value was read back.", + "enum": [ + "toggle", + "option", + "text" + ], + "type": "string" +} - added
Output schema / properties / requestedValueAdded value: +{ + "description": "Value requested by the caller." +} - added
Output schema / properties / verifiedAdded value: +{ + "description": "True only when the observed UI value equals the requested value.", + "type": "boolean" +}
- Changed
traecn_set_setting_toggle3 fields changed- added
Output schema / properties / controlTypeAdded value: +{ + "description": "UI control whose value was read back.", + "enum": [ + "toggle", + "option", + "text" + ], + "type": "string" +} - added
Output schema / properties / requestedValueAdded value: +{ + "description": "Value requested by the caller." +} - added
Output schema / properties / verifiedAdded value: +{ + "description": "True only when the observed UI value equals the requested value.", + "type": "boolean" +}
20 tool updates
- First observed
traecn_answer_question - First observed
traecn_cancel_task - First observed
traecn_create_conversation - First observed
traecn_decide_approval - First observed
traecn_delete_conversation - First observed
traecn_get_task - First observed
traecn_list_conversations - First observed
traecn_list_models - First observed
traecn_list_setting_options - First observed
traecn_list_setting_sections - First observed
traecn_list_settings - First observed
traecn_open_workspace - First observed
traecn_select_conversation - First observed
traecn_select_mode - First observed
traecn_select_model - First observed
traecn_select_setting_option - First observed
traecn_send_message - First observed
traecn_set_setting_text - First observed
traecn_set_setting_toggle - First observed
traecn_stop_generation
TDQS
Scored across 20 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Hosted remote MCP for protected account access, permissions, activity history and supported undo.
Headless task management for bots, apps and AI agents. Remote MCP server, OAuth or access token.
Control plane for autonomous software labor. Agents claim objectives over MCP with audit trail.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables automation of native Windows desktop applications through screen capture, mouse/keyboard control, and waiting for UI changes, exposing them as MCP tools.1-
- AlicenseNot gradedqualityDmaintenanceProvides desktop automation capabilities (e.g., click, browser snapshot) as MCP tools for DSH agents, enabling computer use via natural language.215 npm5MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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.1MIT
- AlicenseNot gradedqualityAmaintenanceEnables 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 npmMIT