zephex
CLIGet StartedPricingMCP ToolsCommunityGuidesDocs
←BackSign in
CLIGet StartedPricingMCP ToolsCommunityGuidesDocs
Get started freeSign in
DocsAPIToolsEditorsChangelogHelp

GET STARTED

WelcomeQuickstartSetup videoMCP Q&A (learn)BlogWhat is MCP?Who is Zephex for?Plans & PricingZ-GASAB benchmarkBenchmark chart (live)Changelog

INSTALLATION

Web Terminal tools (plain English)Terminal tools (complete)Connect MCPVS Code Marketplace extensionCLI (no AI agent)CLI init (first run)CLI account & logoutNPX (Recommended)Test Pulse (check test)Test Pulse commandsProject MemorySupply Pulse (supply)Supply Pulse commandsTerminal CLI referenceSlash commands (37 palette)Web Terminal (dashboard)Command CompassCLI commandsCLI in DockerCLI: All editors (one command)CLI: Crush, Hermes, ChatGPT, KiloOAuth & HTTP setupInstall overviewHTTP APISetup WalkthroughHTTP vs stdio

API & KEYS

API Key ManagementKey Naming & FormatAuthenticationKey Dashboard

CONFIGURATION

Universal RequirementsSupported EditorsHow It WorksArchitectureCLAUDE.md TemplateAGENTS.md Template

EDITORS28 guides

Supported EditorsVS CodeVS Code extension (Marketplace)Claude CodeCursorWindsurfJetBrains

PLATFORM

macOSWindowsLinux

TOOLS10 tools

Capabilities OverviewTools OverviewTool FilteringTool Workflowsget_project_contextread_codefind_codecheck_packageexplain_architectureZephex_dev_infocheck_testaudit_headerskeep_thinkingproject_memory

GUIDES

Best PracticesToken EfficiencyUse CasesZephex vs Local MCPZephex vs Context7Zephex vs GitHub MCPZephex vs SmitheryMCP EcosystemMarkdown Access

SUPPORT

Help CenterMCP troubleshootingTeam rolloutFAQConnection IssuesRate LimitsDowntime & ErrorsBillingTier GuidePro & Max guideUsage LimitsUsage Analytics

LEGAL

System StatusTerms (summary)Privacy (summary)Data UseSecurityAuthenticationSecurityData HandlingPrivacy PolicyTerms of Service

Quick Links

API Reference

Complete API documentation

Troubleshooting

Common issues and solutions

Community

Join our Discord community

Plugins

Editor and CLI integrations

Pricing

Free, Pro, and Max plans

Enter
Zephex_devzephex-devzephexzephexhello@zephex.dev
© 2026 Zephex. All systems operational.

Support

FAQ

The fastest answers to setup, billing, security, and tool questions — grouped so you can scan by topic.

Plans: Free (555 req/mo), Pro (3,500 req/mo), Max (10,000 req/mo). Endpoint: https://zephex.dev/mcp · 10 tools. Not sure if Zephex matches your workflow? Start with who Zephex is for.

QUESTIONS BY TOPIC

Setup

Do I need to install anything locally to use Zephex?

For editor Mode 1, setup writes MCP config — often via `npx -y zephex@latest setup --cursor` (stdio bridge uses npx). For terminal Mode 2, install once with `npm install -g zephex` then `mcpcli init`. Web terminal needs only a browser login at /dashboard/terminal (public GitHub repos).

Which editors do you support?

Cursor, Claude Code, VS Code, Windsurf, JetBrains, and 20+ MCP-compatible clients. See /docs/supported-editors and /docs/connect-mcp for flags like --cursor, --vscode, --claude-code.

How long does setup take?

Most users connect in under 5 minutes — browser OAuth via mcpcli setup, config write, restart editor once. Terminal-only: mcpcli init then overview in a project folder.

What is Mode 1 vs Mode 2?

Mode 1 is editor MCP (agent gets lean JSON). Mode 2 is the terminal CLI (you get plain-English answer cards). Same API key and https://zephex.dev/mcp. Multi-turn keep_thinking sessions are editor-only; terminal think is one-shot. See /docs/how-it-works.

Why did `structure` open architecture instead of my folder tree?

CLI dispatch policy: bare `structure` maps to architecture. For layout topics use `get-context --topic structure`. Same idea for bare `env` (env-check) vs `get-context --topic env`. See /docs/cli-commands and docs/cli-dispatch-policy.md in the repo.

Can I use the VS Code Marketplace extension instead of manual MCP JSON?

Yes. Install Zephex from the VS Code Marketplace (works in VS Code, Cursor, and Windsurf), run Zephex: Sign In from the Command Palette, then enable Zephex MCP in agent mode. The extension handles OAuth and key storage — or run npx -y zephex@latest setup --vscode for stdio config. See /docs/editors/vscode-extension.

What is the Zephex web terminal?

The web terminal at /dashboard/terminal runs Mode 2 mcpcli tools in your browser — paste a public GitHub repo URL and run overview, get-context, find-code, supply scans, and more without npm install. It uses a web-terminal-* API key and shares your plan quota. Private repos are not cloned server-side. See /docs/web-terminal.

How do I roll Zephex out to my team?

Use one hosted endpoint (https://zephex.dev/mcp) with separate API keys per developer and per environment (dev/staging/prod). Do not commit keys to git. Standardize on npx -y zephex@latest setup globally, document editor restart requirements, and use dashboard usage analytics for quota visibility. Full checklist: /docs/team-rollout.

Can I use Zephex with my private GitHub repository?

Yes for local Mode 2 and stdio editor setups: tools use files on disk via inline_files / local path — the repo does not need to be public. The dashboard web terminal only clones public GitHub URLs. Hosted remote github:owner/repo paths need server-side GitHub access for private repos.

How is a hosted/remote MCP server different from running local stdio MCP servers?

Local stdio servers run on your machine and are fast/private but create N×M config drift across editors, machines, and teammates. A hosted MCP gateway (remote HTTP) like Zephex gives every editor and every teammate the same 10 tools through one key and one endpoint. You get central usage analytics, key rotation, and production-grade tools (package CVE scanning, header audits, stateful keep_thinking) without shipping heavy scanners to every laptop. The tradeoff is one network hop and the rate limits of your plan.

What is the difference between Zephex and running MCP servers locally?

Running MCP servers locally means managing Node processes, updating packages, and configuring each client separately. Zephex hosts the proxy for you — same endpoint, same access controls, no local infrastructure.

Billing

Do editor and terminal share the same quota?

Yes. Mode 1 MCP tool calls and Mode 2 mcpcli hosted tools bill against the same account plan (Free/Pro/Max). Local-only commands (help, learn, compass) do not. Check with mcpcli usage or the dashboard. See /docs/usage-limits.

What are the exact rate limits and what happens on 429?

Free: 555 requests/month. Pro: 3,500 ($7/mo). Max: 10,000 ($19/mo). When you exceed your quota you receive HTTP 429 with a Retry-After header — share your link for +300 bonus requests or upgrade. Limits reset at the start of the next calendar month.

How does billing work?

Free tier: 555 requests/mo. Pro ($7/mo): 3,500 requests. Max ($19/mo): 10,000 requests. Share your link for +300 bonus requests when someone clicks it.

What if I hit the rate limit?

Upgrade to a higher tier, wait for the monthly reset, or check npx -y zephex@latest usage. Rate limits are per API key and displayed in the dashboard. See /docs/plans for tier comparison.

Can I get a refund?

Contact support within 14 days of payment for a refund on Pro or Max tiers. Free tier has no charges.

Do you offer enterprise pricing?

Yes. Contact support for custom tiers, SLAs, dedicated infrastructure, and custom integrations.

Security

Is my code sent to Zephex or stored?

Code is processed ephemerally for the duration of the tool call only. Zephex does not train on customer code and does not retain source beyond what is required to answer the current request. See /docs/data-handling and /docs/support/security.

Do you train on my code or prompts?

No. Zephex does not use customer prompts, tool inputs, tool outputs, or code for model training. See the Data Use page for the full policy.

What happens if my API key gets exposed?

Revoke it immediately from the dashboard and create a new one. Keys are shown once at creation — if you miss copying it, rotate to a fresh key. Then run npx -y zephex@latest reconnect --cursor (or your editor flag) to rewrite config.

How do I rotate an API key without downtime?

Create a new key in Dashboard → API Keys, update your editor config (stdio env ZEPHEX_API_KEY or HTTP Bearer header), fully restart the editor, verify 10 tools appear, then revoke the old key. See /docs/api-keys for the full rotation sequence.

Can I use different keys for different environments?

Yes. Create separate keys for local, staging, and production. Each key can have different backend access and shares your plan's monthly quota.

Tools

Is audit_headers only in the editor?

No. Terminal: mcpcli check url https://example.com (aliases: site-audit, audit-headers). Multi-turn keep_thinking sessions are the main editor-only nuance; think in the terminal is one-shot. See /docs/terminal-tools-complete-guide.

What is the difference between project_memory and check_package?

check_package is the fast first screen before any install — existence, typosquat signals, deprecation, and basic CVE/freshness across 12 registries (task=check|upgrade|security). project_memory lets your agent remember and recall project decisions, gotchas, and conventions across sessions via local SQLite — so you don't have to rediscover the same patterns every time. Rule of thumb: check_package before recommending a package; project_memory when you want your agent to persist context across sessions.

How is Zephex different from Google's fully-managed remote MCP servers (BigQuery, Firebase, etc.)?

Google's managed MCP servers are excellent when your data already lives in BigQuery, Cloud Storage, or Firebase and you want IAM/OAuth + zero-ops. Zephex is the practical hosted gateway for general developer workflows across any stack: AST code reading, task scoping with risk assessment, real package migration + CVE intelligence across 12 ecosystems, HTTP header audits, and multi-step reasoning that actually persists state. It works with Cursor, Claude Code, Zed, JetBrains, Gemini CLI, and the full 19+ editor list from a single key. Use Google services for Google data; use Zephex for everything else an agent needs to understand and change real codebases.

RELATED
  • MCP troubleshooting
  • Help center
  • Plans & limits
  • Tools overview
STILL STUCK?

We can help you get connected

Share your editor name, the error message (401, 429, empty tools/list), and your API key prefix — never the full key.

Join Discordsupport@zephex.dev