Was this page helpful?
Add Zephex to .gemini/antigravity/mcp_config.json (user or project). Use serverUrl https://zephex.dev/mcp and Authorization Bearer — the hosted remote pattern Antigravity documents for cloud MCP, not npx stdio. See Antigravity MCP docs for how Google Antigravity handles MCP on their side.
HTTP and stdio setups both need a key from your Zephex dashboard. OAuth-only flows (ChatGPT, Claude.ai web) sign you in in the browser instead — skip this section for those.
Antigravity follows the Gemini agent MCP file layout under .gemini/antigravity/. Use serverUrl + Bearer — the same remote pattern as Windsurf and Cursor, not a local npx server.
Replace mcp_sk_your_key_here with your key from Dashboard → API Keys. Copy the full key once at creation — paste into Authorization: Bearer … for HTTP configs, or into ZEPHEX_API_KEY for stdio/npx configs.
Use serverUrl (not command/npx). Matches Antigravity’s documented remote MCP shape.
{ "mcpServers": { "zephex": { "serverUrl": "https://zephex.dev/mcp", "headers": { "Authorization": "Bearer mcp_sk_your_key_here" } } }}Tip
Do not mix serverUrl and command/npx for the same zephex entry — pick remote HTTP only.
Note
Antigravity shares the Gemini config tree — do not put this block in .cursor/mcp.json or .vscode/mcp.json.
After saving your config, confirm Zephex is connected before you rely on it in real work.
You do not call tools yourself — ask your agent in plain language. Try these once Zephex is connected:
“Antigravity agent: get_project_context on github:vercel/next.js — focus on package scripts.”
Remote repo intelligence with serverUrl MCP — no local clone required.
“explain_architecture for our Gemini extension’s message flow.”
Diagram clarifies modules before Antigravity edits TypeScript.
“check_package on an MCP SDK prerelease tag before we pin it.”
Version risk surfaced before package-lock changes.
“read_code the tool registration function in our MCP bridge.”
Symbol-level read for extension code.
“audit_headers on our marketing site deployed on Firebase Hosting.”
Header grade independent of IDE workspace.
“scope_task: add structured logging to all Cloud Function handlers.”
Scoped file set for a multi-folder Google Cloud project.
Antigravity agents read .gemini/antigravity/mcp_config.json — say github:owner/repo or the opened project path when a tool needs your codebase.
These situations usually mean the setup cannot work until you fix the underlying issue:
Used npx instead of serverUrl
Remove command/args — remote HTTP only for hosted Zephex.
Wrong config path
Use .gemini/antigravity/mcp_config.json, not .cursor or .vscode.
Connection failed
URL https://zephex.dev/mcp, Bearer + full key in headers.
0 tools listed
Valid JSON under mcpServers; restart agent session.
Tools work but empty repo context
Add github:owner/repo or project path in the prompt.
Antigravity agents reach Zephex through serverUrl — ten tools, one OAuth or Bearer setup:
get_project_context
Reads your project structure, dependencies, scripts, env vars, and framework markers in one call. Replaces manually opening package.json, tsconfig, and multiple config files at the start of every session.
read_code
AST-based code extraction: pass a symbol name and get the implementation without reading entire files. Supports symbol lookup, batched file reads, and structural outlines for large files.
find_code
Ranked search across the repo for definitions, usages, and patterns. Faster than blind grep when the agent does not know where a symbol lives.
check_package
Live registry lookup for npm, PyPI, Cargo, and Go modules. Surfaces typosquat risk, maintainer changes, and suspicious version jumps before you run install.
audit_package
Deep package intelligence: CVEs with severity, breaking changes between versions, migration notes, and peer-dependency conflicts.
explain_architecture
Generates Mermaid diagrams for auth flows, service boundaries, and module dependencies so the agent reasons about structure instead of guessing.
scope_task
Turns a task description into the smallest file set to read or edit, with risk ratings and caller impact notes.
audit_headers
Grades a deployed URL for CSP, HSTS, TLS, cookies, and redirects. Returns fix snippets for common hosts (Vercel, Cloudflare, Nginx).
keep_thinking
Structured multi-step debugging: tracks hypotheses and conclusions so long investigations do not loop.
Zephex_dev_info
Expert patterns for authentication, databases, frontend frameworks, deployment, and mobile stacks when the agent needs vetted guidance.