Skip to main content
Glama

WhoIsBringing — Group Event & Potluck Item Coordinator

Get Event Checklist

get_event_checklist
Read-onlyIdempotent

Inspect the current status of an event checklist, including items claimed vs unclaimed, percentage completed, and attendee allocations. When to use: Call this tool when you specifically need to execute 'get_event_checklist' on WhoIsBringing Event Coordinator (whoisbringing.com). Do NOT use this tool when another specialized tool fits better (use 'create_event_checklist' or 'claim_checklist_item' or 'add_checklist_items' for their respective operations). Parameters: event_id (required). Behavior & Side Effects: Strictly read-only, idempotent query with zero state mutation; public unauthenticated access allowed; rate-limited to 60 requests/min per IP. Returns: Structured JSON object containing status, matched records or computed metrics, and canonical action URLs.

Input Schema

NameRequiredDescriptionDefault
event_idYesThe 8-character event ID or slug [Required: non-empty valid value must be supplied].

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / event_id / description
      Previous value: -"The 8-character event ID or slug"New value: +"The 8-character event ID or slug [Required: non-empty valid value must be supplied]."
  2. 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 readOnlyHint, idempotentHint, and destructiveHint=false, so the description earns credit for what it adds beyond them: public unauthenticated access and a 60 requests/min per-IP rate limit. The stated return shape ('status, matched records or computed metrics, and canonical action URLs') is generic boilerplate phrasing rather than a real description of the payload.

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

Conciseness3/5

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

Structure is front-loaded and labeled (When to use / Parameters / Behavior / Returns), which helps scanning. But the sentence 'Call this tool when you specifically need to execute get_event_checklist on WhoIsBringing Event Coordinator (whoisbringing.com)' is self-referential filler, and the Returns line is templated padding that earns no space.

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?

This is a simple single-parameter read with no output schema, and the description covers access model, rate limits, side-effect profile, and rough return content. What's missing is what an empty or not-found checklist returns, which matters for an inspection tool.

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 100% and the schema already describes event_id as an 8-character ID or slug. The description only restates 'event_id (required)' and adds nothing about the 8-character/slug format or validation behavior, so baseline 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 opening sentence gives a specific verb and resource ('Inspect the current status of an event checklist') plus concrete content: claimed vs unclaimed items, completion percentage, attendee allocations. It distinguishes itself from create/claim/add siblings implicitly through the 'inspect/status' framing, though it never states the read-vs-write distinction as a differentiator.

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 explicitly names sibling tools (create_event_checklist, claim_checklist_item, add_checklist_items) and instructs not to use this tool when one of them fits, which is real routing guidance. Weakness: the positive condition is a tautology ('when you specifically need to execute get_event_checklist') rather than a described scenario such as 'when you want a read-only snapshot before deciding what to claim'.

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