Hanzo MCP Server

Python orchestration tools for Hanzo AI. The `hanzo` command itself is now a native binary — https://hanzo.sh

Local serverstdioPython

What is the Hanzo MCP server?

Connect Hanzo to Claude, Cursor or any other MCP client and it stops being a tab you switch to. Python orchestration tools for Hanzo AI. The hanzo command itself is now a native binary — https://hanzo.sh. The hanzo mcp server is what makes that connection.

What the server does

This is the most complete Hanzo SDK — a uv workspace of 60+ composable packages covering the full AI surface: the typed cloud client, an agent framework, the Model Context Protocol server and tools, persistent memory + RAG, distributed compute, and a batteries-included CLI. If you build AI in Python, start here.

Installation

hanzoai on PyPI is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • Docsdocs.hanzo.ai
  • Issuesgithub.com/hanzoai/python-sdk/issues
  • Emailsupport@hanzo.ai
  • flow — what it does
  • Package — Purpose
  • hanzoai — Typed cloud API client (generated from the Hanzo OpenAPI surface)
  • hanzo — Orchestration helpers and the older Python CLI (console script hanzo-py)
  • hanzo-mcp — Model Context Protocol server — discovers tools via entry points
  • hanzo-network — Distributed AI compute and node orchestration
  • hanzo-memory — Persistent memory + RAG (SQLite, optional vector backends)
  • hanzo-tools- — 60+ single-concern tool packages (shell, browser, fs, code, vector, iam, …), each exposing a TOOLS list

Credentials and setup notes

Configuration is passed through the environment: HANZO_API_KEY, HANZO_BASE_URL. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 11 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Hanzo.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Hanzo's toolset — Docs, Issues, Email and 8 more — is a fair guide to whether it matches your workflow.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Available tools

ToolWhat it does
Docs[docs.hanzo.ai](https://docs.hanzo.ai)
Issues[github.com/hanzoai/python-sdk/issues](https://github.com/hanzoai/python-sdk/issues)
Emailsupport@hanzo.ai
flowwhat it does
PackagePurpose
hanzoaiTyped cloud API client (generated from the Hanzo OpenAPI surface).
hanzoOrchestration helpers and the older Python CLI (console script hanzo-py).
hanzo-mcpModel Context Protocol server — discovers tools via entry points.
hanzo-networkDistributed AI compute and node orchestration.
hanzo-memoryPersistent memory + RAG (SQLite, optional vector backends).
hanzo-tools-60+ single-concern tool packages (shell, browser, fs, code, vector, iam, …), each exposing a TOOLS list.

How to install the Hanzo MCP server

{
  "mcpServers": {
    "hanzo": {
      "command": "uvx",
      "args": ["hanzoai"],
      "env": {
        "HANZO_API_KEY": "your-value",
        "HANZO_BASE_URL": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
HANZO_API_KEYCredential the server authenticates with.Yes
HANZO_BASE_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • Use Hanzo to Docs.
  • Use Hanzo to Issues.
  • Use Hanzo to Email.

Frequently asked questions

It connects Hanzo to MCP-compatible AI assistants such as Claude and Cursor, exposing 11 tools (Docs, Issues, Email, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Hanzo directly.