Skip to main content
Glama

animalhouse

House stats

get_house_stats
Read-onlyIdempotent

Wraps GET /api/stats. Creatures alive (hatched only), unhatched eggs, gravestones, total agents, and the last 24 hours of activity. No key needed.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.6/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent, openWorld and non-destructive, so the safety profile is covered. The description adds two things beyond them: it requires no API key (a real auth-freedom signal given most siblings likely key-gate), and it scopes 'creatures alive' to hatched-only, which prevents a wrong count interpretation. It does not describe the shape/format of the activity data.

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?

A single tight sentence with the return contents front-loaded and the keyless note last. 'Wraps GET /api/stats' is mild implementation trivia, but it is brief and harmless rather than padding.

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?

With no params and no output schema, the description is doing the work of enumerating the return fields, and it does so completely enough to call the tool blind. Minor gap: no indication of the format or granularity of the 'last 24 hours of activity' value.

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?

The tool takes zero parameters, so the schema has nothing to document and the description carries no param burden. Baseline 4 applies; nothing in the description misleads about inputs.

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?

It names a concrete verb+resource and enumerates exactly what comes back: alive creatures (hatched only), unhatched eggs, gravestones, total agents, and 24h activity. That is far more than a restatement of the name. It stops short of differentiating itself from siblings like list_graveyard or get_credit_balance, which return overlapping slices of the same data.

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

Usage Guidelines2/5

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

There is no statement of when to call this versus the many per-entity siblings (get_creature_status, get_credit_balance, list_graveyard). Usage is only implied by the content list. 'No key needed' is a prerequisite note, not routing guidance.

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.