seo/update-integration-settings toggles the third-party services Yoast can surface in the editor: Semrush keyphrase research and its country code, Wincher rank tracking and whether new keyphrases are tracked automatically, and Algolia search.
These switch the integration on and off. The OAuth connection is made from the Yoast admin screens, and its tokens are never readable or writable through this suite.
At a glance
| Ability | seo/update-integration-settings |
| Toolset | Yoast SEO — toolset/yoast-seo |
| Group | Yoast SEO › Settings |
| Requires | Yoast SEO, active on the site |
| Capability | manage_options |
| Safety | Writes data |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
Switches, not connections
Each of these integrations has two parts: a toggle, and an authenticated connection to the service. This ability covers the first only.
That separation is deliberate. The connection involves OAuth tokens — credentials that grant access to an account outside this site — and neither reading nor writing them is something this suite does.
So turning an integration on when no connection exists produces a toggle that is on and an integration that prompts for a connection. That is the correct outcome, and it is not a failure.
The Wincher automatic-tracking setting is worth a note: with it on, every new focus keyphrase is added to rank tracking, which consumes the account’s keyword allowance without anybody deciding to.
Idempotent.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
settings | object | Yes | A map of setting key to new value. Keys outside this area are refused. |
What comes back
| Name | Type | What it is |
|---|---|---|
updated | array | The keys that changed. |
settings | object | The area after the write. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
Turn on the Semrush integration.
It resolves to one call:
{
"ability": "seo/update-integration-settings",
"parameters": {
"settings": { "semrush_integration_active": true }
}
}Worth knowing
- Toggles only. The OAuth connection is made in the Yoast admin.
- Tokens are never readable or writable here.
- Wincher automatic tracking consumes the account’s keyword allowance silently.
- Idempotent.
Related abilities
- Get SEO Settings — read the integrations area
- List Conflicting Plugins — other third-party interference
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category