Wanaku

Wanaku — A Governed Action Proxy for AI Agents

Wanaku is a governed action proxy for AI agents. It sits between agents and the systems they act on, intercepting Model Context Protocol (MCP) tool calls, agent-to-agent messages, and inference traffic. Before version 0.2.0, the project was named Wanaku MCP Router. It was renamed to Wanaku Governed Execution Proxy to reflect its expanded scope.

Wanaku supports open standards for AI agents and provides first-class integration with enterprise frameworks, including Apache Camel and Quarkus. For example, integration developers build Apache Camel routes and use Wanaku's Camel Integration Capability to publish them as tools. Agents call those tools with parameters, but Wanaku runs the work. Agents never access backend systems directly. The proxy enforces policy, identity, data controls, and audit requirements.

The project name comes from the origin of guanaco, a camelid native to South America.

Key Features

• Agent Isolation — Agents call tools through Wanaku; they never reach backend systems directly
• Policy Enforcement — LLM-powered evaluators + WASM action scripts classify, filter, and block tool calls in the proxy layer
• Identity & Auth — Authentication and authorization via oauth2-proxy and Keycloak, enforced before actions reach backends
• Tool Discovery — Auto-discover tools from upstream MCP servers; integration developers publish Camel routes as tools
• Namespace Isolation — Organize tools and resources across isolated namespaces per team, tenant, or environment
• Extensible Architecture — Plugin system via feature crates and a composable filter pipeline
• Admin Dashboard — Web UI for managing tools, resources, prompts, and forwards
• Container-Ready — Multi-arch images (x86_64, aarch64) published automatically

Quick Start

Install

Download the latest early-access build on Linux or macOS:

curl -fsSL https://raw.githubusercontent.com/wanaku-ai/wanaku/main/get-wanaku.sh | bash

The installer detects the host platform, verifies the release checksum, and installs wanaku-server into $HOME/bin.

Override the destination with WANAKU_INSTALL_DIR.

Run wanaku-server and access http://localhost:8080 to enter the dashboard:

If you prefer a text interface, you may also download and use the Wanaku CLI from theWanaku Barn project.

Learn Wanaku

The easiest way to learn Wanaku is by following the guided tutorial.

The reference documentation, including the complete installation and configuration instructions, is available in the usage guide.

All tools from the remote server now appear in your local catalog. The client has no idea they're forwarded.

Documentation

The Wanaku Documentation website contains the full project documentation.

Contributors working on the project may want to refer to the development documentation:

• Getting Started - Development setup guide
• Architecture - System architecture and components
• Configuration - Environment variables and configuration reference
• Management API - API reference
• Admin UI - Admin dashboard development
• Features / Plugins - Feature crate system
• Plugin Catalog - Publish and configure available UI plugins
• Plugin Development - Guide for writing new feature crates
• Evaluator Engine - WASM-based evaluator
• Action Policies - Deterministic MCP action rules
• Governance Posture - Enforcement modes and fail-safe behavior
• Contributing - Contribution guidelines
• Security - Security policy

Community

• GitHub Issues - Bug reports and feature requests
• Discussions - Ask questions and share ideas

Related Projects

• Wanaku Barn — Utilities for the Wanaku project: OpenShift/Kubernetes operator, CLI client, etc
• Camel Integration Capability — Build Apache Camel routes and publish them as tools that agents can call through Wanaku

License

This project is licensed under the Apache 2.0 License - see the LICENSE file for details.