Skip to main content
Glama

shomikigen

賞味期限切れ・消費期限切れの食品がいつまで食べられるかの判定。食品名(卵・ゆで卵・牛乳・ヨーグルト・バター・チーズ・アイス・豆腐・充填豆腐・納豆・ケーキ・パン・キムチ・冷凍食品・水・日本酒・ビール・ワイン・お茶・砂糖・はちみつ・チョコ・ガム・しょうゆ・みそ・マヨネーズ・塩・食用油・カップ麺・缶詰・レトルト・米・小麦粉・市販薬)と、未開封か開封後か、表示の日付か過ぎた日数を渡すと、業界団体・メーカーの公表値と食品表示基準(消費者庁)にもとづく判定(期限内/開けて確かめる/目安を超えている/食べない/期限表示の無い食品)を出典つきで返す。年月だけの表示は月末まで。「賞味期限が3日過ぎた牛乳は飲める?」「開けた納豆はいつまで」「豆腐は消費期限?」の相談にはこれ。画面は /shomikigen/、台帳は /api/shomikigen.json

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
dateNo表示の日付。2026.10.5 / 2026.10(年月だけなら月末)/ 令和8年10月5日。days の代わり
daysNo期限から過ぎた日数(負は期限内。既定 0)
foodYes食品名(別名可。例:豆腐、たまご、カップラーメン、醤油)か slug
frozenNo冷凍していたら true
openedNo開封後なら true(既定 false)

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A4.1/5.0
Behavior4/5

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

With no annotations provided, the description carries the full behavioral burden and does well: it discloses the data provenance (industry-association/manufacturer published values plus 消費者庁 food-labeling standards), the citation-backed output, the five possible verdicts, and the month-only-date convention. It does not state whether the call is read-only or what the response structure looks like, but for a lookup tool this is solid.

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?

A single dense paragraph that front-loads the purpose and verdict vocabulary before the input description. The long food enumeration is somewhat bulky but functional; nothing is wasted on filler.

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?

With no output schema, the description compensates by naming the judgment categories and stating that sources are returned, which is what an agent needs to route and interpret results. It stops short of describing the actual response shape (e.g., JSON field names), so it is strong but not exhaustive.

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 all five parameters (food, date, days, frozen, opened) are already documented in the schema, including the date-format examples and 'days の代わり' relationship. The description adds the food alias/slug breadth and the month-end rule, but these duplicate or loosely restate schema content, so the baseline of 3 applies.

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?

States a specific verdict-style action ('判定' of how long expired food remains edible), enumerates the resource (foods, dates, opened/unopened state) and the exact output categories (期限内/開けて確かめる/目安を超えている/食べない/期限表示の無い食品). An agent knows immediately what this does and that it differs from unrelated siblings like furusato or denki_keisan.

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?

Gives concrete trigger queries ('賞味期限が3日過ぎた牛乳は飲める?', '開けた納豆はいつまで', '豆腐は消費期限?') and explicitly says '相談にはこれ', so the when-to-use condition is clear. It names no alternative tool, but the sibling list contains no competing food-expiry tool, so exclusion guidance is largely unnecessary.

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