mcp tools reference
the mcp server exposes tools for analysis, rewriting, profiles, usage, and documents. agents should choose the exact tool instead of guessing product behavior.
quick answer
use list or read tools before write tools, and use analyze before rewrite when the draft has not been inspected yet.
use this for
- choosing the right mcp tool
- documenting agent workflows
- debugging tool permission errors
steps
- call the usage tool to confirm the key and plan.
- call the profile list or brand resolver when the user has more than one voice.
- call analyze to inspect a draft.
- call rewrite only for text the user wants changed.
- call document tools when the user wants sync with the app.
details to know
- `hyv_analyze` checks a draft against a profile.
- `hyv_rewrite` rewrites text in the selected voice.
- `hyv_list_profiles` and `hyv_resolve_brand` help pick the right profile.
- `hyv_get_usage` reads current usage and limits.
- document tools list, get, create, update, and delete app documents when scopes allow it.
limits and edge cases
- mcp tools still need api scopes and plan access.
- agents should ask before deleting or overwriting documents.
- list tools may paginate or cap results to avoid huge responses.
ready to use the product instead of reading about it?
open app