toolc

English | Русский

Compile noisy OpenAPI and MCP tool surfaces into one smaller governed runtime surface for LLM agents.

Validated today with real OpenRouter model runs, real saved benchmark artifacts, and a live OpenAPI invoke check.

Best fit today:

• VS Code users with too many MCP servers
• OpenAPI or MCP-heavy agent stacks
• teams that want less exposed tool surface without a platform rewrite

Install

Two supported paths for v1.0.0:

1. download a prebuilt archive from GitHub Releases
2. install from source with Go

go install github.com/aak204/Tool-Catalog-Compiler/cmd/[email protected]

After the v1.0.0 tag is published as the latest tag, this also works:

go install github.com/aak204/Tool-Catalog-Compiler/cmd/toolc@latest

Release assets for v1.0.0:

• toolc_v1.0.0_windows_amd64.zip
• toolc_v1.0.0_linux_amd64.tar.gz
• toolc_v1.0.0_linux_arm64.tar.gz
• toolc_v1.0.0_darwin_amd64.tar.gz
• toolc_v1.0.0_darwin_arm64.tar.gz
• SHA256SUMS.txt

VS Code Quickstart

If you already use MCP in VS Code, start here.

toolc can take the MCP config you already use, compile it into one smaller controlled surface, and become the single MCP server your agent sees.

Start here:

1. build toolc
2. optimize your existing MCP config
3. point your extension at the emitted config
4. run one toolc mcp-serve surface instead of many raw servers

Build once:

PowerShell

./scripts/build.ps1

bash

./scripts/build.sh

Common input config paths:

• VS Code / Codex-style MCP config: .vscode/mcp.json
• Roo Code project config: .roo/mcp.json
• Roo Code global config: mcp_settings.json
• Cline config: cline_mcp_settings.json
• Kilo config: kilo.jsonc or .kilocode/mcp.json

Optimize an existing MCP config:

PowerShell

./dist/toolc.exe optimize-mcp `
  -input .vscode/mcp.json `
  -emit vscode `
  -out-dir dist/mcp-optimized

bash

./dist/toolc optimize-mcp \
  -input .vscode/mcp.json \
  -emit vscode \
  -out-dir dist/mcp-optimized

What you get:

• dist/mcp-optimized/toolc.compiled.json
• dist/mcp-optimized/optimized.json
• dist/mcp-optimized/optimization-report.json

Use it:

• point your extension at dist/mcp-optimized/optimized.json
• the emitted config starts toolc mcp-serve for you