Wanaku

Appearance

Wanaku MCP CLI ​

Overview ​

Command-line interface tool for managing the Wanaku MCP Router via its management API.

Purpose ​

The Wanaku CLI provides a user-friendly interface for:

  • Managing tools and resources
  • Configuring namespaces
  • Monitoring capability services
  • Creating new capability projects
  • Authenticating with the router

Key Features ​

  • Tool Management: Add, list, update, and remove MCP tools
  • Resource Management: Manage MCP resources and providers
  • Namespace Support: Organize tools and resources across namespaces
  • Capability Monitoring: View registered capability services and their health
  • Project Scaffolding: Generate new tool and provider projects from templates
  • Authentication: OAuth 2.0/OIDC authentication with the router
  • Label Filtering: Advanced filtering using label expressions
  • Plain Output Mode: --plain flag for clean, parsable output without ANSI colors (useful for scripting and piping)

Installation ​

Note: Java 21 or later is required to run Wanaku CLI.

shell
jbang app install wanaku@wanaku-ai/wanaku

Via Binary Download ​

Download the latest release from GitHub releases and extract to your PATH.

PATH Configuration ​

If you installed via get-wanaku.sh, the CLI is placed in $HOME/bin which may not be on your default PATH. See PATH Configuration in the usage guide for setup instructions.

Basic Usage ​

shell
# Authenticate with the router OIDC proxy
wanaku auth login \
  --auth-server http://localhost:8080 \
  --username alice \
  --password

# Or authenticate directly against Keycloak
wanaku auth login \
  --auth-server http://keycloak-host \
  --realm wanaku \
  --username alice \
  --password

# List available tools
wanaku tools list

# Add a new tool
wanaku tools add --uri http://example.com/api --service http

# List resources
wanaku resources list

# View capability services
wanaku capabilities list

# Manage namespaces
wanaku namespaces list
wanaku namespaces create --path ns-qa --name qa --label env=qa
wanaku namespaces show <namespace-id>
wanaku namespaces update <namespace-id> --name qa-updated
wanaku namespaces delete <namespace-id>
wanaku namespaces cleanup --max-age-days 7 -y

# Create a new tool project
wanaku services create tool --name my-tool

Configuration ​

The CLI stores configuration in ~/.wanaku/:

  • credentials - Authentication tokens
  • cli.properties - CLI configuration