Typetone Developers

Guides

Tools reference

Every tool the Typetone MCP server offers your AI assistant. You don't call these yourself: ask in plain language and the assistant picks the right tool.

Tool Changes data Uses credits
list_brand_voices No No
get_brand_voice No No
list_content_rules No No
check_content No Yes
get_credit_balance No No
list_rulesets No No
list_assets No No
audit_assets Yes Yes
get_audit_results No No
list_audits No No
list_violations No No
get_violation No No
review_violation Yes No
comment_on_violation Yes No

Brand and rules

Give the assistant your brand voice and rules, so it writes on-brand from the start.

list_brand_voices

Lists the brand voices (tone-of-voice profiles) in the workspace.

Try: "Which brand voices do we have in Typetone?"

get_brand_voice

Returns the full guidelines of one brand voice. Guidelines are only available for voices your team created.

Parameters

  • brand_voice_idstringrequired

    From list_brand_voices.

  • language_keystring

    Only return one language, for example EN or NL.

Try: "Rewrite this email in our professional brand voice."

list_content_rules

Lists the compliance and brand rules content is checked against.

Try: "What rules does our content need to follow on pricing claims?"

Check content

Check a draft before it goes anywhere.

check_content

Uses credits

Checks a text against the workspace's rules. Returns each violation with the violating text, severity and a recommended fix.

Parameters

  • contentstringrequired

    The text to check, up to 60,000 characters.

  • titlestring

    Title of the content, for context.

  • urlstring

    Where the content will be published, for context. The page is not fetched.

Try: "Check this LinkedIn post against our compliance rules and fix what's wrong."

get_credit_balance

Returns the remaining credit balance of the workspace.

Try: "How many Typetone credits do we have left?"

Run audits

Audit content that is already in your Asset Vault.

list_rulesets

Lists the rulesets (rule groups) available for audits.

Try: "Which rulesets can I audit against?"

list_assets

Lists or searches assets in the Asset Vault: web pages, documents, social posts.

Parameters

  • searchstring

    Search term on name or URL.

  • limitinteger

    Maximum results, default 25.

Try: "Find our savings account pages in the Vault."

audit_assets

Changes data Uses credits

Starts a compliance audit of up to 10 assets against one ruleset. Large audits ask for confirmation first: the assistant repeats the call with the returned estimate_id.

Parameters

  • asset_idsarray of stringrequired

    Up to 10 asset IDs from list_assets.

  • ruleset_idstringrequired

    From list_rulesets.

  • estimate_idstring

    Confirms a large audit after the credit estimate.

Try: "Audit the three newest savings pages against our marketing compliance ruleset."

get_audit_results

Returns the progress of an audit and the violations found per asset.

Parameters

  • batch_idstringrequired

    The audit ID returned by audit_assets.

Try: "Is the audit done yet? What did it find?"

Review audits

Work through the violations of an audit and record decisions, under your own name.

list_audits

Lists the workspace's audits, newest first, with a violation count for each.

Parameters

  • limitinteger

    Maximum results, default 20.

Try: "Show me our latest audits."

list_violations

Pages through the violations of one audit. Undecided violations come first by default.

Parameters

  • audit_idstringrequired

    From list_audits.

  • review_statestring

    undecided (default), elevated_risk, urgent_violation, dismissed, fixed or all.

  • severitystring

    Only one severity, for example HIGH.

  • searchstring

    Search in the flagged text, reason or rule name.

  • pageinteger

    Page number, default 1.

  • page_sizeinteger

    Up to 50, default 20.

Try: "Walk me through the undecided violations of Monday's audit, most severe first."

get_violation

Returns one violation in full: flagged text, reason, rule, recommended fix, suggested text and comments.

Parameters

  • violation_idstringrequired

    From list_violations.

Try: "Show me the next one."

review_violation

Changes data

Records a review decision: dismiss (reason required), elevated_risk, urgent_violation, mark_fixed or reopen.

Parameters

  • violation_idstringrequired

    The violation to decide on.

  • actionstringrequired

    dismiss, elevated_risk, urgent_violation, mark_fixed or reopen.

  • reasonstring

    Required for dismiss, not accepted otherwise.

  • apply_to_groupboolean

    Also decide on every violation with the same group_id.

Try: "Dismiss it: that's a quote from the regulator, not our claim."

comment_on_violation

Changes data

Adds a comment to a violation's thread. Mentions don't assign the violation or notify anyone.

Parameters

  • violation_idstringrequired

    The violation to comment on.

  • commentstringrequired

    Up to 5,000 characters.

Try: "Add a note that legal needs to see this before Friday."

Something unclear or missing? Tell us and we'll improve this page.

Developers
Esc