Skip to main content
Glama

Read one record, routed by the archive its identifier names

get_item
Read-onlyIdempotent

Retrieves a full archive record by identifier from a prior search, returning metadata, reuse terms, selected sections, and paginated prose so you can inspect the exact item.

Instructions

Read one record in full from the archive its identifier names: what it is, who made it, when, what the archive says about it, and what a reader can open. 'identifier' must come from search_inside or search_items. It names the archive, so this reads the right one without guessing; a string no archive would have minted is refused, and a shape more than one archive mints is refused rather than sent to a guess, because sending it anywhere answers about the wrong thing. Terms of reuse come back on every read and belong to that record alone. A record stating none has granted nothing, and silence is never read as permission. 'sections' decides what else comes back, and the answer names what was left out and what this archive files nothing under: a field empty because nobody asked for it is a different thing from a field the archive never fills. 'description_means' says what the archive files under the field this reads a description out of, which holds an account of the thing on one record and a line of the catalogue entry on the next. Long prose is returned one window at a time: 'text_offset' says where to resume, and a window ends at a line boundary. An offset past the end says so rather than answering with an empty description. An answer can take several seconds, because one of the archives publishes a request ceiling this server keeps to.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "identifier": "<identifier>"
    },
    "name": "get_item"
  }
}

Input Schema

NameRequiredDescriptionDefault
sectionsNoWhich parts to return besides the record's identity and its terms of reuse.
identifierYesFrom a search, such as 'archive:mobydickorwhale01melv' or 'loc:sn83030214/1900-01-01/ed-1/seq-1'.
max_copiesNoCopies to list. The answer says how many more the record holds.
text_offsetNoWhere to resume in the record's prose, in characters from its start.
max_text_charsNoCharacters of prose to return. The text block shows roughly the first 1400 of them and the whole window is in the structured output. The answer says where to resume.

Output Schema

NameRequiredDescriptionDefault
itemYes
notesYes
id_read_asYesHow a raw identifier was routed, when it was not spelled with its archive.
text_windowYesWhich part of the record's prose this answer carries.
sections_omittedYesSections this call did not ask for. A field belonging to one of these is empty for that reason alone.
sections_returnedYes
fields_not_read_from_this_archiveYesFields this server reads nothing into from this archive. A field named here is empty for every record it returns, which is a different thing from a record that left it blank.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed28 schema fields changedv2.1.0
    • removedOutput schema / properties / id_read_as / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / id_read_as / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / item / properties / copies / items / properties / format / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / item / properties / copies / items / properties / format / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / item / properties / copies / items / properties / label / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / item / properties / copies / items / properties / label / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / item / properties / copies / items / properties / url / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / item / properties / copies / items / properties / url / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / item / properties / creator / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / item / properties / creator / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / item / properties / date / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / item / properties / date / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / item / properties / description / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / item / properties / description / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / item / properties / description_means / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / item / properties / description_means / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / item / properties / identifier_provisional / anyOf
      Removed value: -[
      -  {
      -    "type": "boolean"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / item / properties / identifier_provisional / type
      Added value: +[
      +  "boolean",
      +  "null"
      +]
    • removedOutput schema / properties / item / properties / media_type / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / item / properties / media_type / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / item / properties / rights / properties / covers / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / item / properties / rights / properties / covers / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / item / properties / rights / properties / statement / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / item / properties / rights / properties / statement / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / item / properties / rights / properties / url / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / item / properties / rights / properties / url / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / item / properties / title / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / item / properties / title / type
      Added value: +[
      +  "string",
      +  "null"
      +]
  2. Changed9 schema fields changedv1.2.0
    • addedOutput schema / properties / item / properties / attribution / description
      Added value: +"What to say when repeating this record, as its archive states it. An archive whose licence asks for the date its metadata was retrieved carries that date here."
    • changedOutput schema / properties / item / properties / description / description
      Previous value: -"The window of the record's own prose that 'text_window' describes."New value: +"The window of this record's description that 'text_window' describes. 'description_means' says what this archive files under that name, which is not always prose about the thing."
    • addedOutput schema / properties / item / properties / description_means
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "What the field this description was read out of holds on this archive. Null on an archive no description is read from."
      +}
    • changedOutput schema / properties / item / properties / generated_entries / description
      Previous value: -"Entries the archive lists against this record that are its own bookkeeping or the by-products of its processing rather than copies of the thing. They were left out of 'copies' and are on the archive's own page."New value: +"Entries the archive lists against this record that are not copies of the thing: its own bookkeeping, the by-products of its processing, or an image it attaches to illustrate the record. They were left out of 'copies' and are on the archive's own page."
    • addedOutput schema / properties / item / properties / identifier_provisional
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "True where the archive itself calls this identifier provisional: it can be replaced once a cataloguer settles the record. Null on an archive that mints one kind of identifier and says nothing about settling it."
      +}
    • addedOutput schema / properties / item / properties / rights / properties / covers
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "What the statement covers, where it covers more than this record. Null on an archive setting terms per deposit, where a statement covers the record it sits on and no other."
      +}
    • changedOutput schema / properties / item / properties / rights / properties / note / description
      Previous value: -"How to read the two fields above for this record, including when both are null."New value: +"How to read the fields above for this record, including when they are null."
    • changedOutput schema / properties / item / properties / rights / required
      Previous value: -[
      -  "statement",
      -  "url",
      -  "note"
      -]New value: +[
      +  "statement",
      +  "url",
      +  "covers",
      +  "note"
      +]
    • changedOutput schema / properties / item / required
      Previous value: -[
      -  "id",
      -  "source",
      -  "source_name",
      -  "identifier",
      -  "title",
      -  "creator",
      -  "year",
      -  "year_means",
      -  "date",
      -  "media_type",
      -  "source_url",
      -  "attribution",
      -  "description",
      -  "notes",
      -  "subjects",
      -  "rights",
      -  "copies",
      -  "copies_available",
      -  "generated_entries",
      -  "context"
      -]New value: +[
      +  "id",
      +  "source",
      +  "source_name",
      +  "identifier",
      +  "title",
      +  "creator",
      +  "year",
      +  "year_means",
      +  "date",
      +  "media_type",
      +  "source_url",
      +  "attribution",
      +  "identifier_provisional",
      +  "description",
      +  "description_means",
      +  "notes",
      +  "subjects",
      +  "rights",
      +  "copies",
      +  "copies_available",
      +  "generated_entries",
      +  "context"
      +]
  3. First observedv1.0.0

TDQS

A4.4/5.0
Behavior5/5

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

Annotations already cover safety (readOnly, idempotent, non-destructive), yet the description adds substantial behavior beyond them: unknown or ambiguous identifier shapes are refused rather than guessed, terms of reuse return on every read with silence never read as permission, omissions are reported back, and reads can take several seconds because of an upstream request ceiling. These are exactly the traits an agent cannot infer from structured fields.

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?

The purpose and the identifier-source constraint are front-loaded, and every subsequent sentence carries distinct information (refusal rules, rights, sections, pagination, latency). It is a single dense paragraph with some redundant phrasing — 'refused rather than sent to a guess, because sending it anywhere answers about the wrong thing' — which costs it the top mark.

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?

An output schema exists, so return format need not be described; the description instead covers the things structure cannot: identifier provenance, refusal on ambiguous shapes, rights semantics, pagination windows and resume points, and expected latency. Nothing an agent needs to call this correctly is 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?

Schema coverage is 100%, so the baseline is 3, and the schema already documents all five parameters including defaults and bounds. The description adds some genuine meaning — that 'sections' determines what else returns and that an omitted field differs from a never-populated field, and that 'text_offset' past the end is reported rather than returning empty — but it does not clarify 'max_copies' or restate units, so the added value is partial.

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

Purpose5/5

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

Opens with a specific verb+resource and scope: 'Read one record in full from the archive its identifier names', and enumerates what comes back (identity, creator, date, archive statements, openable copies). It also distinguishes itself from the two siblings by requiring the identifier to come from search_inside or search_items, so an agent can separate it from the search tools without opening a schema.

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?

Explicitly states the prerequisite — "'identifier' must come from search_inside or search_items" — which routes the agent to the siblings and establishes the search-then-read workflow. It does not spell out an exclusion case (e.g., 'do not use for browsing or free-text lookup'), so it stops short of a full when/when-not statement.

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