democracy_get_cantonal_results

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

Annotations geben readOnlyHint und idempotentHint. Die Beschreibung ergänzt Details zum Rückgabewert (Stimmberechtigte, Ja/Nein, etc.) und zur nationalen Zusammenfassung, was über die Annotationen hinausgeht. Keine Widersprüche.

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?

Die Beschreibung ist strukturiert (Bullet Points, Args/Returns) und die Kernfunktion steht im ersten Satz. Sie könnte etwas kürzer sein, ist aber nicht übermäßig lang.

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?

Bei einem einfachen, schreibgeschützten Tool mit einem Parameter und vorhandener Ausgabebeschreibung ist die Vollständigkeit ausreichend. Fehlende Fehlerbehandlung ist nicht kritisch.

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?

Das Schema beschreibt den Parameter vote_number bereits ausführlich (Herkunft, Beispiele). Die Tool-Beschreibung wiederholt dies nur knapp. Bei 0% Schema-Coverage (laut Kontext) wäre mehr Erläuterung nötig, aber die Schema-Beschreibung ist tatsächlich vorhanden, daher Baseline 3.

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?

Die Beschreibung nennt spezifisch den Verb 'gibt zurück' und die Ressource 'Abstimmungsresultate aller 26 Kantone für eine eidgenössische Volksabstimmung'. Dies unterscheidet das Tool klar von Geschwistern wie democracy_get_vote_detail, die sich auf einzelne Abstimmungen beziehen.

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?

Die Beschreibung impliziert die Verwendung für eidgenössische Volksabstimmungen und listet die Ausgabe auf, gibt aber keine expliziten Hinweise, wann man dieses Tool gegenüber Alternativen wie democracy_bfs_get_vote_results verwenden sollte oder wann nicht.

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