Skip to main content
Glama

land_stake_deed_details

Get a land deed's staking summary: worker counts, boosts, and totals. Provide a plot ID or deed UID to fetch the record.

Instructions

Includes plot_view with the public overview PRODUCTION / HR value (Total PP times efficiency, or unscaled with Runi; zero when explicitly unpowered), plus separately labelled reference PP and resource-output values. Missing inputs remain unknown; raw response and provenance are preserved. Get the staking summary the upstream reports for one land deed, as GET /land/stake/deed/details/{deedUid} returns it. A successful response has {status, data}, where data is one flat record of the deed's staking flags, worker counts, boosts and totals. A deed with nothing staked returns that record fully present, with its numeric fields zero and its boolean flags false, so an empty answer on this route is a populated record rather than an absent one. On this route the boost and total figures are JSON numbers; the deed-assets tool returns the equivalent per-card figures as JSON strings. The two routes disagree about wire type, this server returns each exactly as received, and a change in that wire type would be reported as a malformed response rather than converted silently. The record carries a manager string as returned by the upstream; its role is not stated. A deed uid the upstream does not recognise was measured to return a successful response holding no record rather than an error, so an answer holding no record establishes neither that the deed exists nor that it does not: this server cannot tell it apart from a deed that exists and has no staking record. The one deed with nothing staked that this repository observed returned the zeroed record described above rather than no record, which is a single observation and not a rule. The deed-assets tool answers a rejected deed uid with an upstream error instead, so the two tools do not behave alike on a bad deed uid. This tool reports only what the record states: it does not compute free slots, does not derive which cards are staked, and does not treat a total as evidence about any individual card. Supply exactly one plot_id (numeric or display label) or deed_uid; the original UID spelling is also accepted. Reference resolution may add one verified deed GET before the target GET, with a hard two-request limit. Populated resolved results include all three plot identities and resolution freshness.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
deedUidNo
plot_idNo
deed_uidNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv0.0.0

TDQS

A4/5.0
Behavior5/5

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

With no annotations, the description carries the full burden and excels: it discloses that raw responses and provenance are preserved, that it does not compute derived values, that a deed with nothing staked returns a zeroed record, and that unrecognized deed uids return success with no record. It even notes that a change in wire type would be reported as malformed rather than silently converted. This is exceptional transparency.

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

Conciseness2/5

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

The description is a dense, unstructured paragraph of several hundred words. The primary purpose is buried after a confusing opening about plot_view, and there are no clear sections for purpose, usage, or edge cases. It would benefit from front-loading the main action and splitting into logical paragraphs or bullets.

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?

Despite its verbosity, the description covers all necessary context: response shape ({status, data} with a flat record), edge cases (empty deed, bad deed uid), comparisons with siblings, reference resolution limits, and explicit limitations (does not compute free slots, etc.). Since there is no output schema, the description compensates by explaining the data structure thoroughly. Nothing an agent needs to call this tool correctly seems missing.

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?

The description says to supply exactly one plot_id or deed_uid and clarifies that plot_id can be numeric or a display label, but it does not explain the difference between deedUid and deed_uid parameters in the schema. The schema lists both deedUid and deed_uid, yet the description only mentions deed_uid, leaving ambiguity about their relationship and usage.

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 eventually states the primary action: 'Get the staking summary the upstream reports for one land deed.' However, the opening sentence about plot_view and PRODUCTION/HR value is distracting and not the core purpose. It does differentiate from the deed-assets tool via wire type differences, so the purpose is clear after reading, but not immediately front-loaded.

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?

The description explains behavioral differences from the deed-assets tool, such as handling of bad deed uids and wire types, implying when to use which tool. However, it does not explicitly state 'use this when you need the upstream-reported staking summary' versus alternatives; the guidance is implicit rather than explicit.

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

Deploy Server

Other Tools