Audit Email
audit_emailAudit a SaaS lifecycle email using the 7-point Decision Friction Model and return a structured conversion diagnosis.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"api_key": "<api_key>",
"subject": "<subject>",
"body": "<body>"
},
"name": "audit_email"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | The full email body, including its copy and calls to action. | |
| api_key | Yes | Required API key from /api/mcp/claim-key. | |
| subject | Yes | The email subject line to audit. | |
| audience | No | Optional description of the intended email audience. | |
| email_type | No | Optional lifecycle context, such as "trial onboarding", "changelog", or "re-engagement". | |
| preview_text | No | Optional preview or preheader text shown beside the subject. | |
| desired_action | No | Optional action the sender wants the reader to take. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| changes | No | Changes made by the audit service. | |
| message | No | Friendly usage or next-step message when no diagnosis is returned. | |
| variants | No | Alternative rebuild variants returned by the audit service. | |
| audits_used | No | Number of audits used after this request. | |
| cta_pattern | No | The Decision Friction Model pattern that best describes the CTA. | |
| cta_rewrite | No | A specific rewritten CTA for this email. | |
| rebuilt_cta | No | The rebuilt call to action. | |
| result_type | Yes | Whether the diagnosis was parsed into validated model fields. | |
| upgrade_url | No | Upgrade URL returned by the audit service. | |
| cta_weakness | No | Concrete explanation of why this CTA is weak. | |
| raw_response | No | The upstream diagnosis when it cannot be safely parsed into validated fields. | |
| rebuilt_body | No | The rebuilt email body. | |
| overall_score | No | Structural email score from 0/10 to 10/10. | |
| rebuilt_score | No | Rebuilt structural email score from 0 to 10 for members. | |
| cta_exact_line | No | Exact CTA line from the email, or an explicit no-CTA statement. | |
| original_score | No | Original structural email score from 0 to 10 for members. | |
| audit_record_id | No | Identifier of the stored upstream audit record. | |
| rebuilt_subject | No | The rebuilt email subject. | |
| short_diagnosis | No | Brief explanation of the core structural conversion friction. | |
| audits_remaining | No | Number of audits remaining after this request. | |
| original_subject | No | The original email subject sent for rebuilding. | |
| structured_fixes | No | Structured email fixes returned by the audit service. | |
| cta_pattern_definition | No | Plain-language definition of the CTA pattern. | |
| cta_diagnosis_direction | No | Diagnosis and direction for the call to action. | |
| primary_friction_pattern | No | The main Decision Friction Model pattern found. | |
| secondary_friction_pattern | No | A secondary Decision Friction Model pattern, if present. | |
| recommended_structural_change | No | The highest-impact structural change to make. | |
| primary_friction_pattern_impact | No | Concrete reason the primary pattern can reduce response or conversion. | |
| primary_friction_pattern_evidence | No | Exact problematic phrase from this email showing the primary pattern. | |
| secondary_friction_pattern_impact | No | Concrete reason the secondary pattern can reduce response or conversion. | |
| primary_friction_pattern_definition | No | Plain-language definition of the primary pattern. | |
| secondary_friction_pattern_evidence | No | Exact problematic phrase from this email showing the secondary pattern. | |
| secondary_friction_pattern_definition | No | Plain-language definition of the secondary pattern, when present. |