Skip to main content
Glama
Sign In

Helfer & Profi

by io.github.helferundprofi
OverviewDiscussionsAdmin

Etwas verleihen, verschenken oder suchen

ding_anlegen

Für den Nutzer etwas zum Verleihen oder Verschenken eintragen (nur kostenlos, nur Abholung). Nur auf ausdrücklichen Wunsch und nach Bestätigung durch den Nutzer. Öffentlich werden titel, beschreibung, ort und kurzname – dort keine Adresse, Telefonnummer, E-Mail oder Links. kontakt muss eine E-Mail-Adresse sein: Dorthin kommt ein Bestätigungslink (48 Stunden gültig, sonst Löschung), erst danach ist der Eintrag 60 Tage sichtbar. Anfragen kommen per E-Mail; beenden oder verlängern kann der Nutzer mit dem Link aus der E-Mail. Mit art=suchen trägt der Nutzer ein, was er sucht („Ich suche …“, 30 Tage sichtbar, ohne Fotos).

Input Schema

NameRequiredDescriptionDefault
artYesverleihen = nur ausleihen, verschenken = geschenkt, suchen = „Ich suche …“ (der Nutzer möchte etwas leihen oder geschenkt bekommen)
ortYesPLZ und Ort, z. B. '69412 Eberbach' (ohne Straße)
titelYesWas es ist, 5–80 Zeichen, z. B. 'Bohrmaschine mit Koffer'
consentYestrue nur, wenn der Nutzer mindestens 18 ist und ausdrücklich der Datenschutzerklärung und der Veröffentlichung von Ort und Kurzname zugestimmt hat
kontaktYesE-Mail-Adresse (Pflicht, wird nie veröffentlicht; dorthin kommen Bestätigungslink und Anfragen)
kurznameYesÖffentlicher Kurzname, 2–30 Zeichen, z. B. 'Petra aus Eberbach'
kategorieYesRubrik: werkzeug, garten, fahrzeug (Auto, Anhänger, Transporter), fahrrad, boot (Boot, Kanu, SUP), haushalt, moebel, kinder, freizeit (Sport, Camping), technik, buecher (auch Spiele, Medien), bau (Bau, Renovierung), kleidung, sonstiges
regeln_okYestrue nur, wenn der Nutzer bestätigt: kostenlos (kein Preis, keine Miete, kein Verkauf) und nichts Verbotenes dabei
fahrzeug_okNoBei kategorie fahrzeug oder boot Pflicht (true): Nutzer lässt sich vor der Übergabe den Führerschein zeigen (beim Boot den Bootsführerschein, wenn einer nötig ist) und klärt die Versicherung – bei art=suchen: Nutzer zeigt vor der Übergabe seinen Führerschein, und die Versicherung wird vorher geklärt
beschreibungNoOptional: Zustand, Größe, wann abholbar – höchstens 480 Zeichen

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • changedInput schema / properties / art / description
      Previous value: -"verleihen = nur ausleihen, verschenken = geschenkt"New value: +"verleihen = nur ausleihen, verschenken = geschenkt, suchen = „Ich suche …“ (der Nutzer möchte etwas leihen oder geschenkt bekommen)"
    • changedInput schema / properties / art / enum
      Previous value: -[
-  "verleihen",
-  "verschenken"
-]New value: +[
+  "verleihen",
+  "verschenken",
+  "suchen"
+]
    • changedInput schema / properties / fahrzeug_ok / description
      Previous value: -"Bei kategorie fahrzeug oder boot Pflicht (true): Nutzer lässt sich vor der Übergabe den Führerschein zeigen (beim Boot den Bootsführerschein, wenn einer nötig ist) und klärt die Versicherung"New value: +"Bei kategorie fahrzeug oder boot Pflicht (true): Nutzer lässt sich vor der Übergabe den Führerschein zeigen (beim Boot den Bootsführerschein, wenn einer nötig ist) und klärt die Versicherung – bei art=suchen: Nutzer zeigt vor der Übergabe seinen Führerschein, und die Versicherung wird vorher geklärt"
  2. Added

TDQS

A4.3/5.0
Behavior5/5

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

The description adds substantial behavior beyond the annotations: which fields become public, what must not appear publicly, the email confirmation link with 48-hour validity and deletion on failure, 60-day visibility after confirmation, and 30-day visibility without photos for art=suchen. It discloses the full lifecycle and communication flow, which the annotations alone do not provide.

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?

The description is dense but front-loaded with the core purpose and constraints. Every sentence carries relevant rules or lifecycle information, though the paragraph packs several distinct concerns and could be slightly easier to scan.

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

Completeness5/5

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

For a complex create-listing tool with 10 parameters and no output schema, the description covers the essential workflow, visibility, consent, confirmation, expiry, and contact behavior. It does not repeat every schema detail, but it provides the contextual information an agent needs to call the tool correctly and safely.

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

Parameters4/5

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

Schema coverage is 100%, so the schema already documents all parameters. The description still adds useful meaning by emphasizing public visibility rules for titel, beschreibung, ort, and kurzname, and by clarifying the email confirmation workflow tied to kontakt. It does not explain every parameter, but it adds meaningful constraints beyond the schema text.

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 states a specific action: creating a listing for lending, giving away, or searching, including the art=suchen variant. It is clear what the tool does, but it does not explicitly distinguish itself from sibling tools such as dinge_suchen, so sibling differentiation is only implicit.

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?

It gives clear usage conditions: only on the user's explicit request, only after confirmation, only free of charge, and only for pickup. It does not name alternative tools or explain when to use those instead, which keeps it from a 5.

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

All Helfer & Profi toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources