Skip to main content
Glama

Giornata Mondiale

fetch

fetch
Read-onlyIdempotent

Fetch the published editorial text, dates, primary sources and correction history of an exact day identifier returned by search or list_days.

Input Schema

NameRequiredDescriptionDefault
idYes

Output Schema

NameRequiredDescriptionDefault
idYes
textYes
titleYes
topicsYes
sourcesYes
end_dateYes
date_ruleYes
month_dayYes
organizerYes
date_basisYes
date_rulesYes
provenanceYes
recurrenceYes
start_dateYes
updated_atYes
content_urlYes
correctionsYes
descriptionYes
institutionYes
reviewed_atYes
markdown_urlYes
canonical_urlYes
content_scopeYes
organizer_urlYes
resolution_urlYes
next_occurrenceYes
authority_statusYes
content_truncatedYes
correction_historyYes
first_published_atYes
official_source_urlYes
recurrence_end_dateYes
resolution_referenceYes
official_source_titleYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedOutput schema / properties / date_rules
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "id",
      -  "title",
      -  "description",
      -  "canonical_url",
      -  "start_date",
      -  "end_date",
      -  "month_day",
      -  "recurrence",
      -  "recurrence_end_date",
      -  "date_rule",
      -  "organizer",
      -  "organizer_url",
      -  "topics",
      -  "authority_status",
      -  "official_source_title",
      -  "official_source_url",
      -  "institution",
      -  "resolution_reference",
      -  "resolution_url",
      -  "reviewed_at",
      -  "first_published_at",
      -  "updated_at",
      -  "correction_history",
      -  "next_occurrence",
      -  "date_basis",
      -  "text",
      -  "content_truncated",
      -  "content_scope",
      -  "content_url",
      -  "markdown_url",
      -  "sources",
      -  "corrections",
      -  "provenance"
      -]New value: +[
      +  "id",
      +  "title",
      +  "description",
      +  "canonical_url",
      +  "start_date",
      +  "end_date",
      +  "month_day",
      +  "recurrence",
      +  "recurrence_end_date",
      +  "date_rule",
      +  "date_rules",
      +  "organizer",
      +  "organizer_url",
      +  "topics",
      +  "authority_status",
      +  "official_source_title",
      +  "official_source_url",
      +  "institution",
      +  "resolution_reference",
      +  "resolution_url",
      +  "reviewed_at",
      +  "first_published_at",
      +  "updated_at",
      +  "correction_history",
      +  "next_occurrence",
      +  "date_basis",
      +  "text",
      +  "content_truncated",
      +  "content_scope",
      +  "content_url",
      +  "markdown_url",
      +  "sources",
      +  "corrections",
      +  "provenance"
      +]
  2. Changed26 schema fields changed
    • removedOutput schema / properties / end_date / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / end_date / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / first_published_at / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / first_published_at / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / institution / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / institution / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / next_occurrence / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / next_occurrence / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / official_source_title / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / official_source_title / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / official_source_url / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / official_source_url / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / organizer_url / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / organizer_url / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / recurrence_end_date / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / recurrence_end_date / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / resolution_reference / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / resolution_reference / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / resolution_url / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / resolution_url / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / reviewed_at / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / reviewed_at / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / start_date / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / start_date / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / updated_at / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / updated_at / type
      Added value: +[
      +  "string",
      +  "null"
      +]
  3. First observed

TDQS

A3.9/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true, idempotentHint=true, destructiveHint=false and openWorldHint=false, so the safety and idempotency profile is fully covered structurally. The description adds only a list of returned content, which duplicates the output schema rather than disclosing new traits like auth requirements, rate limits, or pagination. Minimal added behavioral value beyond annotations.

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

Conciseness5/5

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

A single front-loaded sentence with no filler; the action and its output come first and the id provenance is appended as a qualifying clause. Every clause earns its place.

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?

For a one-parameter read tool with an output schema and full annotations, the description covers purpose, provenance of the id, and returned content. Return-format detail is unnecessary given the output schema, so nothing essential is missing.

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?

Schema coverage is 0% and the schema only says a string of 1-300 characters, so the description carries the burden. It meaningfully compensates by explaining that the id is an 'exact day identifier returned by search or list_days', telling the agent precisely where to source the value, though it doesn't describe the id's format.

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?

States a specific verb (Fetch) and the resource it returns (published editorial text, dates, primary sources, correction history) for an exact day identifier. It distinguishes itself from siblings by noting the id comes from search or list_days, though the phrase 'day identifier' is slightly ambiguous about whether it fetches the day record or the editorial content.

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?

Clearly routes the agent: use this after obtaining an id from search or list_days, implying it is the retrieval step following discovery. It does not state when-not to use it or contrast further with list_days/list_topics, but the context is clear.

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