mcp server
hyv mcp exposes scan, profile, and rewrite tools to hosts that support local mcp. other apps get rules or skills instead — see app guides.
quick answer
install hyv → hyv doctor --fix-agents → open the app guide for your host → restart that app.
use this for
- wiring cursor or claude desktop mcp
- letting an agent call hyv_scan on repo files
- documenting mcp for a team
steps
- install hyv globally (postinstall auto-wires supported apps).
- run hyv doctor --fix-agents to write or repair agent configs.
- open the matching app guide and fully quit/reopen that app.
- chatgpt.com (paid plan + developer mode): remote oauth at https://holdyourvoice.com/mcp — see use-hyv-in-chatgpt.
- claude.ai: remote oauth connector — see use-hyv-in-claude.
- perplexity (pro+): remote oauth connector — see use-hyv-in-perplexity.
- verify the local server: hyv mcp --test.
details to know
- real mcp json is written for cursor, claude desktop, antigravity, and opencode.
- claude code, windsurf, codex, and command code get rules or skills — not auto mcp json.
hyv mcp --setup only prints instructions; it does not write configs.- mcp uses the same auth and quotas as the cli.
- well-known agent discovery files list entry points for automated setup.
limits and edge cases
- mcp hosts must allow local process spawning for stdio servers.
- keep api keys out of committed mcp json — use env vars.
- a chat prompt alone cannot create chatgpt or claude remote connectors — use their settings ui.
ready to try it on your own drafts?get started for $1 →