Skip to main content
Glama

Remove account sitelink

soclo_ads_remove_account_sitelink
DestructiveIdempotent

Soclo Ads: Remove account sitelink. Spending/deletion: preview, then owner-approved confirm:true with the same requestId. Claim live only when status is active. Fields: soclo://tools/soclo_ads_remove_account_sitelink.

Input Schema

NameRequiredDescriptionDefault
confirmNoTrue only after owner approval of spending/deletion preview.
platformNo
accountIdYes
requestIdNoReuse this request ID for confirmation and outcome recovery.
parametersYes
adAccountIdNoAdvertiser/ad account selected from your Soclo connection.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • removedInput schema / properties / accountId / description
      Removed value: -"The connected ad account in Soclo."
    • removedInput schema / properties / platform / description
      Removed value: -"The campaign platform."
  2. First observed

TDQS

A3.9/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructive=true, idempotent=true and openWorld=true, so the safety profile is partly covered; the description earns credit by adding the two-phase preview/owner-approval gate, requestId reuse for outcome recovery, and the 'claim live only when status is active' condition. It does not spell out exactly what is destroyed (the asset's association vs. the asset itself), which keeps it below 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the action, then the confirmation constraint, then the status condition — good ordering with no filler. The trailing 'Fields: soclo://tools/...' pointer is a bare reference whose usefulness to an agent is unclear, which is a small tax on an otherwise tight description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a destructive, nested-parameter mutation with no output schema, the description supplies the essential operational context: preview before confirm, owner approval, requestId reuse, and the status check that determines success. It could be more complete by stating what happens on a rejected/mismatched requestId or what the removal affects downstream, but nothing critical for a correct call is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 50%, and the description adds real meaning for confirm (owner approval of a spending/deletion preview) and requestId (reuse for confirmation and outcome recovery). It says nothing about assetId's numeric-only constraint, adAccountId, or platform, so half the parameters remain unexplained beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Names a specific verb and resource ('Remove account sitelink') with an explicit 'Soclo Ads:' domain prefix, so an agent can tell it apart from add/update/list sitelink siblings by name. It stops short of explicitly contrasting itself with soclo_ads_update_account_sitelinks or soclo_ads_remove_account_callout, which is the only thing keeping it from a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives concrete procedural guidance: run a spending/deletion preview, then confirm with owner-approved confirm:true reusing the same requestId. This is clear context for how the tool must be invoked, but it offers no statement of when to prefer this over the sibling update/remove variants, so no exclusions are covered.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources