Skip to main content
Glama

Reading progress

reading_status
Read-onlyIdempotent

Where a page's reading is, for FamilyLore's card while the page is read.

Input Schema

NameRequiredDescriptionDefault
page_idYesThe page's id

Output Schema

NameRequiredDescriptionDefault
stepNoWhile reading: transcribing the handwriting, translating it, or checking the notes once it is translated
sureNo
notesNoWhat it meant: FamilyLore's notes, every one
titleNo
statusYesnot_started, reading (about a minute and a half), read, failed or cancelled
page_idYesThe page's id on FamilyLore
read_onNoThe date FamilyLore read it
languageNoThe letter's language
page_urlYesThe page on familylore.ai
elapsed_sNoWhile transcribing: seconds since the reading started
confidenceNoHow sure the reading is, 0 to 1
expected_sNoWhile transcribing: how long readings in this language usually take, in seconds
sure_stepsNoHow sure, in steps of 5
translationNo
unsure_wordsNoHow many words the reading was unsure of
language_codeNoIts code, for a card to name it in the host's language
model_contextNoOnce read: the reading as text, for the card to give the assistant (ui/update-model-context)
right_to_leftNo
transcriptionNoAs written, in the letter's own script
unsure_word_indexesNoThe words the reading was unsure of, as positions in the transcription's words split on white space
translation_languageNo
translation_language_codeNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

C2.2/5.0
Behavior2/5

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

Annotations already declare readOnlyHint, idempotentHint, and non-destructive, so safety is covered. The description adds nothing beyond that: it doesn't say whether status is per-user, whether it changes over time, or what triggers it, despite being a progress-tracking read.

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?

It is short, but the single sentence is awkwardly constructed and front-loads an oblique clause. Brevity here comes from under-specification rather than efficiency; no waste is removed because there is almost no content to begin with.

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

Completeness2/5

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

An output schema exists, so return values needn't be explained, but the description still fails to say what status values mean or how this differs from get_reading. For a tool with many similarly named siblings, that omission leaves the agent without enough to choose correctly.

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% with a single required page_id already documented, so the description has little room to add meaning. It does at least imply page_id is the page whose status is fetched, matching the schema, so baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The phrase 'Where a page's reading is' gestures at a status lookup but never names a clear verb or resource; 'for FamilyLore's card while the page is read' reads as an internal implementation note rather than a description of the tool's job. An agent cannot confidently tell what reading_status returns versus the sibling get_reading.

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?

No when-to-use or when-not-to-use guidance is given, and the obvious alternative (get_reading, plus read_letter/real_letters/my_letters) is never mentioned. The clause about a UI card hints at a narrow use case but doesn't translate into an actionable selection rule.

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