Skip to main content
Glama
hiroshic9-png

Edition Intelligence Platform

EDITION Intelligence Platform

Glama Score npm License: MIT

Japan Knowledge Gateway for autonomous AI agents.

20 knowledge domains · 43 MCP tools · 7 Skills Packs · 100+ REST endpoints Verified ground truth for operating in the Japanese market. Quality score: 97.8/100.

Production API: api.edition.sh — Free beta, no registration required.

Interactive Demo: Tourist Agent Demo — Watch 6 domains work together in real-time.


Why EDITION?

AI agents working in Japan hit walls that generic LLMs can't solve:

Challenge

What goes wrong

Keigo (敬語)

「お持ちすれば喜ばれるかと存じます」 — hidden subject, layered honorifics, uncertainty expression. Generic NLP treats this as noise.

Implicit agreements

Japanese business communication rarely states things directly. Agents need cultural decoding.

Regulatory maze

10+ industries with overlapping national/prefectural regulations, most documentation only in Japanese.

Procedural complexity

Company incorporation, visa, banking — each requires 5-8 steps with specific documents, deadlines, and costs.

EDITION provides verified, structured intelligence that agents can use as ground truth instead of hallucinating cultural nuances, legal requirements, and procedural details.


Related MCP server: Torify — Japanese Locale APIs for AI Agents

20 Knowledge Domains

#

Domain

Tools

What it covers

1

Memory

memory_store memory_recall memory_facts memory_context memory_extract

Three-layer persistent memory (Episode/Fact/Context) with Japanese keigo analysis and social hierarchy detection

2

Regulation

regulation_check regulation_industries regulation_tourist

10 industries (food, real estate, finance, healthcare, construction, education, transport, retail, IT, manufacturing) + tourist compliance

3

Protocol

protocol_check protocol_list

Nemawashi, ringi, hourensou, meishi koukan, sekijun, zoutou — step-by-step procedures with cultural context

4

Calendar

calendar_check calendar_list

Fiscal year (April start), Golden Week, Obon, year-end, gift seasons, administrative deadlines

5

Regional

regional_check regional_list

Tokyo vs Osaka negotiation styles, local subsidies, prefectural regulations, dialect considerations

6

Organization

organization_check organization_list

Keiretsu networks, corporate hierarchy (bucho/kacho), payment customs (net-60), contract practices

7

Foreign Entry

foreign_entry_check foreign_entry_list

6 categories: company incorporation (KK/GK), management visa, bank account, real estate, tax registration, employee hiring

8

Travel

travel_search travel_list

Shinkansen, IC cards, ryokan etiquette, onsen rules, restaurant ordering, tipping customs

9

Entertainment

entertainment_search entertainment_list

Oshi-katsu fan culture, anime pilgrimage, live event manners, seasonal festivals

10

Daily Life

daily_life_search daily_life_list

Postal/address systems, garbage sorting by municipality, utilities (electricity/gas/water/NHK), healthcare navigation

11

Language

language_search language_list

Keigo honorific system, counter words (josushi), name/address structure, business Japanese templates

12

Food Culture

food_search food_list

Dining etiquette, cuisine classification, restaurant navigation (shokkenki, izakaya, sushi counter), dietary restrictions (halal, vegetarian, allergies)

13

Disaster & Safety

disaster_search disaster_list

Earthquake shindo scale & EEW, typhoon warning levels, emergency contacts (110/119/118), preparedness checklists

14

Healthcare

healthcare_search healthcare_list

National health insurance, hospital navigation, prescription system, medical Japanese terminology

15

Education

education_search education_list

School system (6-3-3-4), entrance exams, international schools, university admission for foreigners

16

Real Estate

real_estate_search real_estate_list

Rental process (shikikin/reikin/hoshoukin), property types, foreigner-friendly agencies, contract terms

17

Tax

tax_search tax_list

Income tax, consumption tax, withholding, year-end adjustment, tax filing for foreigners and businesses

18

Banking & Finance

banking_search banking_list

Bank account types, remittance, fintech services, corporate banking, payment systems

19

Visa & Immigration

visa_search visa_list

Visa categories, status of residence, renewal procedures, permanent residency, naturalization

20

Cross-Domain

search

Search all 20 domains simultaneously with a single query


Skills Packs (MCP Skills Primitive)

Pre-built knowledge packs that bundle domain expertise, SOPs, and tool orchestration instructions. Skills-aware agents can load these to gain structured Japan operational knowledge.

Skill Pack

Domains

Use Case

japan-market-entry

regulation, foreign_entry, organization

Company incorporation, visa, banking

japan-business-ops

protocol, calendar, regional, language

Meetings, nemawashi, business Japanese

japan-travel-guide

travel, food, entertainment, disaster

Tourist assistance, dining, safety

japan-daily-living

daily_life, food, language

Utilities, garbage, healthcare

japan-cultural-context

protocol, organization, language

Implicit communication, hierarchy

japan-safety-compliance

disaster, regulation

Earthquake response, regulatory compliance

japan-governance-compliance

regulation, governance

Audit trails, compliance reporting, AI Act readiness

Full Skills Pack documentation


Governance Intelligence

EDITION includes built-in compliance audit trail tools for agents operating under governance requirements. Available in both Progressive Discovery and Legacy modes.

regulation_check → compliance_log → compliance_report
      ↓                   ↓                  ↓
  Check rules      Record audit       Generate report

Tool

Purpose

compliance_log

Create immutable, timestamped audit record after any regulatory check

compliance_report

Generate governance reports (summary / detailed / JSON) from audit trail

Designed for EU AI Act (Aug 2026) and upcoming Japan AI governance compliance.


Quick Start

npx -y edition-mcp-server

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "edition": {
      "command": "npx",
      "args": ["-y", "edition-mcp-server"],
      "env": {
        "EDITION_API_URL": "https://api.edition.sh",
        "EDITION_API_KEY": "edition_dev_key_for_testing"
      }
    }
  }
}

Option 2: Smithery

npx -y smithery mcp add hiroshi-c9/edition

Option 3: REST API (Direct)

# Cross-domain search
curl -X POST https://api.edition.sh/api/v1/search \
  -H "Content-Type: application/json" \
  -d '{"query": "How do I start a tech company in Tokyo?"}'

# Regulation check
curl -X POST https://api.edition.sh/api/v1/regulation/check \
  -d '{"action": "open restaurant", "industry": "food_service"}'

# Business protocol
curl -X POST https://api.edition.sh/api/v1/protocol/check \
  -d '{"query": "nemawashi consensus building"}'

Memory API — Japanese-aware Persistent Memory

Store episodes, auto-extract structured facts with keigo analysis, social hierarchy detection, and confidence scoring.

Input:  "佐藤部長にはワインをお持ちすれば喜ばれるかと存じます"

Output:
  Subject:    佐藤 (役職: 部長)
  Predicate:  好む
  Object:     ワイン
  Keigo:      Level 2 (尊敬語)
  Hierarchy:  superior
  Confidence: 0.7 (推測 — not stated as fact)
  Tense:      present

Three-layer architecture:

  • Episodes — raw conversation logs

  • Facts — structured knowledge (subject→predicate→object triples)

  • Context — aggregated session summaries per entity/topic

MCP Capabilities

Category

Count

Details

Tools

43

All with annotations (readOnlyHint, destructiveHint, idempotentHint)

Resources

2

edition://domains (domain catalog), edition://quality (trust scores)

Prompts

2

japan_business_briefing (by industry), japan_travel_guide (by destination)

API Endpoints

Memory

Method

Endpoint

Description

POST

/api/v1/memory/episodes

Store episode (auto_extract=true for auto fact extraction)

POST

/api/v1/memory/recall

Semantic search across episodes

GET

/api/v1/memory/facts

List structured facts

GET

/api/v1/memory/context

Session context summary

POST

/api/v1/memory/extract

Extract facts from text (store=true to persist)

Regulation & Compliance

Method

Endpoint

Description

POST

/api/v1/regulation/check

Check regulations (10 industries + tourist)

GET

/api/v1/regulation/industries

List all regulated industries

GET

/api/v1/regulation/tourist

Tourist regulation categories

Business Intelligence

Method

Endpoint

Description

POST

/api/v1/protocol/check

Search business protocols

GET

/api/v1/protocol/list

List all protocols

POST

/api/v1/calendar/check

Search business calendar

GET

/api/v1/calendar/list

List calendar categories

POST

/api/v1/regional/check

Search regional differences

GET

/api/v1/regional/list

List regional categories

POST

/api/v1/organization/check

Search organizational structures

GET

/api/v1/organization/list

List organization categories

Market Entry

Method

Endpoint

Description

POST

/api/v1/foreign-entry/check

Foreign market entry guides

GET

/api/v1/foreign-entry/list

List entry categories (6 total)

Lifestyle & Culture

Method

Endpoint

Description

POST

/api/v1/travel/search

Travel intelligence

POST

/api/v1/entertainment/search

Entertainment & pop culture

POST

/api/v1/daily-life/search

Daily life knowledge

POST

/api/v1/language/search

Japanese language

POST

/api/v1/food/search

Food culture

POST

/api/v1/disaster/search

Disaster & safety

POST

/api/v1/healthcare/search

Healthcare system

POST

/api/v1/education/search

Education system

POST

/api/v1/real-estate/search

Real estate

POST

/api/v1/tax/search

Tax system

POST

/api/v1/banking/search

Banking & finance

POST

/api/v1/visa/search

Visa & immigration

Cross-Domain

Method

Endpoint

Description

POST

/api/v1/search

Search all 20 domains simultaneously


Data Quality

All knowledge entries include:

  • source_url — Link to authoritative source (government websites, official organizations)

  • last_verified — Date of last verification

  • confidence — Verification status (verified / estimated)

  • version — Entry version with changelog

Sources include: 厚生労働省 (MHLW), 国税庁 (NTA), 法務省 (MOJ), 国土交通省 (MLIT), 経済産業省 (METI), 日本経団連 (Keidanren), JETRO, 入管庁 (ISA).

Tech Stack

Layer

Technology

API

FastAPI (Python)

Memory Store

SQLite + ChromaDB (vector search)

MCP Server

TypeScript (MCP SDK v1.12+)

LLM

Gemini / Claude / GPT (fact extraction)

Hosting

Render (api.edition.sh)

Agent Discovery

Protocol

Endpoint

MCP (Streamable HTTP)

POST https://api.edition.sh/mcp

A2A Agent Card

GET https://api.edition.sh/.well-known/agent.json

MCP Server Card

GET https://api.edition.sh/.well-known/mcp/server-card.json

OpenAPI / Swagger

GET https://api.edition.sh/docs

Agent Harness Compatible

EDITION is designed as a Tool Registry / Japan Knowledge Layer for agent harnesses. All 43 tools include MCP annotations (readOnlyHint, destructiveHint, idempotentHint), usage guidelines, and behavioral transparency metadata — enabling harness frameworks to auto-discover, evaluate, and integrate EDITION tools without manual configuration.

Freemium Access

Tier

Domains

Rate Limit

Price

Free

8 core domains

100 req/day

Free

Pro

All 20 domains (incl. tax, banking, healthcare, visa)

10,000 req/day

¥2,980/mo

Enterprise

All domains + priority support

Unlimited

Contact

Anonymous access defaults to Free tier. Register for an API key at POST /api/v1/auth/register.

Registries

Registry

Status

npm

✅ Published (v0.4.0)

Smithery

✅ Listed (43 tools)

Glama

✅ Grade A Coherence

Why Not Mem0 / Letta / Zep?

Those are excellent general-purpose memory tools. But they don't:

  • Parse Japanese keigo levels (丁寧語 / 尊敬語 / 謙譲語)

  • Detect implicit social hierarchy from honorific patterns

  • Score confidence based on Japanese speech patterns (断定 vs 推測 vs 伝聞)

  • Include a Japanese regulatory database with 20 knowledge domains

Japanese business context is structurally different. Agents need purpose-built infrastructure to navigate it.

License

MIT

Available Tools

31 tools
calendar_checkA
Read-onlyIdempotent

日本のビジネスカレンダー情報を検索します。祝日、決算期、贈答シーズン、行政締切、季節性ビジネスの5カテゴリ。

ParametersJSON Schema
NameRequiredDescriptionDefault
queryYes検索クエリ(例: '開業のベストタイミング', 'GW', '確定申告の締切')

TDQS

A3.8/5.0
Behavior4/5

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

Annotations already indicate read-only, idempotent, and non-destructive behavior. The description adds valuable context by listing the specific categories searched (holidays, financial periods, gift-giving, deadlines, seasonal business), which is beyond the annotations. No contradictions.

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?

The description is a single, clear sentence that immediately states the tool's purpose and lists the categories. No unnecessary words or information.

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

Completeness3/5

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

The description explains what is searched but does not specify the output format or what exactly is returned. Given no output schema, the agent might lack information about the result structure. However, the clear categories partially compensate.

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?

With 100% schema description coverage, baseline is 3. The description adds meaning by specifying the five categories, which helps the agent formulate appropriate queries beyond the examples provided in the schema.

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 description clearly states the tool searches Japanese business calendar information across five specific categories. The verb 'search' and resource 'calendar information' are explicit. However, it does not differentiate itself from sibling tool 'calendar_list' which might list calendars instead of searching.

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?

The description provides context for usage by listing the five categories, implying search scenarios. However, it does not explicitly state when to use this tool versus alternatives like 'calendar_list' or other search tools, nor does it provide exclusions or prerequisites.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

calendar_listA
Read-onlyIdempotent

日本のビジネスカレンダーの全カテゴリ一覧を取得します。

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.7/5.0
Behavior3/5

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

Annotations already indicate read-only, idempotent, and non-destructive behavior. The description adds no additional behavioral context (e.g., pagination, rate limits), but it does not contradict 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?

The description is a single sentence with no extraneous information. It is front-loaded with the verb and resource, making it concise and efficient.

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

Completeness3/5

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

Given the tool has no parameters and no output schema, the description is sufficient for basic understanding. However, it does not hint at the response structure, which would be helpful for an agent, but is not critical for a simple list tool.

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?

The input schema has no parameters, so schema coverage is trivially 100%. The description adds value by clarifying that the result is a complete list of all categories, providing scope context beyond the empty schema.

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?

The description clearly states the tool retrieves a list of all categories of Japanese business calendars, specifying the verb '取得' (get) and the resource, distinguishing it from siblings like calendar_check or other list tools.

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?

The description provides no guidance on when to use this tool versus alternatives such as calendar_check or travel_list. It lacks both positive and negative usage conditions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

daily_life_listA
Read-onlyIdempotent

日本の日常生活知識のトピック一覧を取得します。

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.5/5.0
Behavior3/5

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

Annotations already provide readOnlyHint, idempotentHint, and destructiveHint, so the description need not repeat them. It adds no additional behavioral context beyond the basic retrieval action, which is adequate but not enriched.

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, clear sentence in Japanese that states the function directly. It is concise and front-loaded, with no unnecessary information.

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 no parameters or output schema, the description sufficiently conveys the tool's purpose. However, it could be more explicit about the scope (e.g., all topics vs. paginated) to fully align with sibling tools expectations.

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?

With zero parameters and 100% schema coverage, the description does not need to elaborate on parameters. The baseline for no-parameter tools is 4, met here.

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 description clearly states it retrieves a list of topics about Japanese daily life knowledge, providing a specific verb and resource. However, it does not differentiate from sibling tools like daily_life_search, missing an opportunity for distinction.

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?

The description offers no guidance on when to use this tool versus alternatives, such as daily_life_search for filtered queries. It lacks any context about prerequisites or appropriateness.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

disaster_listA
Read-onlyIdempotent

日本の災害・安全知識のトピック一覧を取得します。

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.9/5.0
Behavior3/5

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

Annotations already indicate readOnlyHint=true, idempotentHint=true, and destructiveHint=false, covering key behavioral traits. The description adds minimal context (topic list in Japanese) but lacks details on response structure, pagination, or potential errors. With annotations present, the bar is lower; however, the description does not enrich transparency beyond affirming a safe operation.

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?

The description is a single, complete sentence in Japanese, providing all necessary information without extraneous words. It is front-loaded, immediately conveying the tool's function.

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

Completeness3/5

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

Given the tool has no parameters and no output schema, the description adequately states its purpose. However, it omits details about the return format (e.g., list of strings or objects), which would help an agent use the response correctly. Without output schema, the description should compensate, but it does not fully do so.

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?

The tool has zero parameters, and the input schema is empty with 100% coverage. Per instructions, baseline is 4 when no parameters exist. The description adds no parameter details, which is acceptable since there are none to describe.

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?

The description clearly states the tool's purpose: retrieving a list of disaster/safety knowledge topics. The verb '取得する' (get) and the resource '一覧' (list) make the action specific. It distinguishes from sibling tools like disaster_search by focusing on listing topics rather than searching.

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?

The description does not provide explicit when-to-use or when-not-to-use guidance. It implies usage by naming the operation (list), but does not contrast with alternatives like disaster_search. Without this guidance, an agent may not optimally select this tool when search is more appropriate.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

entertainment_listA
Read-onlyIdempotent

日本のエンタメ知識のトピック一覧を取得します。

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.8/5.0
Behavior3/5

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

Annotations already provide readOnlyHint, idempotentHint, destructiveHint. The description adds no further behavioral details (e.g., pagination, language). With rich annotations, the description provides minimal added value.

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, clear sentence with no wasted words. Front-loaded with the verb and resource, efficient for an agent to parse.

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 zero-parameter list-retrieval tool with fully annotated behavioral hints, the description is mostly complete. However, lacking an output schema and not specifying the format or scope of topics slightly reduces completeness.

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?

The tool has zero parameters and schema coverage is 100% (empty). Per rubric, 0 parameters gives a baseline of 4. The description adds no parameter-specific meaning, but none is needed.

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?

The description clearly states the verb '取得' (retrieve) and the resource 'エンタメ知識のトピック一覧' (list of Japanese entertainment knowledge topics). It is specific and distinguishes from sibling 'entertainment_search' which likely searches within topics.

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 guidance on when to use this tool versus alternatives like 'entertainment_search'. The description only states what it does without any context on prerequisites or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

food_listA
Read-onlyIdempotent

日本の食文化知識のトピック一覧を取得します。

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4/5.0
Behavior3/5

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

Annotations already declare readOnlyHint and idempotentHint, so the description's statement of retrieving a list adds no new behavioral context. For a simple list tool with annotations, this is adequate but does not exceed expectations.

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?

The description is a single sentence that is extremely concise and front-loaded. Every word earns its place with no waste or redundancy.

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 the tool has no parameters, no output schema, and a simple action, the description is sufficient. It could optionally specify the return format (e.g., array of strings), but without output schema, current description is adequate.

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?

There are zero parameters, and schema description coverage is 100%. Per guidelines, baseline is 4. The description adds no parameter information because none exist.

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?

The description clearly states a specific verb-resource combination: retrieving a list of topics on Japanese food culture. It distinguishes itself from the sibling 'food_search' tool which presumably searches within this knowledge.

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?

The description does not explicitly state when to use this tool versus alternatives like 'food_search'. While it is implicitly understood for listing topics, lacking explicit guidance reduces clarity for the agent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

foreign_entry_checkB
Read-onlyIdempotent

外国企業・外国人の日本進出に必要な基盤知識を検索します。法人設立、経営管理ビザ、銀行口座開設、物件探し、税務届出、従業員雇用(労働法・解雇規制・社会保険)の6カテゴリ。

ParametersJSON Schema
NameRequiredDescriptionDefault
queryYes検索クエリ(例: '法人設立の手順', 'ビザ取得', '銀行口座開設')

TDQS

B3.2/5.0
Behavior3/5

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

Annotations already declare readOnlyHint, idempotentHint, and destructiveHint, covering safety. The description adds the specific categories of knowledge, which provides behavioral context but no further details like pagination or speed.

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 description is a single concise sentence that front-loads the purpose and lists categories. No extraneous information; efficient for the agent.

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

Completeness3/5

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

For a search tool with one parameter and no output schema, the description provides the search scope (categories) but does not hint at the output format (e.g., list of articles, summaries). This is a gap given the lack of output schema.

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% and the query parameter description includes examples. The tool description does not add additional semantic meaning beyond the schema, so baseline 3 applies.

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 description clearly states it searches for foundational knowledge for foreign entry to Japan, listing 6 specific categories. This provides a clear scope and distinguishes it from sibling tools like foreign_entry_list, though explicit differentiation is absent.

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 guidance on when to use this tool versus alternatives like foreign_entry_list. The description only states what it does, leaving the agent to infer usage context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

foreign_entry_listA
Read-onlyIdempotent

外国企業・外国人の日本進出に関する知識カテゴリの一覧を取得します。

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.1/5.0
Behavior3/5

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

Annotations already declare readOnlyHint and idempotentHint true, making the tool's safe, read-only nature clear. The description adds minimal behavioral context beyond listing, lacking details on authentication or data volume. With strong annotations, the description is adequate but not enhanced.

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?

The description is a single concise Japanese sentence that front-loads the purpose. It contains no redundant information and efficiently conveys the tool's function.

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?

For a simple list retrieval tool with no parameters and no output schema, the description fully explains what the tool returns. No additional context is necessary given the tool's low complexity and the presence of strong annotations.

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?

The tool has zero parameters and schema coverage is 100% by default. The description does not need to add parameter semantics, and it correctly omits them. According to guidelines, baseline for 0 parameters is 4, which is met.

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?

The description clearly states the tool retrieves a list of knowledge categories related to foreign companies and foreign nationals entering Japan, using a specific verb ('取得します') and resource ('知識カテゴリの一覧'). It distinguishes itself from the sibling tool 'foreign_entry_check' which likely provides details rather than a list.

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?

The description implies usage for listing categories, but it does not explicitly state when to use this tool versus alternatives like 'foreign_entry_check' or other category list tools. No exclusions or context are provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

language_listB
Read-onlyIdempotent

日本語知識のトピック一覧を取得します。

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.2/5.0
Behavior2/5

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

Annotations already declare readOnlyHint, idempotentHint, and destructiveHint, so the description adds no behavioral context. It does not mention pagination, data source, or any constraints beyond the 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 sentence conveys the core purpose without extraneous words. Perfectly concise for a zero-parameter list tool.

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

Completeness3/5

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

For a simple list tool with no parameters and no output schema, the description is minimally adequate. It could clarify what 'topics' refers to and whether the list is exhaustive or preview-sized.

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?

The tool has no parameters, and the description does not need to elaborate on them. Schema description coverage is 100%, meeting baseline expectations.

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 description clearly states the tool retrieves a list of Japanese knowledge topics, which aligns with the tool name 'language_list'. It distinguishes from sibling 'language_search' by specifying 'list'. However, 'topics' could be more specific.

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?

The description provides no guidance on when to use this tool versus alternatives like language_search or other list tools. It only states what it does, not the conditions for its use.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_contextA
Read-onlyIdempotent

現在のセッション状態(有効な事実・合意事項のサマリー)を取得します。エージェントのプロンプトに注入して文脈を維持するために使います。

ParametersJSON Schema
NameRequiredDescriptionDefault
session_idNoセッションID(省略で全体)

TDQS

A4/5.0
Behavior4/5

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

Annotations already indicate readOnlyHint and idempotentHint. The description adds context by specifying what data is retrieved (session state summary), which is valuable 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?

Two concise sentences in Japanese, front-loaded with the tool's action first, then use case. Every sentence adds value with no redundancy.

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?

The description explains the return value (summary of facts/agreements) and its intended use. It lacks explicit differentiation from sibling memory tools, but overall adequate for a simple retrieval tool with no output schema.

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% and the description does not add extra meaning to the optional session_id parameter. Baseline of 3 is appropriate as the schema already documents it fully.

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 description clearly states it retrieves the current session state summary of facts and agreements. However, it does not explicitly differentiate from sibling tools like memory_facts or memory_recall, though the resource is distinct.

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?

The description explicitly mentions using it to inject into the agent's prompt for maintaining context, providing clear usage context. It does not mention when not to use or specify alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_extractA
Idempotent

テキストからファクト(主語→述語→目的語の三つ組)を自動抽出します。日本語の敬語・主語省略・社会的階層を分析して構造化します。store=trueにすると抽出結果をメモリに永続保存します(書き込み発生)。store=false(デフォルト)なら読み取り専用で、保存せずに抽出結果のみ返します。memory_storeとの違い: memory_storeはエピソード全体を保存、memory_extractはテキストからファクトのみを抽出。

ParametersJSON Schema
NameRequiredDescriptionDefault
textYesファクトを抽出するテキスト
storeNo抽出したファクトを永続保存するか(trueで書き込み発生)
context_hintNoコンテキストヒント(例: ビジネスミーティング)

TDQS

A4.4/5.0
Behavior5/5

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

The description explains behavioral traits beyond annotations: store=true causes writes, store=false is read-only. It adds context about Japanese language analysis. No contradiction with annotations (idempotent, not read-only, not destructive).

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 description is reasonably concise, covering purpose, usage, parameter behavior, and sibling differentiation in a single paragraph. It could be more structured but is not excessively long.

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

Completeness3/5

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

The description covers behavioral aspects and parameter semantics well, but lacks information about the output format of extracted facts. No output schema is provided, so the agent must infer the return structure. With moderate complexity, this gap reduces completeness.

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 100% with clear descriptions. The description adds value by explaining the behavioral difference of the 'store' parameter and the optional 'context_hint' usage, enhancing the schema information.

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?

The description clearly states the tool extracts facts (subject-predicate-object triples) from text, with specific verb 'extract' and resource 'facts'. It distinguishes from sibling memory_store by contrasting episode storage vs fact extraction.

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?

The description provides explicit guidance on when to use store=true vs store=false, and contrasts memory_extract with memory_store. It implies usage context (Japanese text analysis) but doesn't explicitly state when not to use it or list alternative tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_factsA
Read-onlyIdempotent

現在有効なファクト(構造化された事実)の一覧を取得します。ファクトは「主語→述語→目的語」の三つ組で、確度と有効期限を持ちます。

ParametersJSON Schema
NameRequiredDescriptionDefault
valid_onlyNo有効なファクトのみ取得するか

TDQS

A3.6/5.0
Behavior4/5

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

Annotations indicate read-only and idempotent. The description adds behavioral context: facts are triples with confidence and expiration dates, and the default is to retrieve only valid facts. This adds value beyond the 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?

The description is a single, front-loaded sentence that efficiently conveys the tool's purpose and key details. No wasted words.

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 simple list tool with good annotations, the description is nearly complete. It covers the data structure and validity filtering. It could mention ordering or page limits, but is acceptable as is.

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 describes the single boolean parameter 'valid_only' with default true and a description. The tool description does not add any additional meaning or context for the parameter, so baseline score applies given 100% schema coverage.

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 description clearly states it retrieves a list of currently valid structured facts with subject-predicate-object triples, distinguishing it from siblings like memory_store (store facts) and memory_recall (retrieve by query). However, it does not explicitly differentiate from similar list tools.

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?

The description provides no guidance on when to use this tool versus alternatives. No mention of prerequisites, exclusions, or context for choosing memory_facts over siblings like memory_recall or memory_context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_recallA
Read-onlyIdempotent

過去の記憶をセマンティック検索で呼び出します。「前回の会議で○○部長が仰った件」のような曖昧な日本語クエリにも対応します。

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNo取得件数
queryYes検索クエリ(日本語/英語対応)

TDQS

A4/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, and destructiveHint, covering safety. The description adds that it performs semantic search and supports ambiguous Japanese queries, providing useful behavioral context beyond the annotations. However, it does not detail result format or potential limitations.

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?

Single sentence is maximally concise and front-loaded with the tool's purpose. Every word is necessary, no redundancy.

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 no output schema, the description could mention return format or ordering, but the tool is simple. The semantic search and language support are covered well. Slightly incomplete for a fully self-contained description, but adequate for the low complexity tool.

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 baseline is 3. The description does not add significant meaning beyond what parameter descriptions already provide (query supports Japanese/English, limit is count). The phrase 'ambiguous Japanese queries' is already implied by the query description.

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?

Description clearly states the tool recalls past memories via semantic search, and specifically mentions handling ambiguous Japanese queries. It differentiates from sibling tools like memory_store (store) and memory_facts (factual recall) by focusing on semantic retrieval with query flexibility.

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?

The description implies use for ambiguous queries but does not explicitly state when to use this over alternatives like memory_facts or memory_context. No comparison or exclusion conditions provided, leaving the agent to infer usage context from the tool name and description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

memory_storeA

会話やイベントのエピソードを永続記憶に保存します。日本語の文脈(敬語レベル、主語省略、暗黙の了解)も構造化して保持します。auto_extract=trueにすると、テキストからファクト(主語→述語→目的語の三つ組)を自動抽出します。

ParametersJSON Schema
NameRequiredDescriptionDefault
roleNo発話者の役割user
contentYes保存する内容(日本語/英語対応)
session_idNoセッション識別子
auto_extractNoLLMでファクトを自動抽出するか

TDQS

A4.2/5.0
Behavior4/5

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

Annotations indicate readOnlyHint=false and destructiveHint=false. Description adds context about structuring Japanese context and auto-extracting facts via LLM, which is valuable beyond annotations. It does not contradict annotations, but could clarify overwrite or idempotency behavior.

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?

The description is two sentences with no extraneous words. It front-loads the primary purpose and then details the key feature (auto_extract), achieving high efficiency.

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 4 params with full schema coverage and no output schema, the description covers the main use case and a key feature. It does not specify whether storage is append-only or updateable, but this is acceptable for the complexity level.

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 baseline is 3. The description adds minimal parameter-specific info beyond what the schema provides, mentioning that auto_extract triggers LLM fact extraction, but this is already implied in the schema description.

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?

Description explicitly states the tool saves conversation or event episodes to permanent memory, with specific mention of handling Japanese context. This clearly distinguishes it from sibling tools like memory_recall (retrieval) and memory_extract (extraction).

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?

Description clearly indicates when to use the tool: for storing episodes with Japanese context. However, it does not explicitly mention when not to use it or provide direct comparisons with alternative memory tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

organization_checkA
Read-onlyIdempotent

日本の組織構造・商慣行を検索します。役職体系、系列、支払慣行、契約慣行、業界団体。

ParametersJSON Schema
NameRequiredDescriptionDefault
queryYes検索クエリ(例: '支払いサイトの標準', '契約書の印鑑', '部長と課長の違い')

TDQS

A3.7/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent, and non-destructive behavior. The description adds valuable context about the specific domain (Japanese organizations and practices), which enhances transparency beyond the annotations.

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?

Single clear sentence front-loading the action, followed by examples. Efficient with no wasted words, though slightly informal due to examples in list format.

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 one parameter and no output schema, the description adequately explains what the tool searches. It lists concrete sub-topics, making usage clear. Lacks detail on return format, but not critical for a simple search.

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 covers 100% of the single parameter with examples. The tool description does not add new meaning beyond the schema, so baseline score 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?

The description explicitly states the tool searches Japanese organizational structure and business practices, with clear examples like job titles, payments, contracts, and industry groups. This differentiates it from sibling tools like organization_list.

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 guidance on when to use versus alternatives (e.g., organization_list, calendar_check). The description implies usage for Japanese business customs but fails to specify exclusions or comparison to other search tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

organization_listA
Read-onlyIdempotent

日本の組織構造・商慣行の全カテゴリ一覧を取得します。

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.8/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true, idempotentHint=true, and destructiveHint=false. The description adds domain context but does not disclose additional behavioral traits (e.g., rate limits, pagination, or data freshness). It neither contradicts annotations nor adds significant behavioral insight beyond what annotations provide.

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?

The description is a single sentence with no wasted words. It effectively conveys the tool's purpose.

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 simple list tool with no parameters and no output schema, the description is largely adequate. However, it could hint at the output format (e.g., list of strings) to improve completeness.

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?

With zero parameters, the description does not need to explain parameters. Schema description coverage is trivially 100%. The baseline for 0 parameters is 4, and the description adds no ambiguity.

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?

The description clearly states the verb (取得する: retrieve) and the resource (全カテゴリ一覧: all categories list) for Japanese organizational structure and business practices. It distinguishes itself from sibling tools by specifying its domain (e.g., vs calendar_list, daily_life_list).

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?

The description provides no guidance on when to use this tool versus alternatives (e.g., when to use organization_list vs organization_check or other list tools). It lacks explicit when-to-use or when-not-to-use instructions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

protocol_checkA
Read-onlyIdempotent

日本のビジネスプロトコル(根回し、稟議、報連相、名刺交換、席順、贈答)を検索します。

ParametersJSON Schema
NameRequiredDescriptionDefault
queryYes検索クエリ(例: '名刺交換の作法', '根回し')

TDQS

A4.1/5.0
Behavior4/5

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

Annotations already declare readOnlyHint and idempotentHint, so the read-only nature is clear. The description adds examples of protocols covered, providing context beyond annotations. No contradictions.

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?

The description is a single, well-structured sentence with essential information front-loaded. No redundant text.

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?

For a simple search tool with one parameter, annotations, and no output schema, the description adequately covers purpose and scope. Agent can correctly select and invoke it.

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% for the single required parameter 'query', including examples in the schema. The description adds no additional meaning or constraints beyond what the schema provides.

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?

The description clearly states the tool searches for Japanese business protocols, listing examples like nemawashi and meishi exchange. This verb+resource construction distinguishes it from sibling tools such as protocol_list (likely list-oriented) and generic search.

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?

The description implies usage for searching Japanese business protocols but does not explicitly state when not to use or provide alternatives. Sibling tools like protocol_list or general search exist, but no comparison is made.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

protocol_listA
Read-onlyIdempotent

日本のビジネスプロトコルの一覧を取得します。

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.8/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. The description adds that it retrieves a list, which is consistent but not extra behavioral detail beyond what annotations provide.

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, clear, and concise sentence that efficiently conveys the tool's purpose with no unnecessary words.

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 parameterless list retrieval tool with good annotations, the description is adequate. However, it could specify what the list contains (e.g., names, codes) for completeness.

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?

No parameters exist, so the description adds no parameter info. Schema coverage is 100%, so baseline is 4.

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?

The description clearly states it retrieves a list of Japanese business protocols, using a specific verb (取得) and resource (日本のビジネスプロトコル). It distinguishes from sibling tools like protocol_check and other list tools.

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?

The description provides no guidance on when to use this tool versus alternatives, nor any when-not-to-use or prerequisite information.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

regional_checkA
Read-onlyIdempotent

日本の地域別ビジネス情報を検索します。主要都市の特性、自治体の助成金・補助金、地域条例、商慣習の違い。

ParametersJSON Schema
NameRequiredDescriptionDefault
queryYes検索クエリ(例: '大阪の飲食店条例', '東京のスタートアップ助成金')

TDQS

A4.3/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, so the safety profile is clear. The description adds that it searches regional business info but does not disclose additional behavioral traits beyond what annotations provide. This is adequate but not enhanced.

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?

The description is a single, well-structured sentence that effectively communicates the tool's purpose. It is front-loaded with the main action and uses no extraneous words.

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?

Given the tool's simplicity (one parameter, no output schema, annotations present), the description provides all necessary context for an AI agent to understand what the tool does and how to use it. No additional details are needed.

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?

The schema has one parameter 'query' with 100% coverage. The description adds meaning by providing example queries in Japanese, clarifying the expected format and content beyond the schema's bare description.

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?

The description specifies it searches for Japanese regional business information including city characteristics, subsidies, ordinances, and customs. The name 'regional_check' clearly indicates a check/query function, and it distinguishes from sibling tools like 'regional_list' (which likely lists regions) and 'regulation_check' (more specific to regulations).

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?

The description provides example queries like '大阪の飲食店条例' and '東京のスタートアップ助成金', giving clear context on when to use the tool. However, it does not explicitly state when not to use it or mention alternatives among the many sibling tools, leaving some ambiguity.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

regional_listA
Read-onlyIdempotent

日本の地域別ビジネス情報の全カテゴリ一覧を取得します。

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.1/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. The description only restates the operation without adding behavioral context (e.g., response structure, pagination).

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?

Single sentence, front-loaded with action and resource, no extraneous information. Every word earns its place.

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?

Given the tool has zero parameters and no output schema, the description sufficiently explains what it returns (full category list). No additional context is needed for a simple read-only list operation.

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?

No parameters exist, so schema coverage is 100%. The description adds value by confirming the output is a list of all categories, which compensates for the lack of an output schema.

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?

The description clearly states it retrieves a list of all categories of regional business information for Japan, specifying both the action (list all) and the resource (regional business info categories). It implicitly distinguishes from siblings like 'regional_check'.

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?

No explicit guidance on when to use this tool versus alternatives like 'regional_search' or 'regional_check'. The context of sibling tools implies it is for full list retrieval, but no direct comparison or conditions are given.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

regulation_checkA
Read-onlyIdempotent

特定のビジネスアクションに必要な日本の規制・許認可情報を回答します。10業種の詳細データベース + 訪日旅行者向け規制に対応。

ParametersJSON Schema
NameRequiredDescriptionDefault
actionYes実行しようとしているアクション(例: 東京でレストランを開業する)
industryNo業種(省略可、自動判定)
entity_typeNo主体の種別foreign_company

TDQS

A3.5/5.0
Behavior3/5

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

Annotations already provide readOnlyHint=true, idempotentHint=true, and destructiveHint=false, establishing the tool as safe and non-destructive. The description adds context about database coverage (10 industries + tourists) but no further behavioral traits (e.g., response format, rate limits). With annotations present, the description offers moderate additional value.

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 description is a single sentence that efficiently conveys the core purpose. It is front-loaded and compact, but could be slightly more structured (e.g., bullet points) to improve scanability. Still, every word earns its place.

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?

The tool has no output schema, so the description should explain return values or response structure, which it does not. It only states the tool 'answers' about regulations. Given medium complexity (3 parameters, no nested objects), this is a significant gap. The description also does not clarify how it relates to sibling regulation tools.

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%, so the input schema already documents all three parameters. The description mentions '10 industries' which relates to the industry parameter, but adds no deeper semantics (e.g., format constraints or examples) beyond what the schema provides. Baseline 3 is appropriate.

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?

The description clearly states the tool's function: 'Answers about Japanese regulations and licenses required for specific business actions.' It specifies the verb (回答する), resource (規制・許認可情報), and scope (10 industries + tourists), effectively distinguishing it from sibling tools like regulation_industries and regulation_tourist which likely focus on listing or specific subdomains.

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?

The description implies usage for 'specific business actions' but does not explicitly contrast with sibling tools (e.g., when to use this vs. regulation_industries) or provide when-not-to-use guidance. The lack of explicit alternatives or exclusions limits its utility for tool selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

regulation_industriesA
Read-onlyIdempotent

日本の規制データベースに登録されている業種の一覧を取得します。

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.7/5.0
Behavior3/5

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

Annotations already declare readOnlyHint, idempotentHint, and destructiveHint. The description adds context about the database source but does not disclose additional behavioral traits like rate limits or caching.

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?

The description is a single, concise sentence in Japanese that front-loads the purpose. Every word is necessary and there is no redundant information.

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

Completeness3/5

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

Given the simple nature (no parameters, no output schema), the description is adequate but lacks details about the return format or structure, which could help agents interpret the output.

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?

The tool has zero parameters, so the baseline is 4. The description does not need to add parameter details, and the schema coverage is effectively 100%.

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?

Description clearly states it retrieves a list of industries from the Japanese regulation database. Verb and resource are specific, and it distinguishes from sibling tools like regulation_check and regulation_tourist.

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 guidance is provided on when to use this tool or how it compares to alternatives. The description only states functionality without contextual usage tips.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

regulation_touristA
Read-onlyIdempotent

訪日旅行者向けの規制・マナー情報のカテゴリ一覧を取得します。ビザ、免税、交通、宿泊、医療、マナーの6カテゴリ。

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.1/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true and idempotentHint=true, so the description's statement of 'retrieves' aligns. No additional behavioral details are provided, but the tool's safety is clearly covered by 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?

The description is a single sentence followed by a listing of categories, front-loaded with the purpose. Every word is necessary, no redundancy.

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?

For a zero-parameter list tool, the description sufficiently explains what is returned (the six categories). No output schema exists, but the description provides adequate completeness for the agent to understand the tool's value.

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?

With zero parameters, the baseline is 4 per rules. The description adds meaning by specifying the tool's output (list of 6 categories), compensating for the lack of navigation context.

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?

The description clearly states the tool retrieves a list of categories of regulations and manners for visitors to Japan, and lists all six categories. This distinguishes it from sibling tools like 'regulation_check' which likely provide specific details.

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?

The description does not explicitly mention when to use this tool versus alternatives like 'regulation_check' or 'protocol_list'. However, the tool's simplicity (no parameters) implies it is for obtaining the category list, but guidance on selection is absent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

travel_listA
Read-onlyIdempotent

日本の旅行知識のトピック一覧を取得します。

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4/5.0
Behavior3/5

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

Annotations already indicate readOnlyHint, idempotentHint, and destructiveHint. The description adds no additional behavioral context beyond stating it retrieves a list, which is consistent with annotations but provides no extra detail.

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?

The description is a single, well-structured sentence that conveys the purpose without any extraneous words. It is concise and front-loaded with the key verb and object.

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 simple, parameterless list retrieval tool, the description provides the essential purpose. It is complete enough given the annotations and lack of output schema, though it could mention that the list is comprehensive or indicate the response format.

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?

There are no parameters, and schema coverage is 100%. According to guidelines, with 0 parameters the baseline is 4. The description does not need to add parameter semantics.

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?

The description clearly states the action ('取得します' - retrieves) and the resource ('日本の旅行知識のトピック一覧' - list of Japanese travel knowledge topics), distinguishing it from sibling tools like travel_search which likely searches rather than lists all topics.

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?

The description provides no explicit guidance on when to use this tool versus alternatives. The context implies it is for obtaining a full listing, but no exclusions or conditions are stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev0.6.1
    • Changedmemory_extract1 field changed
      • changedInput schema / properties / store / description
        Previous value: -"抽出したファクトを永続保存するか"New value: +"抽出したファクトを永続保存するか(trueで書き込み発生)"
  2. 31 tool updatesv0.6.0
    • First observedcalendar_check
    • First observedcalendar_list
    • First observeddaily_life_list
    • First observeddaily_life_search
    • First observeddisaster_list
    • First observeddisaster_search
    • First observedentertainment_list
    • First observedentertainment_search
    • First observedfood_list
    • First observedfood_search
    • First observedforeign_entry_check
    • First observedforeign_entry_list
    • First observedlanguage_list
    • First observedlanguage_search
    • First observedmemory_context
    • First observedmemory_extract
    • First observedmemory_facts
    • First observedmemory_recall
    • First observedmemory_store
    • First observedorganization_check
    • First observedorganization_list
    • First observedprotocol_check
    • First observedprotocol_list
    • First observedregional_check
    • First observedregional_list
    • First observedregulation_check
    • First observedregulation_industries
    • First observedregulation_tourist
    • First observedsearch
    • First observedtravel_list
    • First observedtravel_search

TDQS

A3.7/5.0

Scored across 31 tools

Disambiguation5/5

Each tool targets a distinct domain or function, with clear boundaries between categories like calendar, disaster, food, and memory. Even the general search tool is explicitly for cross-domain queries, avoiding ambiguity with domain-specific searches.

Naming Consistency4/5

Most tools follow a consistent domain_action pattern (e.g., calendar_check, daily_life_search). Memory tools use a different but internally consistent memory_ prefix, and the single 'search' tool stands out. Overall, the pattern is mostly predictable.

Tool Count3/5

With 31 tools, the server is on the heavier side for a single platform. While the breadth of Japanese business and cultural knowledge justifies many tools, the count still feels slightly bloated, especially with many list/search pairs.

Completeness4/5

The tool surface covers a wide range of domains relevant to Japanese business and culture, including memory management. However, it lacks update or delete operations for any domain, limiting write functionality beyond memory storage.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    Provides Japanese UX conventions as an MCP server to help AI generate correct Japanese UI elements like proper name order, furigana, phone formats, and polite language. It includes tools for form generation, validation, keigo suggestions, and cultural adaptation for developers building Japanese-facing products.
    6
    45
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Torify gives AI agents the Japanese locale primitives that standard libraries lack — imperial era date conversion (wareki), qualified invoice number validation with NTA registry lookup, corporate number lookup (法人番号), postal code resolution, name romanization (Hepburn), and kanji-to-kana conversion via Yahoo! JLP. 31 endpoints total. No authentication required for MCP. Pay-per-call $0.02/call via
    MIT