CLI Tools

CLI tools for interacting with Asya system.

Installation¶

From local repository:

uv pip install -e ./src/asya-cli
#call with: uv run asya-mcp...

Or as uv tool:

uv tool install src/asya-cli
#call with: asya-mcp...

Or from remote repository:

uv tool install git+https://github.com/deliveryhero/asya.git#subdirectory=src/asya-cli
#call with: asya-mcp...

CLI command `asya-mcp`¶

CLI for interacting with MCP Gateway.

List Tools¶

asya-mcp list

Output:

- name: text-processor
  description: Process text with LLM
  parameters:
    text:
      type: string
      required: true

Call Tool¶

asya-mcp call text-processor --text="Hello world"

Output (with SSE streaming):

[.] Envelope ID: 5e6fdb2d-1d6b-4e91-baef-73e825434e7b
Processing: 100% |████████████████████████████████████| , succeeded
{
  "id": "5e6fdb2d-1d6b-4e91-baef-73e825434e7b",
  "status": "succeeded",
  "result": {
    "response": "Processed: Hello world"
  }
}

Get Status¶

asya-mcp status 5e6fdb2d-1d6b-4e91-baef-73e825434e7b

Configuration¶

Set gateway URL:

export ASYA_CLI_MCP_URL=http://localhost:8089/

asya-mcp-forward¶

Port-forwarding utility for local testing.

asya-mcp-forward

Automatically: 1. Port-forwards asya-gateway service to localhost:8089 2. Sets ASYA_CLI_MCP_URL environment variable 3. Keeps port-forward alive until interrupted

See: src/asya-cli/README.md for advanced usage.