CostGate

Gate, secure, and optimize your MCP.

CostGate is a Cursor-first MCP control plane: proxy your backend MCPs, cut token usage, block secrets with Shield, and manage everything from a local Dashboard.
Also compatible with Claude Desktop and other stdio MCP clients (Gate features only; hooks are Cursor-specific).

Languages: English (this file) · 日本語
Install: docs/installation.md · Gate mode: docs/gate-mode.md · Shield: docs/shield.md

What CostGate does

Capability	Summary
MCP Gateway	Single `costgate-gate` entry in front of GitHub and other MCPs
Token reduction	Optional filter mode (Tier A/B/C), compression, code-mode
Shield	Block secrets in prompts; redact MCP traffic; MCP trust policy
Dashboard	Usage, savings, MCP on/off, marketplace, per-project config
Probe	Separate measurement MCP for baseline JSONL logs (`@costgate/probe`)

Repository layout (monorepo)

costgate/
├── packages/
│   ├── schema/     @costgate/schema   — shared log schema
│   ├── probe/      @costgate/probe    — measurement MCP (npm)
│   ├── cli/        @costgate/cli      — npm entry (launcher, Dashboard, hooks)
│   └── gate/       costgate-gate      — gateway MCP (Go binary)
├── docs/
├── examples/
└── scripts/

See docs/structure.md for why Probe and Gate share one repo.

Packages

Package	Dist	Description
@costgate/cli	npm	Recommended entry — `init`, Gate launcher, Dashboard, Cursor hooks
@costgate/probe	npm	Measurement MCP — baseline token usage, call stats, JSONL logs
costgate-gate	GitHub Releases	Gateway MCP (Go) — filtered tools, Shield, cost reduction
@costgate/schema	workspace	Shared JSON Schema for logs

Quick start (production — recommended)

Install with Node only (no Go build). init downloads the Gate binary from GitHub Releases.

npx @costgate/cli@latest init
# Restart Cursor (reconnect MCP)

What init does:

~/.costgate/bin/costgate-gate — Go binary
~/.cursor/mcp.json — npx @costgate/cli gate (Dashboard auto-start)
~/.cursor/hooks.json — Shield, prompt-intent, etc.
~/.costgate/backends.json — template (if missing)

Update: npx @costgate/cli update

Details: packages/cli/README.md · docs/releases.md

Global install (optional)

npm install -g @costgate/cli
costgate init

Quick start (developers — clone repo)

git clone https://github.com/YukiMiyatake/costgate.git
cd costgate
npm install
npm run build:gate          # or ./scripts/install-gate.sh
mkdir -p ~/.costgate && cp examples/backends.github.json ~/.costgate/backends.json
npm run cursor:deps         # Dashboard SDK → ~/.costgate/node_modules (WSL/DrvFs-safe)
npm run cursor:production   # update mcp.json + seed .costgate/backends.json
npm run cursor:registry     # install hooks
# Restart Cursor MCP

cursor:production points Gate at ${workspaceFolder}/.costgate/backends.json and seeds it from examples when missing.
On WSL, repos under /mnt/c or /e can corrupt node_modules; use npm run cursor:deps so Dashboard loads SDK from Linux-native ~/.costgate.

Docker only: docs/docker.md

Quick start (Probe — measurement only)

Option A — npx (published)

npx @costgate/probe@latest

Add to Cursor ~/.cursor/mcp.json:

{
  "mcpServers": {
    "costgate-probe": {
      "command": "npx",
      "args": ["-y", "@costgate/probe"],
      "env": {
        "COSTGATE_CONFIG": "~/.costgate/backends.json",
        "COSTGATE_PROBE_LOG_DIR": "~/.costgate/logs"
      }
    }
  }
}

Option B — from source

npm install
npm run build:probe

See examples/cursor/ for measurement configuration.

Gate (advanced — binary only)

Minimal setup without Dashboard or hooks:

./scripts/install-gate.sh          # → ~/.local/bin/costgate-gate
costgate-gate --version

Example ~/.cursor/mcp.json: examples/cursor/mcp-gate-github.json

Build from repo: npm run build:gate (Go 1.25+)

Releases: GitHub Releases · docs/RELEASE.md

Filter mode (default): Tier A/B/C + discover_tools / invoke_tool. See packages/gate/README.md.

Compare reduction: npm run compare (definitions) · npm run compress-report (definitions + tool results).

Session breakdown: npm run session-report (fixed + variable + overall % scenarios).

Measured benchmarks: docs/benchmarks.md

Production Cursor setup (clone): npm run cursor:production — see examples/cursor/README.md.

Cloud metrics (opt-in): npm run cloud:upload — see costgate-cloud.

Plans (roadmap)

Plan	Scope
Free (OSS)	CostGate — Probe + Gate + Dashboard
LoopGate Starter / Pro / Enterprise	Hosted LoopOps SaaS — see costgate-cloud (private)

OSS vs Cloud feature split: docs/ecosystem/plans.md · 日本語

See docs/roadmap.md for OSS phase details.

Documentation

License

MIT — see LICENSE