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

Non essendoci annotations, la descrizione si assume pienamente l'onere informativo: chiarisce che i risultati dipendono dal mercato, che uno snapshot recente (<7 giorni) viene riusato gratuitamente (cached=true), che il refresh richiede ~30-60s e che l'azione consuma 1 unità della quota mensile e 1 azione MCP. Sono comportamenti essenziali non deducibili dallo schema.

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

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

La descrizione è densa ma ogni frase aggiunge informazione rilevante: scopo, mercato, caching, tempi, costo e controllo crediti. Non ripete lo schema e l'avviso di azione a pagamento è ben evidenziato.

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

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

Senza annotations e senza output schema, la descrizione copre input, comportamento, prestazioni e costo in modo sufficiente. Restano non specificati l'organization_id e la struttura esatta del risultato, ma l'insieme è comunque adeguato per un uso corretto.

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

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

Lo schema descrive già domain, language_code e location_code con default; la descrizione aggiunge il concetto di 'mercato' e spiega perché lo stesso dominio dà risultati diversi su google.ch vs google.it. organization_id resta però non documentato né nello schema né nella descrizione, un piccolo gap.

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

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

La descrizione dichiara chiaramente che lo strumento analizza la concorrenza di un dominio e ne restituisce keyword organiche, traffico stimato e top keyword/pagine. Il purpose è riconoscibile, ma non c'è una distinzione esplicita rispetto al sibling 'get_domain_analysis', che sembra molto simile nello scopo.

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

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

Fornisce contesto utile: dati per mercato, default Italia/it, costo a pagamento e suggerimento 'Usa get_usage per i crediti residui'. Non indica però quando preferire questo tool rispetto a get_domain_analysis, get_competitors o get_keywords, né esclude alternative specifiche.

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