SEOmatic

SEO Tasks

task_manage

Destructive

The agent's full task lifecycle: read the plan board, stage proposals (create accepts up to 5 per call), approve/dismiss (decide), run approved tasks (execute), undo applied changes (rollback), and confirm a hand-pasted change (paste_done: SEOmatic looks for it on the live page before measuring). Staging never runs anything; every mutation is human-approval-gated - decide records the human's decision (auto-executable standalone tasks then dispatch within seconds; the response says whether they did), execute force-runs a task the instant path declined or releases held work with a staged-content reviewToken, rollback is drift-guarded. Already scoped to the connected workspace and its site; no domain or site parameter is needed. Cost: list/get/create/decide are FREE (create only STAGES proposals, nothing runs). rollback is FREE but UNDOES a live change - it is an action, not a read. paste_done is FREE. execute runs the agent and bills AI credits when the work runs (a title/meta/H1 fix is typically a few hundred credits); approving auto-dispatches that run. Inspecting tasks, evidence and statuses never triggers re-analysis.

Input Schema

TableJSON Schema

Name	Required	Description
`type`	No	list only: filter by task type.
`force`	No	rollback only: undo even though the live page drifted from what the agent wrote. Set ONLY after the user explicitly confirmed overwriting their newer edit.
`tasks`	No	create only: up to 5 task objects to stage as proposals (see the SEOmatic docs for the task shape).
`action`	Yes	Which operation to run. list (the plan board (filterable)); get (one task in full detail); create (stage up to 5 task proposals); decide (approve or dismiss a staged proposal (the approval loop)); execute (run an approved task now; a reviewToken releases staged holds; refresh_pull_request updates an open GitHub pull request, or opens a new one if someone else changed its branch); rollback (undo an executed task's live change (drift-guarded)); paste_done (the user pasted a handed-over change; SEOmatic looks for it on the live page before measuring).
`status`	No	list only: filter by task status (proposed, approved, ...).
`taskId`	No	get/decide/execute/rollback/paste_done: the task to act on.
`decision`	No	decide only: approve releases the task to the gated pipeline; dismiss archives it. Approving an indexation-destructive type (noindex, redirect) also requires confirmDestructive: true.
`reviewToken`	No	execute only: from get's stagedReview block. Releases a staged hold (first rewrite / money page); pass it ONLY after the human explicitly approved the staged content itself.
`confirmDestructive`	No	decide/execute: required true for indexation-destructive types (noindex, redirect). Attestation that the human explicitly signed off on this specific task after seeing its URL and consequence - never set it on your own judgment.
`refresh_pull_request`	No	execute only, GitHub: rewrite the task's OPEN pull request against the site's latest version (the dashboard's Refresh): updates the pull request, or opens a new one if someone else changed its branch. Runs the task again, so it uses AI credits like the first run - set it ONLY when the user asked for the refresh.

Output Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 9, 2026

removedInput schema / properties / user_intent

Removed value: -{
-  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
-  "maxLength": 300,
-  "type": "string"
-}

Changed3 schema fields changedOct 5, 2026

changedInput schema / properties / action / description

Previous value: -"Which operation to run. list (the plan board (filterable)); get (one task in full detail); create (stage up to 5 task proposals); decide (approve or dismiss a staged proposal (the approval loop)); execute (run an approved task now; a reviewToken releases staged holds; refresh_pull_request updates an open GitHub pull request, or opens a new one if someone else changed its branch); rollback (undo an executed task's live change (drift-guarded))."New value: +"Which operation to run. list (the plan board (filterable)); get (one task in full detail); create (stage up to 5 task proposals); decide (approve or dismiss a staged proposal (the approval loop)); execute (run an approved task now; a reviewToken releases staged holds; refresh_pull_request updates an open GitHub pull request, or opens a new one if someone else changed its branch); rollback (undo an executed task's live change (drift-guarded)); paste_done (the user pasted a handed-over change; SEOmatic looks for it on the live page before measuring)."

changedInput schema / properties / action / enum

Previous value: -[
-  "list",
-  "get",
-  "create",
-  "decide",
-  "execute",
-  "rollback"
-]New value: +[
+  "list",
+  "get",
+  "create",
+  "decide",
+  "execute",
+  "rollback",
+  "paste_done"
+]

changedInput schema / properties / taskId / description

Previous value: -"get/decide/execute/rollback: the task to act on."New value: +"get/decide/execute/rollback/paste_done: the task to act on."

Changed2 schema fields changedSep 28, 2026

changedInput schema / properties / action / description

Previous value: -"Which operation to run. list (the plan board (filterable)); get (one task in full detail); create (stage up to 5 task proposals); decide (approve or dismiss a staged proposal (the approval loop)); execute (run an approved task now; a reviewToken releases staged holds); rollback (undo an executed task's live change (drift-guarded))."New value: +"Which operation to run. list (the plan board (filterable)); get (one task in full detail); create (stage up to 5 task proposals); decide (approve or dismiss a staged proposal (the approval loop)); execute (run an approved task now; a reviewToken releases staged holds; refresh_pull_request updates an open GitHub pull request, or opens a new one if someone else changed its branch); rollback (undo an executed task's live change (drift-guarded))."

addedInput schema / properties / refresh_pull_request

Added value: +{
+  "description": "execute only, GitHub: rewrite the task's OPEN pull request against the site's latest version (the dashboard's Refresh): updates the pull request, or opens a new one if someone else changed its branch. Runs the task again, so it uses AI credits like the first run - set it ONLY when the user asked for the refresh.",
+  "type": "boolean"
+}

Changed1 schema field changedSep 18, 2026

changedInput schema / properties / confirmDestructive / description

Previous value: -"decide/execute: required true for indexation-destructive types (noindex, redirect). Attestation that the human explicitly signed off on this specific task after seeing its URL and consequence — never set it on your own judgment."New value: +"decide/execute: required true for indexation-destructive types (noindex, redirect). Attestation that the human explicitly signed off on this specific task after seeing its URL and consequence - never set it on your own judgment."

Changed4 schema fields changedSep 17, 2026

changedInput schema / properties / action / description

Previous value: -"Which operation to run. create (stage up to 5 task proposals); decide (approve or dismiss a staged proposal (the approval loop)); execute (run an approved task now; a reviewToken releases staged holds); rollback (undo an executed task's live change (drift-guarded))."New value: +"Which operation to run. list (the plan board (filterable)); get (one task in full detail); create (stage up to 5 task proposals); decide (approve or dismiss a staged proposal (the approval loop)); execute (run an approved task now; a reviewToken releases staged holds); rollback (undo an executed task's live change (drift-guarded))."

changedInput schema / properties / action / enum

Previous value: -[
-  "create",
-  "decide",
-  "execute",
-  "rollback"
-]New value: +[
+  "list",
+  "get",
+  "create",
+  "decide",
+  "execute",
+  "rollback"
+]

addedInput schema / properties / status

Added value: +{
+  "description": "list only: filter by task status (proposed, approved, ...).",
+  "type": "string"
+}

addedInput schema / properties / type

Added value: +{
+  "description": "list only: filter by task type.",
+  "type": "string"
+}

Changed7 schema fields changedSep 14, 2026

changedInput schema / properties / action / description

Previous value: -"Which operation to run. create (stage up to 5 task proposals); decide (approve or dismiss a staged proposal (the approval loop))."New value: +"Which operation to run. create (stage up to 5 task proposals); decide (approve or dismiss a staged proposal (the approval loop)); execute (run an approved task now; a reviewToken releases staged holds); rollback (undo an executed task's live change (drift-guarded))."

changedInput schema / properties / action / enum

Previous value: -[
-  "create",
-  "decide"
-]New value: +[
+  "create",
+  "decide",
+  "execute",
+  "rollback"
+]

addedInput schema / properties / confirmDestructive

Added value: +{
+  "description": "decide/execute: required true for indexation-destructive types (noindex, redirect). Attestation that the human explicitly signed off on this specific task after seeing its URL and consequence — never set it on your own judgment.",
+  "type": "boolean"
+}

changedInput schema / properties / decision / description

Previous value: -"decide only: approve releases the task to the gated pipeline; dismiss archives it. Indexation-destructive types are refused over the API."New value: +"decide only: approve releases the task to the gated pipeline; dismiss archives it. Approving an indexation-destructive type (noindex, redirect) also requires confirmDestructive: true."

addedInput schema / properties / force

Added value: +{
+  "description": "rollback only: undo even though the live page drifted from what the agent wrote. Set ONLY after the user explicitly confirmed overwriting their newer edit.",
+  "type": "boolean"
+}

addedInput schema / properties / reviewToken

Added value: +{
+  "description": "execute only: from get's stagedReview block. Releases a staged hold (first rewrite / money page); pass it ONLY after the human explicitly approved the staged content itself.",
+  "type": "string"
+}

changedInput schema / properties / taskId / description

Previous value: -"get/decide: the task to read or decide."New value: +"get/decide/execute/rollback: the task to act on."

Changed1 schema field changedSep 4, 2026

addedInput schema / properties / user_intent

Added value: +{
+  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
+  "maxLength": 300,
+  "type": "string"
+}

AddedSep 3, 2026

TDQS

Score is being calculated.

All SEOmatic tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

SEO Tasks

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources