execute_ascli_command
Run any Aspera CLI (ascli) command in-process and return structured results for transfers, packages, and administration. Show the equivalent bash command line to the user.
Instructions
Execute any ascli (Aspera CLI) command in-process and return its result.
COMMAND DISPLAY (MANDATORY)
Whenever you execute an ascli command or present its results, you MUST ALWAYS explicitly
show the equivalent command line in your response to the user as bash syntax
(e.g. ascli plugin command --option=value).
SYNTAX args is a JSON array of strings mirroring the CLI command line. Element 0 : plugin name (aoc, faspex5, node, server, config, …). Elements 1+: sub-commands, positional arguments, and --option=value flags in any order. Structured values use an extended-value prefix on the relevant element: "@json:{...}" — inline JSON object or array (preferred: no shell quoting) "@preset:name" — expand a saved preset "@base64:..." — base64-encoded value "@val:..." — literal string (no further decoding) "@secret:name" — secret entered by the user on a web page, never visible to you: use it for a secret the user did not give, e.g. "--password=@secret:password" Note: @stdin: is disabled; @ruby:, @file:, @uri:, @env: depend on the security level of the server. A secret (from @secret:, @vault:, @preset:) must be the whole value: no other prefix before it, not in @extend:.
AUTOMATIC FLAGS The server prepends extra_args to every call (default: --interactive=no --transfer.asynchronous=true). Do NOT repeat them. To override one, include it in args: later values take precedence. Commands never prompt: if credentials are missing, an error is returned; report it and stop.
DISCOVERY — never guess command or field names from training data Step 1 — commands of a plugin, with syntax: ["config", "commands", ""] Returns { syntax, description } for every command of that plugin. Notation: mandatory, [] optional, <a|b> enum, <arg...> variadic, arg:Hash typed. A line ending with <command...> and "(see: )" provides the commands of that path: list them with ["config", "commands", "", "", ...] (command words only). Omit to list the commands of all plugins (large). Step 2 — schema of a Hash argument (shown name:Hash), MANDATORY before calling such a command: ["", "", ..., "help"] Put the literal "help" in place of the Hash argument. Returns field names, types, required flags and descriptions. Never infer fields from server error messages. Step 2b — filter parameters of a list command: ["", "", ..., "--query=help"] Step 3 — all --flags of a plugin, with allowed values: ["config", "options", ""] Documentation: ["config", "documentation", "toc"] → { level, title, anchor } per heading ["config", "documentation", "local", ""] → one README section Presets (saved credentials): ["config", "preset", "overview"]
RESULT FORMAT Structured data is always in structuredContent (a JSON object; lists are under "items"). For lists, text content is limited to 100000 bytes (whole items only); when truncated, a WARNING line gives the real total. Read structuredContent.items for the full dataset — never report counts or search results from a truncated text block.
FILE LIST FOR TRANSFERS For all transfers (upload, download, package send, …), append source paths at the end of args — no --sources flag needed.
EXAMPLES ["config", "commands", "aoc"] ["aoc", "admin", "user", "create", "help"] ["config", "options", "aoc"] ["config", "documentation", "local", "leveraging-ai-assistance"] ["aoc", "--preset=myaoc", "packages", "list"] ["aoc", "--preset=myaoc", "admin", "user", "create", '@json:{"email":"a@b.com","name":"Alice"}'] ["aoc", "--preset=myaoc", "packages", "send", '@json:{"name":"pkg","recipients":["user@example.com"]}', "/local/a.txt", "/local/b.txt"] ["server", "--preset=myserver", "upload", "--to-folder=/uploads", "/local/a.txt"] ["server", "browse", "/", "--url=ssh://host:33001", "--username=user", "--password=secret"]
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"args": "<args>"
},
"name": "execute_ascli_command"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| args | Yes | ascli arguments: first element is the plugin name, followed by action and --option=value flags |