Skip to content

Commit 5b95327

Browse files
committed
refactor: trim mcp status metadata
1 parent 5ae2c1f commit 5b95327

4 files changed

Lines changed: 3 additions & 32 deletions

File tree

src/mcp/catalog.ts

Lines changed: 0 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -15,11 +15,6 @@ type StatusMetadata = {
1515
prerequisites: string[];
1616
docsUrl: string;
1717
agentDocsUrl: string;
18-
firstCommands: string[];
19-
automationInterface: 'mcp-tools';
20-
automationNote: string;
21-
installRequiresHumanApproval: true;
22-
installSafetyNote: string;
2318
};
2419

2520
export function createStatusMetadata(): StatusMetadata {
@@ -63,17 +58,6 @@ export function createStatusMetadata(): StatusMetadata {
6358
],
6459
docsUrl: 'https://agent-device.dev/',
6560
agentDocsUrl: 'https://incubator.callstack.com/agent-device/llms-full.txt',
66-
firstCommands: [
67-
'agent-device help workflow',
68-
'agent-device apps --platform ios',
69-
'agent-device apps --platform android',
70-
],
71-
automationInterface: 'mcp-tools',
72-
automationNote:
73-
'Device automation MCP tools use semantic command contracts and execute through the agent-device client.',
74-
installRequiresHumanApproval: true,
75-
installSafetyNote:
76-
'Agents should not install or update the package unless the human has approved the environment change. If the CLI is missing, ask the human to run the install command, then run the verify command.',
7761
};
7862
}
7963

@@ -111,14 +95,6 @@ export function listTools(): unknown[] {
11195
},
11296
docsUrl: { type: 'string' },
11397
agentDocsUrl: { type: 'string' },
114-
firstCommands: {
115-
type: 'array',
116-
items: { type: 'string' },
117-
},
118-
automationInterface: { type: 'string', const: 'mcp-tools' },
119-
automationNote: { type: 'string' },
120-
installRequiresHumanApproval: { type: 'boolean', const: true },
121-
installSafetyNote: { type: 'string' },
12298
},
12399
required: [
124100
'packageName',
@@ -132,11 +108,6 @@ export function listTools(): unknown[] {
132108
'prerequisites',
133109
'docsUrl',
134110
'agentDocsUrl',
135-
'firstCommands',
136-
'automationInterface',
137-
'automationNote',
138-
'installRequiresHumanApproval',
139-
'installSafetyNote',
140111
],
141112
additionalProperties: false,
142113
},

website/docs/docs/agent-setup.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ Use MCP tools or the CLI in the integrated terminal. If `agent-device` is not on
5454

5555
## MCP server
5656

57-
`agent-device mcp` starts the official stdio MCP server. It exposes direct semantic tools for installed CLI commands, plus a `status` tool that returns package, install, verify, and help metadata. Tools run through semantic command contracts and `AgentDeviceClient`; local-only workflows are explicit boundaries rather than subprocess fallbacks.
57+
`agent-device mcp` starts the official stdio MCP server. It exposes direct semantic tools for installed CLI commands, plus a `status` tool that returns package, install, verify, help, target, and capability metadata. Tools run through semantic command contracts and `AgentDeviceClient`; local-only workflows stay CLI-only rather than subprocess fallbacks.
5858

5959
MCP clients must not use this server as a generic shell runner. If the CLI is missing, agents should ask a human before installing or updating packages, then verify with `agent-device --version` and start with `agent-device help workflow`.
6060

website/docs/docs/commands.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ For MCP-aware clients that support direct tools, run:
2929
agent-device mcp
3030
```
3131

32-
The MCP server exposes direct semantic tools for installed commands. Tools use semantic input contracts through `AgentDeviceClient`; local-only workflows are explicit boundaries rather than subprocess fallbacks. It does not expose generic shell execution over MCP.
32+
The MCP server exposes direct semantic tools for installed commands. Tools use semantic input contracts through `AgentDeviceClient`; local-only workflows stay CLI-only rather than subprocess fallbacks. It does not expose generic shell execution over MCP.
3333

3434
## Navigation
3535

website/docs/docs/security-trust.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ description: Security and trust guidance for agent-device local app automation,
1010
## Local control
1111

1212
- Device automation runs through the installed CLI and platform tooling such as Xcode, ADB, macOS accessibility APIs, and Linux AT-SPI.
13-
- The MCP server exposes direct semantic tools for `agent-device` commands. Tools use semantic contracts through `AgentDeviceClient`; local-only workflows are explicit boundaries rather than subprocess fallbacks. It does not expose generic shell execution over MCP.
13+
- The MCP server exposes direct semantic tools for `agent-device` commands. Tools use semantic contracts through `AgentDeviceClient`; local-only workflows stay CLI-only rather than subprocess fallbacks. It does not expose generic shell execution over MCP.
1414
- Mutating commands should run serially against one session. Use separate sessions/devices for parallel work.
1515

1616
## Sensitive artifacts

0 commit comments

Comments
 (0)