MCP tools
Understand the capability groups Jio can expose to an agent and the results each operation should return.
Jio presents remote workspace operations through MCP. Exact tool names may vary by build, but they should fall into a small set of understandable capability groups.
Capability groups
| Group | Typical operations | Risk level |
|---|---|---|
| Status | Connection health, workspace identity, policy summary | Low |
| Discovery | List directories, inspect metadata, search text | Low to medium |
| Read | Read files, logs, and command output | Medium when secrets may exist |
| Write | Create, update, move, and delete files | Medium to high |
| Execution | Start commands and collect output | High |
| Version control | Inspect diffs, status, and history | Depends on write and network access |
Expose only the groups the workflow needs. A read-only review agent should not inherit execution merely because the workspace service supports it.
Result contract
A useful tool response gives the agent enough structured information to reason about the next step. Depending on the operation, include:
- whether the request succeeded;
- the workspace-relative target;
- bounded output or a reference to retained output;
- command exit status and duration;
- whether output was truncated;
- the policy rule behind a rejection;
- a retryable versus terminal error signal.
Errors should be actionable without leaking sensitive host details. For example, report that a path is outside the workspace root instead of returning an unrestricted host path traversal.
Approval belongs before execution
Do not start a command and ask for approval after observing its output. The authorization decision must happen before the remote side performs the operation.
Capability discovery
An agent should be able to distinguish unavailable tools from denied operations. Unavailable means the deployment does not expose the capability. Denied means the capability exists, but policy rejected this request. That distinction helps the agent adapt without repeatedly attempting an unsafe action.