Install

Recommended - via Yaw Terminal
Run yaw mcp inside Yaw Terminal
npm install -g @yawlabs/mcp
yaw mcp install claude-code
yaw mcp doctor
Yaw Terminal includes the yaw mcp command, which forwards to the yaw-mcp CLI on PATH. One-time npm install -g @yawlabs/mcp wires it up. Future Terminal builds will bundle the CLI directly so the npm step disappears.
Standalone - CLI only
If you do not have or want Yaw Terminal
npm install -g @yawlabs/mcp
yaw-mcp install claude-code
yaw-mcp doctor
Pulls just the CLI from npm. ~5MB. Node 18+ required. Works with Claude Code, Claude Desktop, Cursor, VS Code, and any other client that speaks the MCP stdio protocol.

What it does

Local-first. Run MCP servers from a JSON file you control. No account required for Free. Nothing leaves your machine - no telemetry, no analytics, no opt-in pings. Bring your own API keys; they stay in ~/.yaw-mcp/bundles.json on your disk.
One CLI, every MCP server. Discover, install, and run servers from the public catalog or your own JSON. Token-budget aware - yaw mcp dispatch ranks your servers against the current task and loads only what is needed instead of keeping every tool description in your AI client's context window.
Compliance-graded. Every catalog entry is scored against the 88-test mcp-compliance suite. Set YAW_MCP_MIN_COMPLIANCE=B and the CLI refuses to activate anything below the bar. The grade renders inline on every discover output - the trust signal is visible without opting in first.
Sync with Pro. Add a license key and yaw mcp sync push uploads your server schema (env values stripped) to a private store. yaw mcp sync pull mirrors it onto another machine. Set up once, use everywhere.
Team-shared with Yaw Business. Same Yaw Business license that unlocks Yaw Terminal's shared connections + commands + runbooks ALSO unlocks Yaw MCP's shared bundles + audit log. One license key, both products. New teammates get the company-canonical MCP server set on their first yaw mcp sync pull.
BYOK across AI clients. Works with Claude Code, Claude Desktop, Cursor, VS Code, and anything else that launches MCP servers over stdio. yaw mcp install <client> wires up the launch entry in the correct config file for the OS - no hand-editing JSON.

Pricing

Pick what you need. Pro and Yaw Business unlock the same underlying CLI - Free is not a degraded version, it is the same product without cloud sync.

Free
$0
forever
  • Unlimited servers via ~/.yaw-mcp/bundles.json
  • Full public catalog + compliance grades
  • All meta-tools (discover / dispatch / activate)
  • Local secrets only - nothing leaves the machine
  • Bundled with Yaw Terminal
Install
Yaw Business
$10/seat/mo
or $99/seat/year - same license also unlocks Yaw Terminal Business
  • Everything in Pro, per seat
  • Shared team bundles (admin curates, members pull)
  • Org-level secret management (Phase 6b)
  • Per-seat audit log: who called which tool when
  • SSO
  • Same license unlocks Yaw Terminal Business features (shared connections, commands, runbooks)
Buy seats

Frequently asked

Do I need an account to use Yaw MCP?

No. Free runs entirely from a JSON file on your machine. The CLI never phones home in Free mode - no telemetry, no opt-in pings, no account check on startup. You only need a license key if you want to sync bundles across machines (Pro) or share them with a team (Yaw Business).

What is the relationship to mcp.hosting?

Yaw MCP is the rebrand of what previously shipped as mcp.hosting and the @yawlabs/mcph CLI. The old hosted SaaS is being sunset; the local-first CLI is the new product. Existing mcp.hosting URLs redirect to yaw.sh/mcp; the old @yawlabs/mcph package is deprecated and points at @yawlabs/mcp.

What is in a "bundle"?

A bundle is the set of MCP servers Yaw MCP will load on startup. Each server entry has the standard MCP shape - a namespace, a command, args, env vars, and either a transport or a URL. The local file is ~/.yaw-mcp/bundles.json (user-global) or <project>/.yaw-mcp/bundles.json (project-local, overrides user-global). The CLI's install meta-tool edits this file for you.

How does sync handle my API keys?

Phase 6a (shipping now): the sync push command strips env VALUES before upload - only the schema (which env vars each server expects) goes to the server. Your secrets stay on each machine. Phase 6b will add an encrypted vault (mcp_secrets) where you can opt in to syncing the values too, encrypted with a passphrase you control. The server never sees the plaintext either way.

Does Yaw MCP work with Claude Code, Cursor, etc.?

Yes. Yaw MCP is itself an MCP server that launches over stdio. yaw mcp install <client> writes the correct launch entry into the client's config file (correct path for your OS, correct JSON shape). Supported clients: Claude Code, Claude Desktop, Cursor, VS Code. Any client that speaks the MCP stdio protocol will work even if not in that list.

Why bundle Yaw Business across Terminal + MCP?

The architecture supports it for free - both products share the same Netlify Functions backend, the same license key format, and the same HMAC session cookie. The team-shared resources (connections / commands / runbooks for Terminal; bundles / secrets / audit log for MCP) are conceptually the same thing: team-shared dev tooling state. One license key, two product surfaces, simpler pricing.

What about self-hosting?

Yaw MCP IS self-hosted by default. The Free tier runs entirely on your machine with no backend dependency. The only thing the Pro / Yaw Business backend does is sync - and that backend (Netlify Functions on yaw.sh) has no per-customer footprint, just shared blob storage keyed by license-order-id. There is no "deploy your own Yaw MCP backend" product because the sync layer is intentionally a hosted-only convenience, not a system you'd want to run yourself for one team.