Wanaku

Appearance

WanakuA governed action proxy for AI agents

Policy, credentials, and audit for every tool call, agent message, and inference request.

Quickstart
Browse the docs

Get started

Install Wanaku, run your first governed MCP proxy, and learn the architecture.

Deploy and operate

Run Wanaku on Kubernetes, persist state, add authentication, and secure the deployment.

Connect agents and backends

Proxy A2A traffic, inference requests, and semantic routers through Wanaku.

Govern agent actions

Control agent actions with posture, action policies, evaluators, credentials, and audit.

Extend Wanaku

Write evaluator actions, feature crates, and Admin UI plugins.

Reference

Look up environment variables, configuration files, ports, and the management API.

Wanaku: an MCP gateway that governs AI agent actions ​

Wanaku is a governed action proxy for AI agents, and it works as an MCP gateway. It sits between agents and the systems they act on, and it intercepts tool calls, agent-to-agent messages, and inference traffic. Agents never touch backend systems directly: policy, credentials, data controls, and audit happen in the proxy.

Choose your path ​

You want toStart withThen read
Try Wanaku for the first timeQuickstartArchitecture
Move from the Java-based Wanaku 0.2Migrate from Classic WanakuDeploy on Kubernetes and OpenShift
Deploy and run WanakuDeploy and operate WanakuSecure a Wanaku deployment
Connect agents and backendsConnect agents and backendsA2A proxy, Inference proxy
Decide what agents can doGovern agent actionsGovern an MCP server
Add your own logicExtend WanakuFeature crates, Admin UI plugins
Look up a setting or a routeWanaku referenceEnvironment variables
Contribute code or docsContributing to WanakuTesting

Is Wanaku for you? ​

Wanaku is a good fit when:

  • You need policy, identity, and audit in the proxy, not in the agent or the LLM.
  • You want agents to call tools without access to the backends.
  • You want a different tool catalog for each team, tenant, or environment.
  • You want evaluators, safety gates, and custom filters in the action path.

Wanaku is not a good fit yet when:

  • You need clustering. Wanaku runs on a single node.
  • You need a Prometheus exporter or distributed tracing. Wanaku keeps its metrics in memory.

Read Architecture for the other limits of this release.

Which version am I reading? ​

These pages describe the Rust-based Wanaku server. Its early-access builds are development builds of the unreleased Wanaku 0.3.0. Releases up to v0.2.0 contain the Java-based Wanaku, which is deprecated. If you use the Java-based Wanaku, read Migrate from Classic Wanaku.

Get help ​