Skip to main content
Glama

Influenza snapshot for a Japanese region

flu_region_snapshot
Read-only

What is the latest weekly flu count per sentinel for Japan, a prefecture or a covered health-center area? ISO week, value, recent weeks, official warning/advisory where announced (status_basis official), separate from a comparison with reference values (status_basis computed), school-closure counts by facility type and action where covered (no school names), tracking_since and receipts (url, fetched_at, sha256). Optional as_of date. Descriptive statistics only, no medical or travel advice.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
as_ofNoOptional date YYYY-MM-DD: answer with what this service had recorded by the end of that day (UTC). Free window: the last 30 days; older dates return OUTSIDE_FREE_HISTORY_WINDOW.
prefectureYesJP for the national total, or a prefecture: ISO 3166-2 code (JP-33), 1-2 digit code (33), English (Okayama) or Japanese (岡山県) name.
health_centerNoOptional health-center area (保健所管内) id or Japanese name, only for prefectures listed in coverage.prefectures_with_local_data.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
alertYes
as_ofYes
termsYesURL of the terms of service.
noticeYes
regionYes
statusYesfound = recorded and recently re-fetched; stale = last successful fetch older than stale_after_hours; not_yet_observed = no record (unknown, NOT 'no influenza'); unavailable = record store unreadable.
coverageYes
receiptsYesRaw files behind this answer: URL, when we fetched that content, SHA-256 of the bytes.
sentinelYes
provenanceYesFreshness receipts for every upstream source used.
answered_atYes
attributionYes
tracking_sinceYes
school_closuresYesAggregate counts by facility type and action; never facility names.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.6/5.0
Behavior4/5

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

Annotations already declare readOnlyHint and openWorldHint, so the safety profile is covered, and the description adds real context: status_basis official vs computed semantics, school-closure data excludes facility names, descriptive statistics only with no medical/travel advice, and receipts carry url/fetched_at/sha256. The 30-day window and table/area constraints live in the schema rather than here.

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

Conciseness3/5

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

The leading question front-loads the purpose well, but the remainder is a run-on enumeration of return fields mixing unrelated concepts (school closures, receipts hashes, disclaimer). 'Optional as_of date' duplicates the schema, so not every sentence 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?

Given an output schema exists, the description arguably over-explains return fields, but it does establish scope boundaries (official vs computed, no school names, no advice) and the coverage caveat for health_center. Nothing essential for correct invocation 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 description coverage is 100% and the schema already explains prefecture codes, health_center coverage limits, and the as_of window. The description's only parameter contribution is restating 'Optional as_of date', which adds nothing new.

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 opening question states a specific verb+resource+scope: the latest weekly flu count per sentinel for Japan, a prefecture, or a health-center area. It also draws a line between official warning status and computed reference comparison. It does not name the sibling flu_region_history or catalog, so sibling differentiation is partial.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is only implied by the word 'latest' and by the official-vs-computed status distinction; there is no explicit 'use this when / use flu_region_history instead' guidance. An agent can infer this is the current-snapshot tool, but must open the siblings to confirm.

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