Hanzo AI

MCP

The unified Hanzo MCP — one server that gives Claude Code, Cursor, and any MCP client a single tool surface plus your connected cloud services.

MCP

One Model Context Protocol server, one tool surface. Add hanzo-mcp to Claude Code (or Cursor, Claude Desktop, or any MCP client) and every Hanzo capability shows up through a single connection — no per-tool wiring.

Looking for the hosted MCP server instead? Cloud MCP is a URL with nothing to install, and its every tool is enumerated in the tool catalogue. This page is the server that runs beside your editor.

claude mcp add hanzo -- npx -y @hanzo/mcp serve

That one command exposes the full surface:

  • 13 unified toolsfs, exec, code, git, fetch, workspace, ui, plus optional think, memory, hanzo, plan, tasks, mode. One action-routed tool per capability (HIP-0300), so the client sees a small, stable set instead of hundreds of overlapping names.
  • Cloud services — the hanzo tool routes to your platform natively: IAM (identity), Commerce, Storage, and the AI API at api.hanzo.ai/v1, authenticated with your token.
  • Your connectors — GitHub, Slack, Google, Discord, X, and more, surfaced through the same connection once linked in the console.

The same surface ships three ways — TypeScript (@hanzo/mcp), Python (hanzo-mcp on PyPI), and Rust (hanzo-mcp::brain) — mirrored 1-to-1, over the MCP stdio and streamable-http transports.

Client setup

{
  "mcpServers": {
    "hanzo": {
      "command": "npx",
      "args": ["-y", "@hanzo/mcp", "serve"]
    }
  }
}

Sign in once (hanzo auth login) and the hanzo cloud tool + your connectors authenticate automatically; the local tools (fs, exec, git, …) work with no account.

The tool index

Every tool the platform can expose is indexed at GET api.hanzo.ai/v1/tools (authenticated). Today that's 1,468 tools across five sources — the unified server presents them through the compact action-routed surface above:

SourceWhat it is
builtinCore local tools (fs, exec, git, code, …)
skillPackaged skills
connectorLinked cloud integrations (GitHub, Slack, Google, Discord, X, …)
agentAgent entry points
functionUser-defined functions

Connectors

Everything Hanzo can connect to, by how you connect it — native connectors you link once in the console (GitHub App, OAuth2), and the open MCP ecosystem indexed live from the official registry. Search across both.

Native connectors

link once in the console
GitHubGitHub App

Repos, issues, PRs, actions, code search.

GitLabOAuth2

Projects, merge requests, pipelines, issues.

SlackOAuth2

Channels, messages, search, notifications.

GoogleOAuth2

Drive, Gmail, Calendar, Sheets.

DiscordOAuth2

Servers, channels, messages.

XOAuth2

Post, read, and search on X.

MCP servers

loading the registry…

MCP as a Service

Beyond the unified server, Hanzo can also host any MCP server for you — deploy from any npx, uvx, or custom package with instant scaling and zero infrastructure to manage.

hanzo mcp launch npx @modelcontextprotocol/server-filesystem

Key Capabilities

  • Any MCP server — Filesystem, Git, SQL, KV, Slack, GitHub, Notion, and more
  • 1-click Deploy — Launch any MCP server with a single command
  • Auto Scaling — Scale from 0 to thousands of instances automatically
  • $0 Idle Cost — Pay only for what you use, no idle charges
  • Secure Sandboxing — Isolated containers with fine-grained permissions
  • 15+ Regions — Edge deployment for lowest latency globally

Launch Methods

NPX Packages

hanzo mcp launch npx @modelcontextprotocol/server-filesystem
hanzo mcp launch npx @modelcontextprotocol/server-github
hanzo mcp launch npx @modelcontextprotocol/server-slack

UVX / Python

hanzo mcp launch uvx mcp-server-sqlite
hanzo mcp launch uvx mcp-server-postgres

Custom Servers

hanzo mcp launch git://github.com/you/mcp-server
hanzo mcp launch docker://your-org/mcp-custom:latest

Configuration

Deploy multiple servers with a single config file:

version: "1"
servers:
  filesystem:
    package: "@modelcontextprotocol/server-filesystem"
    runtime: npx
    args: ["/workspace"]

  database:
    package: "mcp-server-postgres"
    runtime: uvx
    env:
      DATABASE_URL: "${secrets.DATABASE_URL}"

  github:
    package: "@modelcontextprotocol/server-github"
    runtime: npx
    env:
      GITHUB_TOKEN: "${secrets.GITHUB_TOKEN}"

  custom:
    image: "your-org/mcp-custom:latest"
    runtime: docker
    replicas: 3
hanzo mcp deploy

Enterprise Features

Managed Hosting

Deploy to Hanzo Cloud with auto-scaling and monitoring

Secure Sandboxing

Isolated containers with fine-grained permissions

Edge Deployment

15+ global regions for lowest latency

Version Control

Pin versions, rollback instantly, audit trails

Tool Federation

Combine multiple MCP servers into unified endpoints

Config Management

Centralized secrets and environment variable management

Available Tools

CategoryTools
StorageFilesystem, S3, Google Drive, Notion
DatabasesSQL, MySQL, SQLite, KV, DocumentDB
Dev ToolsGit, GitHub, GitLab, Linear, Jira
CommunicationSlack, Discord, Email, Twilio
CloudAWS, GCP, Azure, Kubernetes
AI/MLHugging Face, Weights & Biases, MLflow
WebBrowser automation, Puppeteer, Screenshots
CustomAny Docker container or npm/pip package

Next Evolution: ZAP

MCP made tool integration easy. ZAP makes it fast. Zero-Copy Agent Protocol is the next evolution: zero-copy serialization, 40-50x lower overhead, built for agent swarms at scale.

ZAP includes MCP Gateway Mode for seamless migration.

Documentation

Build Anything with Hanzo. Every model, every tool, one key — in our cloud or on your own machine.

Quickstart

Install the CLI, log in, and make your first call — then see that same call as an SDK method, raw HTTP and an MCP tool.

Cloud MCP

One JSON-RPC endpoint that gives any MCP client 121 tools over the Hanzo cloud, plus the external servers your org registers.

Capabilities

Every Hanzo capability — 124 of them, 2253 operations, generated from the OpenAPI document.

SDKs

Official Hanzo SDKs for every language — Python, TypeScript, Go, Rust, C++, Swift, Kotlin. Two lines per language — the full Cloud SDK and the AI/Agents library.

CLI

The `hanzo` command line — 1751 commands across 96 capabilities, generated from the CLI's own command table.

Coding agents

Run a coding agent in your repo — ours, Claude Code or Codex — from one command.

Guides

One task per page, each written four ways: a CLI command, an SDK call, an HTTP request and an MCP tool.

Concepts

Six ideas the whole API is built out of — tenancy, projects, sandboxes, agents, memory and workflows.

Glossary

One name per idea, and the names other systems use for the same idea. Read the second column when a word here does not match the word you arrived with.

Architecture

How Hanzo Cloud is built today, and the plugin-platform direction it is evolving toward.

The Network

The AI cloud you can run yourself. hanzo.network is hanzod nodes that spawn the same unified cloud binary we run in production — OSS AI cloud in one binary, BYO GPU or K8s, mine on any device, free for public and open-source workloads.

ZAP Protocol

Zero-Copy App Proto — High-performance Cap'n Proto RPC for AI agent communication. 10-100x faster than MCP with post-quantum security.

Hanzo Dev

AI-powered coding assistant for your terminal. Install, configure, and operate Hanzo Dev.

Environments

An environment is derived from the apps that point at it — there is nothing to create. How production, staging and previews actually work.

Events

One ingest endpoint that dispatches on the shape of the body, what each credential may write, and the receipt every wire gets back.

Webhooks

Register an https endpoint, pick events by subject wildcard, and verify the HMAC signature on every delivery.

Credits & billing

What a credit is, how a call draws one down, where the balance lives, and what happens when it reaches zero.

Models

The live model catalogue — every id you can pass, and what it costs.

Pricing

What a request costs — the three Enso tiers, per-token billing for every other model, and the per-call rates for tools, images and audio.

Error codes

Every error code Hanzo Index can return, with its HTTP status and type. The `link` in an error body points here.

Console

The unified cloud console for Hanzo Cloud -- manage every product, key, and organization from one app at console.hanzo.ai.

Hanzo Chat

The chat app on Hanzo Cloud — enso and Zen models, MCP tools, agents, file uploads and RAG. Hosted at chat.hanzo.ai, or self-host it.

Integrations & Extensions

Install and connect Hanzo across your browser, editor, desktop, docs, design tools, and business apps — one API key, one identity, everywhere.

Usage

One usage plane for every AI account you have — rate limits, credits, and spend, across Hanzo and the other providers you already pay for.

Startups

Up to $150,000 in Hanzo Cloud credits for venture-backed startups -- plus $5 free for everyone and bring-your-own-compute.

Run your org

From signup to a running brain, team, and bot for your organization — under ten minutes.

Authentication

How a request proves who it is — the two Hanzo key types, which one may ship in a browser, and how to create, rotate and revoke them.

How is this guide?