Skip to main content
Glama

Umfragen auf Nexus Politics

umfragen
Read-onlyIdempotent

Umfragen auf Nexus Politics zu EU, Bund, Land und Kommune: laufende zum Mitmachen oder beendete mit Ergebnis (Anteile je Antwort), optional für eine Postleitzahl und nach Stichwort. Ergebnisse sind nicht repräsentativ.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "umfragen"
  }
}

Input Schema

NameRequiredDescriptionDefault
plzNoDeutsche Postleitzahl mit fünf Ziffern, z. B. „10117“
statusNobeendet (Standard, mit Ergebnis) oder laufend
suchbegriffNoStichwort in der Frage oder im Ort, z. B. „Tempo 30“

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.8/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent, non-destructive and closed-world, so the safety profile is covered. The description adds genuinely useful context beyond that: completed polls return per-answer shares, and results are explicitly not representative — an important caveat an agent should carry into its answer.

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

Conciseness5/5

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

A single sentence that front-loads the resource and scope, then branches into variants, optional filters and the caveat. No filler and nothing redundant.

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 three-optional-parameter list tool with no output schema, the description covers what is returned (shares per answer) and the non-representativeness caveat. Minor gaps remain around result volume, ordering or paging, which an agent might want to know.

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 description coverage is 100%, so all three parameters (plz, status, suchbegriff) are already documented with patterns and examples. The description only restates them at a high level ('optional für eine Postleitzahl und nach Stichwort') without adding syntax or interaction detail, so the baseline of 3 applies.

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?

The description names a concrete resource (Umfragen/polls on Nexus Politics) and its scope (EU, Bund, Land, Kommune), and splits it into the two meaningful variants: laufende zum Mitmachen vs. beendete mit Ergebnis. No verb is stated explicitly and no sibling is named for contrast, so it falls just short of 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 Guidelines3/5

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

Usage is implied by the laufend/beendet framing and the PLZ and keyword options, but there is no explicit statement of when to choose this tool or when to look elsewhere. It also does not reiterate that 'beendet' is the default, which the schema carries instead.

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