mcpfold
About
Connect every MCP server without paying the context-window tax.
Details
- Author
- dj-pearson
- Categories
- Developer Tools
Jump to
Setup
Install mcpfold in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/dj-pearson/MCPFold
Follow the installation instructions in the repository README, then restart your MCP client.
Connect every MCP server without paying the context-window tax.
One canonical config, folded out to every client — loading only the tools each agent needs, and resolving secretreferencesinstead of hardcoding values.
Demo regenerated from the real CLI withpnpm demo:record(anasciinema cast+ this SVG; a GIF renders in CI viademo/mcpfold.tape). Server names shown are examples — no endorsement implied.
v1.0.0 is live.The local-first CLI + core are stable andfree forever, MIT-licensed— install below. The optional hosted cloud (accounts, config sync, teams) is self-hostable. Full docs live indocs/; the story-by-story build history is inprd.json.
Every MCP server you connect dumps its full tool schema into your agent's context window on every turn — used or not.mcpfold's local proxy curates the toolset per client. In areproducible benchmark— github (20 tools), supabase (15), playwright (10),45 toolstotal — curating down to the9actually needed cuts tool-schema tokens by~80%(7,476 → 1,497), with no extra config because the shim already in the launch path does the filtering.
MCP config sprawls across clients (Claude Code, Cursor, VS Code, Windsurf, Zed, …), and the formats have quietly diverged: VS Code uses the root keyservers, Zed usescontext_servers, everyone else usesmcpServers. Secrets get hardcoded into plaintext JSON.mcpfoldkeeps one canonical file and folds it out to each client — resolving secretreferences(never values) and curating which servers and tools each client loads.
- One source of truth— a commentedmcp.config.jsonc, version-safe and editor-validated.
- Secret-safe— configs carry${scheme:path}references; resolved values never touch disk.
- Fewer tokens— per-client, per-agent tool curation via a local proxy.
- Portable— deterministic, byte-stable output for every client format.
Every channel resolves to thesame versionfor a given release (a CI check enforces parity), so mix them across machines. Full details indocs/install.md.
npm / npx— no install needed to try it:
npx mcpfold init npm install -g mcpfold # or: pnpm add -g mcpfold (installs mcpfold + the mcpf alias)
scoop bucket add mcpfold https://github.com/dj-pearson/scoop-bucket scoop install mcpfold
curl | sh(macOS / Linux) — standalone binary, no Node, checksum-verified:
curl -fsSL https://mcpfold.com/install.sh | sh
Standalone binary— download for your platform from thelatest release(macOS arm64/x64, Linux x64/arm64, Windows x64), verify the.sha256, and put it on yourPATH.
RequiresNode 20+(for the npm/npx install; the binaries need nothing).mcpfoldauto-detects whichever MCP clients you have installed.
mcpfold init # 1. scaffold a commented mcp.config.jsonc (+ $schema for editor autocomplete) mcpfold import # 2. scan installed clients and merge their servers into the canonical file mcpfold sync # 3. fold the canonical config out to every detected client (native formats) mcpfold diff # preview what sync would change, per client, before applying mcpfold doctor # health-check config, clients, and secret references
Other commands:secret(manage secret references),run(launch the curating proxy),status,add. See the fullQuickstartandcommand reference.
The savings above come fromcuration— exposing only the tools an agent actually uses.curatewrites an allow-list;syncfolds each curated server out as amcpfold runproxy shim, so clients only ever load the trimmed toolset:
mcpfold add fs --package @modelcontextprotocol/server-filesystem # add a server mcpfold curate fs --tools read_text_file,write_file,list_directory # keep only what you use # → fs: keeping 3 of 14 tools, ~3.2k → ~684 tokens (approx) mcpfold sync # fold it out (writes a proxy shim)
Already been running your servers? Plainmcpfold curatereads the local audit trail and recommends the allow-list from youractualtool usage. Check the measured savings on your own config anytime withmcpfold status.
18 clients, each read and written in its own native format from a single source of truth:
Claude Code · Claude Desktop · Cursor · VS Code · Visual Studio · Windsurf · Zed · Cline · Continue · Roo Code · Gemini CLI · Codex CLI · Copilot CLI · JetBrains · Goose · LM Studio · Warp · opencode
mcpfold initadds a$schemaline so editors give you autocomplete + inline validation:
{ "$schema": "https://mcpfold.com/schema/v1.json", "version": 1, // … }
The schema is generated from the zod source (packages/schema); a CI check fails if the committedmcp.config.schema.jsondrifts — regenerate withpnpm --filter @mcpfold/schema generate.
Core purityis enforced:packages/coremay not importnode:fs,node:os,node:path, or any network/process library. All I/O is injected throughClientAdapter/SecretProvider. Guarded by an ESLintno-restricted-importsrule and thescripts/check-core-purity.mjsCI gate.
Secretvaluesnever touch disk or logs — only references (${scheme:path}) are stored, and values are resolved in memory at launch. Every security property is paired with the test or CI job that proves it in theSecurity postureledger (CI-guarded so a claim can't outlive its evidence); the narrativeSecurityandThreat modelpages cover the surfaces and honest boundaries.
RequiresNode 20+andpnpm 10+(corepack enable).
pnpm install # install workspace deps pnpm lint # eslint + core-purity check pnpm typecheck # tsc --noEmit across packages pnpm test # vitest (unit + fixture snapshots) pnpm -r build # build every package pnpm verify_all # lint + typecheck + test + build (the full gate)
CI runsverify_allon a Windows/macOS/Linux × Node 20 matrix — path resolution is central to this product, so the cross-OS matrix is non-negotiable. New client adapters, secret providers, anddoctorchecks are especially welcome — seeCONTRIBUTING.md.
The CLI and everything local arefree forever and MIT-licensed; the hosted cloud is the paid surface (and you can self-host it yourself for free). See thepricing model, the publicroadmap, and how the project is run ingovernance.
If mcpfold saves you time, you can help fund ongoing work:
- Recurring—GitHub SponsorsorOpen Collective
- One-time—donate via Stripe
Sponsorships fund the free, open-source core. Thank you 🙏
MIT forpackages/*core + CLI. The cloud layer (apps/web,services/edge) is commercial/closed. Seeprd.jsonmeta.license.
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Create crafted UI components inspired by the best 21st.dev design engineers.
Bring agent evaluations, observability, and synthetic test set generation directly into your IDE for free with Galileo's new MCP server
An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively .
MCP server for AI Diagram Maker — generate beautiful software engineering diagrams directly inside Cursor, Claude Desktop, Claude Code, or any MCP-compatible AI agent
ALAPI MCP Tools,Call hundreds of API interfaces via MCP
AI-powered SVG animation generator that transforms static files into animated SVG components using the Allyson platform
MCP server that gives AI assistants on-demand access to 1,500+ amCharts docs, ~300 code examples, and 1000+ class API references.
APIMatic MCP Server is used to validate OpenAPI specifications using APIMatic. The server processes OpenAPI files and returns validation summaries by leveraging APIMatic’s API.
One shared context layer for AI agents and humans — live API specs, DB schemas, and versioned contracts across repos so every agent and teammate works from the same source of truth.
Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





