Tool tree
gradeNot graded
analyze_readabilityAction
Scores how machine-readable the page currently in the working copy is for AI agents. Returns a 0-100 score, a per-signal breakdown, and a ranked list of gaps. Call this first.
View tool JSON
{
"name": "analyze_readability",
"kind": "act",
"impl": "imperative",
"description": "Scores how machine-readable the page currently in the working copy is for AI agents. Returns a 0-100 score, a per-signal breakdown, and a ranked list of gaps. Call this first.",
"inputSchema": {
"type": "object",
"properties": {},
"required": []
}
}check_answerableAnswer
Given a list of questions a real user might ask, checks whether each can be answered from the page's extractable content, and how discoverable the answer is. You supply the questions. Returns per-question status: answerable, buried, or not_found.
View tool JSON
{
"name": "check_answerable",
"kind": "answer",
"impl": "imperative",
"description": "Given a list of questions a real user might ask, checks whether each can be answered from the page's extractable content, and how discoverable the answer is. You supply the questions. Returns per-question status: answerable, buried, or not_found.",
"inputSchema": {
"type": "object",
"properties": {
"questions": {
"type": "array",
"items": {
"type": "string"
},
"description": "Questions a real visitor would ask this page."
}
},
"required": [
"questions"
]
}
}apply_fixAction
Applies one improvement to the working copy and updates it in place. Supported types: 'add_summary' (needs: text) prepends a direct-answer paragraph; 'add_heading' (needs: text; optional: level, beforeText) inserts a descriptive heading; 'add_faq_schema' (needs: items, an array of {question, answer}) appends FAQPage JSON-LD; 'rewrite_anchor' (needs: oldText, newText) replaces vague link text; 'add_metadata' (needs: title and/or description) adds page metadata. You write the actual wording; this tool handles the structure. Call apply_fix once per fix.
View tool JSON
{
"name": "apply_fix",
"kind": "act",
"impl": "imperative",
"description": "Applies one improvement to the working copy and updates it in place. Supported types: 'add_summary' (needs: text) prepends a direct-answer paragraph; 'add_heading' (needs: text; optional: level, beforeText) inserts a descriptive heading; 'add_faq_schema' (needs: items, an array of {question, answer}) appends FAQPage JSON-LD; 'rewrite_anchor' (needs: oldText, newText) replaces vague link text; 'add_metadata' (needs: title and/or description) adds page metadata. You write the actual wording; this tool handles the structure. Call apply_fix once per fix.",
"inputSchema": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "One of: add_summary, add_heading, add_faq_schema, rewrite_anchor, add_metadata."
},
"text": {
"type": "string"
},
"level": {
"type": "number"
},
"beforeText": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"question": {
"type": "string"
},
"answer": {
"type": "string"
}
}
}
},
"oldText": {
"type": "string"
},
"newText": {
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"type": "string"
}
},
"required": [
"type"
]
}
}rescoreAction
Re-runs the readability score on the current working copy and reports the change since the last check. Call this after applying fixes to show the improvement.
View tool JSON
{
"name": "rescore",
"kind": "act",
"impl": "imperative",
"description": "Re-runs the readability score on the current working copy and reports the change since the last check. Call this after applying fixes to show the improvement.",
"inputSchema": {
"type": "object",
"properties": {},
"required": []
}
}export_optimizedAction
Returns the current improved page content (the working copy) so the user can copy it, plus the before and after scores.
View tool JSON
{
"name": "export_optimized",
"kind": "act",
"impl": "imperative",
"description": "Returns the current improved page content (the working copy) so the user can copy it, plus the before and after scores.",
"inputSchema": {
"type": "object",
"properties": {},
"required": []
}
}