zkzkMCP
Getting started

Overview

Run zkMCP locally and understand the pieces involved in a protected MCP call.

zkMCP is currently a monorepo prototype rather than a published npm package. The fastest way to evaluate it is to run the repository directly.

Prerequisites

  • Node.js 22+
  • Docker Desktop with Docker Compose
  • Compact compiler 0.31.1
  • macOS or Linux

Repository packages

@zkmcp/core      typed errors and privacy-safe observability
@zkmcp/midnight  Midnight wallet, Compact contract connection, proving
@zkmcp/gateway   MCP proxy and authorization boundary
@zkmcp/web       Fumadocs documentation and playground

The packages are workspace-local today. They are intentionally documented by their future package boundaries, but they are not published to npm yet.

  1. Install the repository.
  2. Run the local stack.
  3. Read Your first protected tool.
  4. Open the Playground.

Introduction

zkMCP is a zero-knowledge authorization gateway that proves an AI agent has authority for an MCP tool action before the tool executes.

Quickstart

Start Midnight, run the real MCP gateway, and open the documentation playground.

On this page

PrerequisitesRepository packagesRecommended path