zephex
⌘K
Get StartedPricingMCP ToolsDocs
←Back×Sign in
Get StartedPricingMCP ToolsDocs

Documentation

Start with the endpoint and API key flow, then branch into editor setup or tool reference.

GET STARTED

What is MCP?IntroductionQuickstartAPI ReferenceUniversal RequirementsZephex vs Local MCPBest PracticesToken EfficiencyCLAUDE.md TemplateAGENTS.md TemplateMCP EcosystemMarkdown Access

EDITORS

OpenCodeOAuthVS CodeClaude CodeCursorWindsurfJetBrainsKiro CLIOAuthZedOAuthGemini CLIOAuthClineOAuthGooseCodex CLIOAuthFactory AIOAuth

OPERATING SYSTEMS

macOSWindowsLinux

TOOLS

get_project_contextread_codefind_codecheck_packageaudit_packageexplain_architectureZephex_dev_infoscope_taskaudit_headersthinking

SUPPORT

PlansPro & Max GuideUsage & AnalyticsConnection IssuesRate LimitsBillingSecurityFAQChangelog
DOCS

One clean place for endpoint setup, API keys, and first hosted MCP requests

This documentation walks through the core concepts and the minimal flow from your first API key to a working tools/list call from any MCP-compatible editor.

Open API keys
API KEYS

Generate keys from the dashboard

API keys are your authentication token. Create as many as you need. Rotate or revoke individually from the dashboard. Each key inherits the rate limits from its assigned plan.

01

Create a key

Generate one API key per environment and keep the endpoint fixed.

02

Paste one config

Point your editor at /mcp and send the same Bearer header everywhere.

03

Verify the tool list

Start with tools/list so transport and auth are confirmed before you debug prompts.

ENVIRONMENT

Use separate keys per environment

Keep distinct keys for local development, staging, and production. This lets you rotate or revoke a single environment without disrupting the others.

API KEY

Authenticate once, then reuse the same flow everywhere

Generate a single bearer token from your dashboard. It works across every editor, environment, and tool. No per-tool credentials are needed.

mcp_prod_••••-••••.••••••••••••••••••
GUARDRAILS

Keep environments clean, keys rotatable

Use a different key for local, staging, and production. Rotate exposed keys immediately from the dashboard without touching editor configs.

.env.local
# local developmentZEPHEX_API_KEY="mcp_dev_local-01.your-secret" # stagingZEPHEX_API_KEY="mcp_staging_web-01.your-secret" # productionZEPHEX_API_KEY="mcp_prod_api-01.your-secret"
ENDPOINT

Your hosted MCP gateway URL

Every request goes to this URL. Use it as the MCP server URL in your editor config. The same endpoint works for all editors.

MCP Server URL
https://zephex.dev/mcp
FIRST REQUEST

Start with one authenticated tools/list call

The first successful request confirms the only moving parts that matter: the endpoint, the Bearer header, and a working JSON-RPC body.

verify-zephex.sh
curl -X POST https://zephex.dev/mcp \  -H "Authorization: Bearer YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
WHAT ZEPHEX GIVES YOU

One endpoint, every editor

The same https://zephex.dev/mcp URL works in VS Code, Claude Code, Cursor, Windsurf, and JetBrains. Configure it once. No per-editor server fleet, no local processes, and no bridge packages just to reach the same tool surface.

API key as your credential

One Bearer token authenticates every tool call. Create, rotate, and revoke keys from the dashboard. Use separate keys for local, staging, and production so one exposed key never takes down your whole setup.

10 tools, ready immediately

Project context, code reading, architecture tracing, package intelligence, URL inspection, security auditing, scoped task planning, and structured reasoning are available as soon as your key is active.

Usage is tracked, not guessed

Every request counts against your plan. Free includes 300 requests per month, Pro includes 3,500, and Max includes 10,000. You can see exact usage in real time from the dashboard instead of guessing at month end.

WHY NOT JUST RUN MCP LOCALLY?

RUNNING MCP LOCALLY

Each editor needs its own server config. You manage npx commands or local processes per machine, per repo, and per editor. API keys scatter across config files, and you do not get a clean usage view unless you build one yourself.

USING ZEPHEX

One config per editor, one key per environment, one dashboard for all of it. The tool surface stays the same whether you are in Cursor on your laptop, VS Code on a remote machine, or Windsurf in a Codespace.

EDITOR GUIDES

Every editor uses the same endpoint and the same auth model. What changes is where the config lives and what kind of restart is required before the tool list refreshes.

OpenCode~/.config/opencode/opencode.json→VS Code.vscode/mcp.json→Claude Code~/.claude.json→Cursor.cursor/mcp.json→Windsurfmcp_config.json→JetBrainsAI Assistant MCP→Kiro CLI~/.kiro/settings/mcp.json→Zed~/.config/zed/settings.json→Gemini CLI~/.gemini/settings.json→Clinecline_mcp_settings.json→Goose~/.config/goose/config.yaml→Codex CLI~/.codex/config.toml→Factory AI.factory/mcp.json→
OPERATING SYSTEM GUIDES

If you care more about the machine you are on than the editor you are using, start here. These pages map home-directory paths, project-root file locations, and verification commands for macOS, Windows, and Linux.

macOSFinder, Terminal, ~/ paths→WindowsPowerShell, %USERPROFILE%→LinuxShell, ~/.config, dotfiles→
NEXT STEPS

Quickstart

The shortest path from new API key to first successful tools/list call.

→

Editor Guides

Pick your editor and paste the exact config in the right location.

→

Tool Reference

See all 10 tools, what they do, and how to combine them in real sessions.

→
UNIVERSAL CONFIG

Every editor that supports native HTTP MCP servers accepts this config structure. Copy the snippet into the editor-specific config location, update the header with your API key, and restart the editor session.

mcp-config.json
{  "mcpServers": {    "zephex": {      "command": "npx",      "args": ["-y", "zephex"],      "env": {        "ZEPHEX_API_KEY": "YOUR_API_KEY"      }    }  }}