FAQ
Frequently asked questions
Short, citeable answers about what MCPZERO is, how semantic aggregation and progressive discovery work, and how to get started. Full guides live in the documentation.
What is MCPZERO?+
MCPZERO is a secure MCP aggregation gateway. It turns local MCP servers into remote HTTPS endpoints that AI clients like Cursor can call, with semantic aggregation, progressive discovery, zero-trust API key auth, and an audit ledger.
How is MCPZERO different from connecting MCP servers directly?+
Direct MCP connections expose every tool schema upfront and often keep credentials on the client machine. MCPZERO tunnels local servers through a zero-trust edge gateway, aggregates many servers behind one URL, and lets agents discover tools on demand via meta_search instead of loading the full catalog.
What is semantic aggregation?+
Semantic aggregation multiplexes one or more backend MCP servers behind a single endpoint root URL. Clients talk to the meta server (meta_search and meta_call_tool) rather than enumerating every upstream tool at connect time.
What is progressive discovery?+
Progressive discovery means AI clients discover tools on demand. At the endpoint root, tools/list returns only meta_search and meta_call_tool; agents search by intent, then call the matched tool. Server Skill-style profiles are exposed as MCP resources for context before searching.
Do I need to change my existing mcp.json?+
Usually no. The mcpzero CLI reads your existing MCP config, starts a tunnel to your endpoint, and keeps upstream credentials on your machine. Point Cursor or other clients at the gateway URL with an API key.
How does authentication work?+
Clients authenticate with Authorization: Bearer <mz_live_api_key>. API keys are created in the Dashboard. Upstream MCP credentials never leave your machine; the gateway never stores them.
What is an endpoint cluster?+
An endpoint cluster (epc_*) is a Team+ virtual meta server that aggregates multiple endpoints for cross-endpoint semantic search and progressive discovery from one URL.
Is there a free plan?+
Yes. The Free plan includes one multiplexed tunnel, up to 5 servers and 50 tools total, semantic aggregation and progressive discovery, 48-hour cloud payload storage, and traffic visualization. Paid plans add more tunnels, retention, team sharing, and endpoint clusters.
Where do I find documentation?+
Product docs live at https://mcpzero.io/docs/. Start with Getting Started, then CLI install and gateway concepts (semantic aggregation, progressive discovery, security).
How do I install the CLI?+
On macOS or Linux run: curl -fsSL https://mcpzero.io/install-cli.sh | sh. Then mcpzero login and mcpzero init. Homebrew and npm installs are also available — see https://mcpzero.io/docs/cli/install/.
Can teams share MCP endpoints?+
Yes on Team+. Members call shared endpoints with their own API keys. Tool permissions and audit logs keep access governed. See team sharing docs for details.
Does MCPZERO store tool call payloads?+
The gateway always records tool name, latency, and status. Cloud payload retention depends on plan: Free 48 hours, Personal 7 days, Team 30 days, Enterprise private BYO storage.