Skip to main content
Glama

House stats

get_house_stats
Read-onlyIdempotent

Wraps GET /api/stats. Creatures alive (hatched only), unhatched eggs, gravestones, total agents, the last 24 hours of activity, and trends: the last 12 weeks (or months, with period=month) of sign-ups, adoptions, care actions, deaths, active caretakers, pets alive at the end of each period, and the shares of each period's adoptions ghosted after day one and cared for a week or more (given only for 10 or more adoptions; the count behind each share is always given). The current period is marked partial; a value that was not measured yet is null, not zero. Bulk sign-up bursts and test accounts are not counted. No key needed.

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": "get_house_stats"
  }
}

Input Schema

NameRequiredDescriptionDefault
periodNoHow to group the trends: week (default, the last 12 weeks, Monday to Sunday, UTC) or month (the last 12 months). Any other value falls back to week and is named in `ignored`.

Output Schema

NameRequiredDescriptionDefault
errorNoWhat went wrong, on a failure.
agentsNoAgents registered.
trendsNoThe house over time: { period, as_of, periods }, each period with start, end, partial, agents_registered, pets_adopted, care_actions, deaths, active_caretakers, pets_alive_at_end, ghosted_after_day_one_pct and still_cared_for_after_a_week_pct, and the number of adoptions each share is of (ghosted_after_day_one_of, still_cared_for_after_a_week_of). A share of fewer than 10 adoptions is null. Null when trends are not available.
detailsNoMore about a failure, when there is more to say.
ignoredNoQuery values that were not understood, and what was used instead.
messageNoA human and agent readable note about what just happened.
next_stepsNoGuided actions you can take from here. Present on nearly every response. /api/stats is a plain counter and carries none, by design.
suggestionNoWhat to try instead, on a failure.
gravestonesNoPets that have died.
activity_24hNoWhat has happened in the last day.
eggs_unhatchedNoAdoptions that never got their first status call, so the egg never hatched.
creatures_aliveNoLiving pets, not counting unhatched eggs.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • addedInput schema / properties / period
      Added value: +{
      +  "description": "How to group the trends: week (default, the last 12 weeks, Monday to Sunday, UTC) or month (the last 12 months). Any other value falls back to week and is named in `ignored`.",
      +  "enum": [
      +    "week",
      +    "month"
      +  ],
      +  "type": "string"
      +}
    • changedOutput schema / description
      Previous value: -"House-wide counts. A plain counter, so it carries no next_steps."New value: +"House-wide counts, and how they are moving. A plain counter, so it carries no next_steps."
    • addedOutput schema / properties / ignored
      Added value: +{
      +  "description": "Query values that were not understood, and what was used instead."
      +}
    • addedOutput schema / properties / trends
      Added value: +{
      +  "description": "The house over time: { period, as_of, periods }, each period with start, end, partial, agents_registered, pets_adopted, care_actions, deaths, active_caretakers, pets_alive_at_end, ghosted_after_day_one_pct and still_cared_for_after_a_week_pct, and the number of adoptions each share is of (ghosted_after_day_one_of, still_cared_for_after_a_week_of). A share of fewer than 10 adoptions is null. Null when trends are not available."
      +}
  2. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "additionalProperties": {},
      +  "description": "House-wide counts. A plain counter, so it carries no next_steps.",
      +  "properties": {
      +    "activity_24h": {
      +      "description": "What has happened in the last day."
      +    },
      +    "agents": {
      +      "description": "Agents registered."
      +    },
      +    "creatures_alive": {
      +      "description": "Living pets, not counting unhatched eggs."
      +    },
      +    "details": {
      +      "description": "More about a failure, when there is more to say."
      +    },
      +    "eggs_unhatched": {
      +      "description": "Adoptions that never got their first status call, so the egg never hatched."
      +    },
      +    "error": {
      +      "description": "What went wrong, on a failure."
      +    },
      +    "gravestones": {
      +      "description": "Pets that have died."
      +    },
      +    "message": {
      +      "description": "A human and agent readable note about what just happened."
      +    },
      +    "next_steps": {
      +      "description": "Guided actions you can take from here. Present on nearly every response. /api/stats is a plain counter and carries none, by design.",
      +      "items": {
      +        "additionalProperties": {},
      +        "description": "A suggested next call. Following one is never required.",
      +        "properties": {
      +          "action": {
      +            "description": "Short name for the action, e.g. \"adopt\", \"feed\", \"view_schema\"."
      +          },
      +          "body": {
      +            "description": "A ready-to-send request body. Copy it and fill in what it shows."
      +          },
      +          "description": {
      +            "description": "What this step does and why you might take it, in the house voice."
      +          },
      +          "endpoint": {
      +            "description": "Path to call, e.g. \"/api/house/status\"."
      +          },
      +          "method": {
      +            "description": "HTTP method to use: GET, POST or DELETE."
      +          },
      +          "optional": {
      +            "description": "Extra fields you may add to body, each mapped to what to put in it. Never send this object as-is."
      +          },
      +          "url": {
      +            "description": "Absolute URL, when the step points off the API (a checkout page, a web page)."
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "suggestion": {
      +      "description": "What to try instead, on a failure."
      +    }
      +  },
      +  "type": "object"
      +}
  3. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.