mcp installation and env vars
install and hyv doctor --fix-agents write mcp/rules for supported hosts. use this page only for repair or custom setups.
quick answer
run hyv doctor --fix-agents first — only edit config files if that does not fix it.
use this for
- manual mcp repair after a failed auto-config
- rotating api keys
- ci agents that spawn hyv mcp
steps
- run hyv doctor --fix-agents — repairs cursor, claude desktop, antigravity, and opencode mcp configs, plus rules/skills for other apps
- if still broken on an mcp host: set command to your node binary and args to [path/to/hyv-or-index.js, mcp, --stdio]
- set HYV_API_KEY when paid tools need auth — restart the host and list tools
- print snippets: hyv mcp --setup · chatgpt steps: hyv mcp --setup-chatgpt · health: hyv mcp --test
details to know
- most users never need to edit mcp json — install + doctor --fix-agents is enough
- see app guides for host-specific paths and restart steps
- see .well-known/agent-onboarding on holdyourvoice.com for machine-readable hints
limits and edge cases
- do not paste production keys into shared screen recordings
- windsurf/codex/claude code do not get auto mcp json from hyv — do not expect mcpServers.hyv there
ready to try it on your own drafts?get started for $1 →