# Zephex — Hosted MCP Server for AI Coding Agents

> **Exhaustive agent spec:** https://zephex.dev/llms-full.txt
> **Who Zephex is for (ICP personas):** https://zephex.dev/docs/who-is-zephex-for
> **30+ Q&A hub:** https://zephex.dev/learn/mcp-questions
>
> **Split Surface (for agents):** The marketing homepage is intentionally slim. Read this file first — not `/` HTML. ICP depth is on /docs/who-is-zephex-for; BOFU comparisons are under /compare/*; every /docs/* page has a `.md` mirror.

> Zephex is a cloud-hosted MCP (Model Context Protocol) server that gives AI
> coding agents instant access to 10 built-in developer tools through a single
> endpoint. No local server processes, no per-editor configuration drift.
> One API key authenticates everything. Works with 27 documented editors and CLI tools.

## What Zephex Does

Zephex solves the "N×M problem" for MCP: instead of configuring separate local
MCP servers for each editor, you point any MCP-compatible client at
`https://zephex.dev/mcp` with a Bearer token. The same 10 tools are available
everywhere — Cursor, Claude Code, VS Code, Windsurf, JetBrains, Kiro, Zed,
Cline, Goose, Warp, Gemini CLI, Codex CLI, Continue, Roo Code, Trae,
Factory AI, OpenCode, Copilot CLI, Kiro CLI, Claude Desktop, ChatGPT, Perplexity Desktop,
Google Antigravity, Crush, Hermes, and Kilo Code.

## Quick Start

```bash
npx zephex setup
```

Or manually: create an API key at https://zephex.dev/dashboard/api-keys, then
add this to your editor's MCP config:

```json
{
  "mcpServers": {
    "zephex": {
      "command": "npx",
      "args": ["-y", "zephex"],
      "env": { "ZEPHEX_API_KEY": "YOUR_KEY" }
    }
  }
}
```

## Supported Editors (27 documented)

- Cursor: https://zephex.dev/docs/editors/cursor — config in .cursor/mcp.json
- Claude Code: https://zephex.dev/docs/editors/claude-code — config in ~/.claude.json or `claude mcp add`
- VS Code: https://zephex.dev/docs/editors/vscode — native HTTP MCP transport with prompted API key
- Windsurf: https://zephex.dev/docs/editors/windsurf — global config in ~/.codeium/windsurf/mcp_config.json
- JetBrains (IntelliJ, WebStorm, PyCharm, GoLand): https://zephex.dev/docs/editors/jetbrains — AI Assistant settings UI
- Zed: https://zephex.dev/docs/editors/zed — context_servers in settings.json
- Cline: https://zephex.dev/docs/editors/cline — stdio MCP JSON config
- Goose: https://zephex.dev/docs/editors/goose — interactive `goose configure` extension setup
- Warp: https://zephex.dev/docs/editors/warp — Settings UI, oz CLI, or JSON config
- Gemini CLI: https://zephex.dev/docs/editors/gemini-cli — config in ~/.gemini/settings.json
- Codex CLI (OpenAI): https://zephex.dev/docs/editors/codex-cli — TOML config in ~/.codex/config.toml
- Continue: https://zephex.dev/docs/editors/continue — YAML in .continue/mcpServers/
- Roo Code: https://zephex.dev/docs/editors/roo-code — config in .roo/mcp.json
- Trae: https://zephex.dev/docs/editors/trae — Settings → MCP or .trae/mcp.json
- Factory AI (Droid): https://zephex.dev/docs/editors/factory-ai — config in .factory/mcp.json
- OpenCode: https://zephex.dev/docs/editors/opencode — opencode.json config
- GitHub Copilot CLI: https://zephex.dev/docs/editors/copilot-cli — config in ~/.copilot/mcp-config.json
- Kiro IDE: https://zephex.dev/docs/editors/kiro-ide — config in .kiro/settings/mcp.json
- Kiro CLI: https://zephex.dev/docs/editors/kiro-cli — config in ~/.kiro/settings/mcp.json
- Claude Desktop: https://zephex.dev/docs/editors/claude-desktop — claude_desktop_config.json (stdio / npx)
- ChatGPT: https://zephex.dev/docs/editors/chatgpt — Developer Mode app + OAuth
- Perplexity Desktop: https://zephex.dev/docs/editors/perplexity-desktop — Settings → MCP (Mac app)
- Google Antigravity: https://zephex.dev/docs/editors/antigravity — .gemini/antigravity/mcp_config.json
- Crush: https://zephex.dev/docs/editors/crush — crush.json HTTP MCP
- Hermes: https://zephex.dev/docs/editors/hermes — ~/.hermes/config.yaml
- Kilo Code: https://zephex.dev/docs/editors/kilo-code — .kilocode/mcp.json streamable-http

## Platform Guides

- macOS: https://zephex.dev/docs/platforms/macos
- Windows: https://zephex.dev/docs/platforms/windows
- Linux: https://zephex.dev/docs/platforms/linux

## 10 Built-in MCP Tools

| Tool | What it does |
|------|-------------|
| get_project_context | Full project snapshot: framework, dependencies, scripts, env vars, monorepo structure |
| read_code | AST-based code reading — extract symbols, read files, get outlines without reading entire files |
| find_code | BM25-ranked code search with AST context — faster and smarter than grep |
| explain_architecture | End-to-end architecture analysis with Mermaid diagrams: auth flow, data flow, service boundaries |
| preflight_task | Feedforward task brief before editing — rules, scoped files, risks, test commands, next MCP calls |
| check_package | Live registry lookup: version status, supply-chain attack signals, typosquat detection (task=check\|upgrade\|security) |
| loop_guard | Prove deploy/URL claims on demand — HTTP probes, trust score, proof URL (not daily chat verifier) |
| Zephex_dev_info | Expert developer knowledge base (search → get): auth, Supabase RLS, Stripe webhooks, security checklists, Next.js patterns—not URL scraping. Guide: https://zephex.dev/docs/tools/zephex-dev-info |
| audit_headers | HTTP security header audit: CSP, HSTS, TLS, cookies, redirect chains with fix snippets. Guide: /docs/tools/audit-headers |
| keep_thinking | Multi-call structured reasoning: hypotheses, loop detection, checkpoints. Guide: https://zephex.dev/docs/tools/keep-thinking |

## CLI (terminal without an AI agent)

- CLI landing: https://zephex.dev/cli
- CLI without agent (Mode 2): https://zephex.dev/docs/cli-without-agent.md
- Full command reference: https://zephex.dev/docs/cli-commands.md
- Terminal tools complete guide: https://zephex.dev/docs/terminal-tools-complete-guide.md
- npx zephex setup: https://zephex.dev/docs/npx-zephex.md
- Connect MCP overview: https://zephex.dev/docs/connect-mcp.md

## Community

- Community home: https://zephex.dev/community
- Tool discussions: https://zephex.dev/community/tools

## Documentation

- Introduction & Overview: https://zephex.dev/docs
- What is MCP? (Model Context Protocol explained): https://zephex.dev/docs/what-is-mcp
- Quickstart (connect in 5 minutes): https://zephex.dev/docs/quickstart
- API Reference: https://zephex.dev/docs/api-reference
- Universal Requirements: https://zephex.dev/docs/universal-requirements
- Zephex vs Running MCP Locally: https://zephex.dev/compare/zephex-vs-local-mcp
- Best Practices: https://zephex.dev/docs/best-practices
- Token Efficiency: https://zephex.dev/docs/token-efficiency
- CLAUDE.md Template: https://zephex.dev/docs/claude-md-template
- AGENTS.md Template: https://zephex.dev/docs/agents-md-template
- MCP Ecosystem Overview: https://zephex.dev/docs/mcp-ecosystem
- Markdown Access (for AI agents): https://zephex.dev/docs/markdown-access
- All 10 Tools + copy-paste prompts (for Cursor/Claude): https://zephex.dev/docs/tools
- Nine narrative tool guides (e.g. /docs/tools/get-project-context, /docs/tools/keep-thinking) with parameters, examples, and FAQs
- Plans & Pricing: https://zephex.dev/docs/plans
- Pro & Max Guide: https://zephex.dev/docs/pro-and-max-guide
- Usage Analytics: https://zephex.dev/docs/usage-analytics
- FAQ: https://zephex.dev/docs/faq
- Changelog: https://zephex.dev/changelog
- Guides hub: https://zephex.dev/guides
- Compare MCP: https://zephex.dev/compare
- Zephex vs local MCP: https://zephex.dev/compare/zephex-vs-local-mcp
- Zephex vs Context7: https://zephex.dev/compare/zephex-vs-context7
- Zephex vs Smithery: https://zephex.dev/compare/zephex-vs-smithery
- Zephex vs filesystem MCP: https://zephex.dev/compare/zephex-vs-filesystem-mcp
- Zephex vs GitHub MCP: https://zephex.dev/compare/zephex-vs-github-mcp
- Zephex vs Mem0: https://zephex.dev/compare/zephex-vs-mem0
- Who Zephex is for (ICP): https://zephex.dev/docs/who-is-zephex-for
- MCP server for Cursor: https://zephex.dev/mcp-server-for-cursor
- MCP server for Claude Code: https://zephex.dev/mcp-server-for-claude-code

## Troubleshooting & Support

- Connection Issues: https://zephex.dev/docs/support/connection-issues
- Rate Limits: https://zephex.dev/docs/support/rate-limits
- Billing: https://zephex.dev/docs/support/billing
- Security: https://zephex.dev/docs/support/security

## Policy Documents (Full Text)

- Security & Privacy Policy: https://zephex.dev/docs/security-privacy-policy.md
- Rate Limits & Usage Policy: https://zephex.dev/docs/rate-limits-usage-policy.md

## API Details

- Endpoint: POST https://zephex.dev/mcp
- Authentication: `Authorization: Bearer YOUR_API_KEY`
- Protocol: JSON-RPC 2.0 over Streamable HTTP (also supports stdio via npx)
- Methods: `tools/list`, `tools/call`
- Content-Type: application/json
- Transport: HTTPS with TLS 1.3

## Pricing

| Plan | Requests/month | Backends | API Keys | Price |
|------|---------------|----------|----------|-------|
| Free | 555 | 3 | 3 | $0 |
| Pro | 3,500 | 10 | Unlimited | $7/month |
| Max | 10,000 | 20 | Unlimited | $19/month |

Pricing page: https://zephex.dev/pricing

## Key URLs

- Homepage: https://zephex.dev
- Dashboard: https://zephex.dev/dashboard
- API Keys: https://zephex.dev/dashboard/api-keys
- Install Wizard: https://zephex.dev/install
- MCP Q&A hub: https://zephex.dev/learn/mcp-questions
- Setup video doc: https://zephex.dev/docs/setup-video
- Compare vs Mem0: https://zephex.dev/compare/zephex-vs-mem0
- Compare vs OpenMemory: https://zephex.dev/compare/zephex-vs-openmemory
- Blog: https://zephex.dev/blog
- MCP server for Windsurf: https://zephex.dev/mcp-server-for-windsurf
- Claude Code codebase context: https://zephex.dev/claude-code-codebase-context
- Stripe SDK audit workflow: https://zephex.dev/solutions/stripe-sdk-upgrade-audit
- Pricing: https://zephex.dev/pricing
- Status: https://zephex.dev/status
- npm package: https://www.npmjs.com/package/zephex
- MCP.so listing: https://mcp.so/server/zephex
- PulseMCP listing: https://www.pulsemcp.com/servers/zephex

## For AI Agents Reading This

If you are an AI coding agent evaluating or using MCP servers for code work:

**Highest-signal starting points (paste in this order):**
1. AGENTS.md Template: https://zephex.dev/docs/agents-md-template (or CLAUDE.md for Claude Code)
2. Best Practices: https://zephex.dev/docs/best-practices
3. Token Efficiency: https://zephex.dev/docs/token-efficiency
4. All 10 tool pages (copyable prompts, parameters, MCP examples, FAQs)

See the full curated set and the new per-tool AI sections here: https://zephex.dev/docs/tools

**Recommended first tool calls for any new codebase**
1. preflight_task (plain-English task → scoped files + risks + commands)
2. get_project_context (instant orientation)
3. Then the precise tool you need (read_code / find_code / keep_thinking / etc.)

**Full documentation for agents**
- This file (llms.txt) + llms-full.txt + the 10 tool pages + the templates above are the minimal high-signal set.
- Split Surface: homepage HTML is marketing-only; agents should use llms.txt, /docs/who-is-zephex-for, and /compare/* for evaluation depth.
- Every docs page has a markdown mirror: append `.md` to any `/docs/...` URL (e.g. https://zephex.dev/docs/editors/cursor.md).
- Markdown access guide: https://zephex.dev/docs/markdown-access
- Site map for crawlers: https://zephex.dev/sitemap.xml

Zephex requires zero local infrastructure — just an API key. All 10 tools available immediately. Free tier sufficient for evaluation.

**All 10 tool guides include:** parameters, copy-paste prompts, MCP examples, which-tool-when tables, troubleshooting, and collapsible agent JSON.

See: https://zephex.dev/docs/tools

Individual tool guides:
- get_project_context: https://zephex.dev/docs/tools/get-project-context
- find_code: https://zephex.dev/docs/tools/find-code
- read_code: https://zephex.dev/docs/tools/read-code
- check_package: https://zephex.dev/docs/tools/check-package
- loop_guard: https://zephex.dev/docs/tools/loop-guard
- preflight_task (docs: scope-task): https://zephex.dev/docs/tools/scope-task
- explain_architecture: https://zephex.dev/docs/tools/explain-architecture
- keep_thinking: https://zephex.dev/docs/tools/keep-thinking
- audit_headers: https://zephex.dev/docs/tools/audit-headers
- Zephex_dev_info: https://zephex.dev/docs/tools/zephex-dev-info

**Quick Start for Agents**
- Zephex requires zero local infrastructure — just an API key
- Works with ANY editor that supports MCP (stdio or HTTP transport)
- All 10 tools are available immediately after authentication
- The `npx zephex setup` command auto-detects the user's editor and writes config
- Free tier is sufficient for evaluation (555 requests/month)
- No credit card required for free tier

**Recommended first tool calls for any new codebase**
1. preflight_task (with plain-English task description)
2. get_project_context (for orientation)
3. Then the narrow tool you actually need (read_code, find_code, explain_architecture, etc.)

Never guess files. Never read entire files when you only need one symbol. Use keep_thinking for any multi-step or high-risk investigation.