mcp server

the mcp server lets compatible assistants call hold your voice tools through the user's api key. it wraps the same rest api.

updated may 3, 2026 api and mcp no images
quick answer

use mcp when a user wants an ai assistant to check or rewrite drafts in their own workflow.

use this for

  • claude desktop setup
  • cursor or assistant workflows
  • agent-based document checks

steps

  1. create an api key.
  2. download `mcp_server.py` from the site.
  3. set `HYV_API_KEY` in the mcp config.
  4. set `HYV_BASE_URL` only if using a non-production endpoint.
  5. restart the assistant.
  6. call the hold your voice tools.

details to know

  • tools include analyze, rewrite, list profiles, get usage, list documents, get document, create document, update document, and resolve brand.
  • the server speaks stdio json-rpc.
  • all api calls still use `/v1/` with bearer auth behind the scenes.

limits and edge cases

  • if the api key is missing, every tool call fails.
  • mcp does not bypass plan, scope, or quota rules.
ready to use the product instead of reading about it? open app