Files
skills/public/hanzo-mcp.html
zeekayandHanzo Dev 9e10c1c10e Each llms index points at the other two
hanzoskills.com/llms.txt now opens with the install line, the API
reference index and the company index, so an agent that lands on any
one of the three can find the rest.

robots.txt claimed 537 documents while llms.txt counts 920. The number
is gone from robots.txt; llms.txt derives it.

public/ is regenerated from scripts/site.py, which it had fallen
behind: the copy-prompt menu and agent bar were in the generator and
not in the committed pages. tests/site.mjs passes against the result.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-11 00:27:59 -07:00

359 lines
19 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>hanzo-mcp</title>
<meta name="color-scheme" content="dark">
<style>
/* Committed to one visual world: a dark instrument panel. No light variant —
the dot field and the hairline rules only read on black, and a naive
inversion would wash both out. Every colour is painted explicitly so the page
never borrows a host background. */
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
:root{
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
--font-zen-pixel-square:'Zen Pixel Square',monospace;
--mono:var(--font-zen-mono);
--sans:var(--font-zen-sans);
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
--r:999px; --r-soft:14px;
}
*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
/* The dot field. A halftone made of one repeating radial-gradient, faded out
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
/* No overflow clip here: the dot field is inset to the box already, and a clip
would cut off the copy-prompt menu. */
.hero{position:relative;border-bottom:1px solid var(--line)}
.hero::before{content:"";position:absolute;inset:0;
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
background-size:7px 7px;
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
pointer-events:none}
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
nav{border-bottom:1px solid var(--line)}
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
justify-content:space-between;align-items:center;gap:1rem}
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--ink);text-decoration:none;
display:inline-flex;align-items:center;gap:.6rem}
.brand i{font-style:normal;color:var(--faint)}
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--soft);text-decoration:none}
nav a.up:hover{color:var(--ink)}
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
h1 em{font-style:normal;color:var(--faint)}
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
line-height:1.2;font-weight:400}
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
.btn.solid:hover{background:#d8d8d4}
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
/* Copy-prompt selector. Each row copies the prompt for its own target. */
.copy{position:relative;display:inline-flex}
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
padding:.4rem;display:flex;flex-direction:column;
box-shadow:0 12px 32px rgba(0,0,0,.75)}
.menu[hidden]{display:none}
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
white-space:nowrap}
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
.mi:hover .mark{color:var(--ink)}
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
letter-spacing:.1em;text-transform:uppercase}
/* Works-with bar: one scrolling row, name and mark per agent. */
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
display:flex;align-items:center}
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
-webkit-overflow-scrolling:touch;
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
.bar::-webkit-scrollbar{display:none}
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
text-decoration:none;background:var(--ground)}
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
.agent .mark{width:.95rem;height:.95rem}
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
p{margin:0 0 1rem;max-width:70ch}
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
li{margin:.22rem 0}
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
text-decoration-color:var(--line-hi)}
a:hover{text-decoration-color:var(--ink)}
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
display:block;overflow-x:auto}
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
.curl{display:block;background:var(--panel);border:1px solid var(--line);
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
white-space:pre;line-height:1.9}
.curl b{color:var(--ink);font-weight:400}
.curl i{font-style:normal;color:var(--faint)}
/* index */
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
#q:focus{outline:none;border-color:var(--soft)}
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
text-transform:uppercase;margin:0 0 2rem}
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
padding-bottom:.45rem}
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
border-radius:var(--r-soft);text-decoration:none}
.row:hover{background:#0a0a0a}
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
color:var(--faint);font-size:.85rem}
footer a{color:var(--soft)}
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
margin:0 0 2rem;font-size:.85rem}
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
border-bottom:1px solid var(--line);padding-bottom:.4rem}
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
.fmap a:hover{text-decoration:underline}
.fmap div{color:var(--faint);line-height:1.5}
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
@media (max-width:640px){
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
.btns{gap:.5rem}
.btn{padding:.75rem 1.15rem;font-size:.68rem}
.copy,.copy .btn{width:100%;justify-content:center}
.menu{left:0;right:0;min-width:0}
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
.strip b{border-right:0;padding-right:0}
.bar{width:100%}
}
</style>
<link rel="alternate" type="text/markdown" href="/hanzo-mcp.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/hanzo-mcp">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/hanzo-mcp.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>hanzo-mcp</h1><p class="lede">Hanzo MCP implements the Model Context Protocol -- an open standard for exposing tools, resources, and prompts to AI agents.</p><h1>Hanzo MCP - Model Context Protocol</h1>
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-zap.md</code>, <code>hanzo/hanzo-agent.md</code>, <code>hanzo/hanzo-dev.md</code></p>
<h2>Overview</h2>
<p>Hanzo MCP implements the <strong>Model Context Protocol</strong> -- an open standard for exposing tools, resources, and prompts to AI agents. Ships <strong>13 HIP-0300 unified tools</strong> (7 core + 6 optional) with action-based routing. 260+ tools across the ecosystem. ZAP-native: any ZAP service gets MCP tools for free.</p>
<h2>When to use</h2>
<ul><li>Exposing tools, resources, and prompts to AI agents</li><li>Building MCP servers for custom services</li><li>Connecting MCP clients to Hanzo infrastructure</li><li>Agentic workflows with multi-agent coordination</li><li>Browser extensions that need MCP tool access</li></ul>
<h2>Hard requirements</h2>
<ol><li><strong>Node.js &gt;= 18</strong> for the MCP server</li><li><strong>MCP protocol compliance</strong>: tools, resources, and prompts follow the spec</li><li><strong>ZAP integration</strong>: ZAP services automatically expose MCP interfaces</li></ol>
<h2>Quick reference</h2>
<p>| Item | Value | |------|-------| | npm | <code>@hanzo/mcp</code> | | Version | 2.4.1 | | Binary | <code>hanzo-mcp</code> | | Node | &gt;= 18 | | Repo | <code>github.com/hanzoai/mcp</code> | | Total tools | 260+ across ecosystem | | Core tools | 13 HIP-0300 unified |</p>
<h2>What is MCP?</h2>
<p>Model Context Protocol standardizes how AI agents access:</p>
<ul><li><strong>Tools</strong>: Executable functions (run inference, query database, deploy service)</li><li><strong>Resources</strong>: Contextual data (codebase, documentation, schemas)</li><li><strong>Prompts</strong>: Reusable workflow templates</li></ul>
<h2>Install and CLI</h2>
<pre><code class="lang-bash"># Install globally
npm install -g @hanzo/mcp
# Serve MCP server
hanzo-mcp serve
# List available tools
hanzo-mcp list-tools
# Install for desktop apps (Claude, etc.)
hanzo-mcp install-desktop</code></pre>
<h2>13 HIP-0300 unified tools</h2>
<p>The core tool set uses action-based routing where each tool handles multiple operations:</p>
<p>| Tool | Actions | Purpose | |------|---------|---------| | <code>hanzo_read</code> | file, dir, url, resource | Read files, directories, URLs | | <code>hanzo_write</code> | file, create, append | Write and create files | | <code>hanzo_edit</code> | replace, insert, delete | Edit file contents | | <code>hanzo_exec</code> | shell, script, process | Execute commands | | <code>hanzo_search</code> | grep, glob, find | Search files and content | | <code>hanzo_fetch</code> | http, graphql, websocket | Network requests | | <code>hanzo_think</code> | reason, plan, decide | Structured reasoning | | <code>hanzo_browser</code> | navigate, click, type | Browser automation (optional) | | <code>hanzo_memory</code> | store, recall, forget | Persistent memory (optional) | | <code>hanzo_code</code> | analyze, refactor, test | Code intelligence (optional) | | <code>hanzo_git</code> | status, diff, commit | Git operations (optional) | | <code>hanzo_agent</code> | spawn, coordinate, delegate | Multi-agent (optional) | | <code>hanzo_computer</code> | screenshot, click, type | Computer use (optional) |</p>
<h2>MCP server example</h2>
<pre><code class="lang-typescript">import { MCPServer, Tool, Resource } from &#x27;@hanzo/mcp&#x27;
const inferTool: Tool = {
name: &#x27;hanzo_infer&#x27;,
description: &#x27;Run inference on Hanzo LLM Gateway&#x27;,
parameters: {
model: { type: &#x27;string&#x27;, required: true },
prompt: { type: &#x27;string&#x27;, required: true },
temperature: { type: &#x27;number&#x27;, default: 0.7 }
},
async execute({ model, prompt, temperature }) {
const response = await fetch(&#x27;https://api.hanzo.ai/v1/chat/completions&#x27;, {
method: &#x27;POST&#x27;,
headers: {
&#x27;Authorization&#x27;: `Bearer ${process.env.HANZO_API_KEY}`,
&#x27;Content-Type&#x27;: &#x27;application/json&#x27;
},
body: JSON.stringify({
model,
messages: [{ role: &#x27;user&#x27;, content: prompt }],
temperature
})
})
return await response.json()
}
}
const server = new MCPServer({
name: &#x27;hanzo-node-mcp&#x27;,
version: &#x27;1.0.0&#x27;,
tools: [inferTool]
})
await server.listen(8081)</code></pre>
<h2>MCP client example</h2>
<pre><code class="lang-typescript">import { MCPClient } from &#x27;@hanzo/mcp&#x27;
const client = new MCPClient({
servers: [
{ name: &#x27;hanzo-node&#x27;, url: &#x27;http://localhost:8081&#x27; },
{ name: &#x27;hanzo-db&#x27;, url: &#x27;http://localhost:8082&#x27; }
]
})
await client.connect()
// Discover tools
const tools = await client.listTools()
// Call a tool
const result = await client.callTool(&#x27;hanzo_infer&#x27;, {
model: &#x27;zen-70b&#x27;,
prompt: &#x27;Explain Rust ownership&#x27;
})</code></pre>
<h2>ZAP-MCP bridge</h2>
<p>Any ZAP service automatically gets MCP tools. The ZAP Gateway (<code>zapd</code>) translates:</p>
<p>| ZAP | MCP | |-----|-----| | ZAP tools | <code>listTools</code>, <code>callTool</code> | | ZAP resources | <code>listResources</code>, <code>readResource</code> | | ZAP prompts | <code>listPrompts</code>, <code>getPrompt</code> |</p>
<p>This means PostgreSQL, Redis, ClickHouse, and MongoDB all get MCP tools when running with a ZAP sidecar.</p>
<h2>Optional dependencies</h2>
<p>| Package | Purpose | |---------|---------| | <code>@lancedb/lancedb</code> | Vector storage for memory tools | | <code>@xenova/transformers</code> | Local embeddings | | <code>playwright</code> | Browser automation tools |</p>
<h2>Integration with Claude Desktop</h2>
<pre><code class="lang-bash"># Auto-configure for Claude Desktop
hanzo-mcp install-desktop
# This adds to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
&quot;mcpServers&quot;: {
&quot;hanzo&quot;: {
&quot;command&quot;: &quot;hanzo-mcp&quot;,
&quot;args&quot;: [&quot;serve&quot;]
}
}
}</code></pre>
<h2>Production deployment</h2>
<pre><code class="lang-yaml">apiVersion: apps/v1
kind: Deployment
metadata:
name: hanzo-mcp
namespace: hanzo
spec:
replicas: 3
template:
spec:
containers:
- name: mcp-server
image: ghcr.io/hanzoai/mcp:latest
ports:
- containerPort: 8081
env:
- name: HANZO_API_KEY
valueFrom:
secretKeyRef:
name: mcp-secrets
key: HANZO_API_KEY</code></pre>
<h2>Security</h2>
<pre><code class="lang-typescript">const server = new MCPServer({
name: &#x27;hanzo-node&#x27;,
auth: {
type: &#x27;bearer&#x27;,
validate: async (token) =&gt; {
return await validateJWT(token)
}
},
rateLimits: {
&#x27;hanzo_infer&#x27;: { windowMs: 60000, max: 10 }
},
tools: [...]
})</code></pre>
<h2>Related Skills</h2>
<ul><li><code>hanzo/hanzo-zap.md</code> -- ZAP protocol (provides MCP for free)</li><li><code>hanzo/hanzo-agent.md</code> -- Multi-agent SDK</li><li><code>hanzo/hanzo-dev.md</code> -- Terminal AI agent using MCP</li><li><code>hanzo/hanzo-bot.md</code> -- Bot extensions expose MCP tools</li></ul>
<hr>
<p><strong>Last Updated</strong>: 2026-03-23 <strong>Category</strong>: Hanzo Ecosystem <strong>Related</strong>: mcp, agentic, tools, protocol, zap <strong>Prerequisites</strong>: TypeScript, async/await, AI agent concepts</p>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/hanzo-mcp.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>