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.

updated jul 11, 2026 integrations no images
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

  1. install hyv globally (postinstall auto-wires supported apps).
  2. run hyv doctor --fix-agents to write or repair agent configs.
  3. open the matching app guide and fully quit/reopen that app.
  4. chatgpt.com (paid plan + developer mode): remote oauth at https://holdyourvoice.com/mcp — see use-hyv-in-chatgpt.
  5. claude.ai: remote oauth connector — see use-hyv-in-claude.
  6. perplexity (pro+): remote oauth connector — see use-hyv-in-perplexity.
  7. 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 →