Edition Intelligence Platform
The Edition Intelligence Platform provides AI agents with structured, verified knowledge of Japanese business, culture, and regulations through 43 tools across 20 domains.
Memory & Knowledge Management
Store and recall conversational episodes with Japanese-aware keigo analysis, social hierarchy detection, and confidence scoring
Extract structured subject→predicate→object facts from Japanese text
Retrieve aggregated session context to inject into agent prompts
Regulation & Compliance
Check regulatory requirements across 10 industries (food, real estate, finance, healthcare, construction, education, transport, retail, IT, manufacturing)
Access tourist compliance info (visa, tax-free shopping, transport, manners)
Log compliance events and generate audit reports (AI Act readiness)
Business Intelligence
Look up business protocols: nemawashi, ringi, hourensou, meishi exchange, seating order
Access the Japanese business calendar: fiscal year cycles, Golden Week, Obon, gift seasons, administrative deadlines
Explore regional business differences (e.g., Tokyo vs. Osaka negotiation styles, local subsidies)
Understand organizational structures: keiretsu networks, corporate hierarchy, payment customs (net-60), contract practices
Foreign Market Entry
Step-by-step guidance for company incorporation (KK/GK), management visas, bank account setup, real estate, tax registration, and hiring employees
Travel, Lifestyle & Culture
Travel: shinkansen, IC cards, ryokan/onsen etiquette, tipping customs
Entertainment: oshi-katsu fan culture, anime pilgrimages, seasonal festivals
Daily life: garbage sorting, postal/address systems, utilities, healthcare navigation
Language: keigo honorific systems, counter words, business Japanese templates
Food: dining etiquette, restaurant systems, dietary restrictions (halal, vegetarian, allergies)
Safety & Disaster Preparedness
Earthquake shindo scale, EEW alerts, typhoon warning levels, emergency contacts, and disaster checklists
Cross-Domain Search
A single query searches all 20 domains simultaneously for comprehensive answers
Access Tiers: Free tier covers 8 core domains (100 req/day); Pro ($2,980/mo) unlocks all 20 domains with full data quality guarantees (authoritative sources, verification dates, confidence scores, versioning).
EDITION Intelligence Platform
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 |
| Three-layer persistent memory (Episode/Fact/Context) with Japanese keigo analysis and social hierarchy detection |
2 | Regulation |
| 10 industries (food, real estate, finance, healthcare, construction, education, transport, retail, IT, manufacturing) + tourist compliance |
3 | Protocol |
| Nemawashi, ringi, hourensou, meishi koukan, sekijun, zoutou — step-by-step procedures with cultural context |
4 | Calendar |
| Fiscal year (April start), Golden Week, Obon, year-end, gift seasons, administrative deadlines |
5 | Regional |
| Tokyo vs Osaka negotiation styles, local subsidies, prefectural regulations, dialect considerations |
6 | Organization |
| Keiretsu networks, corporate hierarchy (bucho/kacho), payment customs (net-60), contract practices |
7 | Foreign Entry |
| 6 categories: company incorporation (KK/GK), management visa, bank account, real estate, tax registration, employee hiring |
8 | Travel |
| Shinkansen, IC cards, ryokan etiquette, onsen rules, restaurant ordering, tipping customs |
9 | Entertainment |
| Oshi-katsu fan culture, anime pilgrimage, live event manners, seasonal festivals |
10 | Daily Life |
| Postal/address systems, garbage sorting by municipality, utilities (electricity/gas/water/NHK), healthcare navigation |
11 | Language |
| Keigo honorific system, counter words (josushi), name/address structure, business Japanese templates |
12 | Food Culture |
| Dining etiquette, cuisine classification, restaurant navigation (shokkenki, izakaya, sushi counter), dietary restrictions (halal, vegetarian, allergies) |
13 | Disaster & Safety |
| Earthquake shindo scale & EEW, typhoon warning levels, emergency contacts (110/119/118), preparedness checklists |
14 | Healthcare |
| National health insurance, hospital navigation, prescription system, medical Japanese terminology |
15 | Education |
| School system (6-3-3-4), entrance exams, international schools, university admission for foreigners |
16 | Real Estate |
| Rental process (shikikin/reikin/hoshoukin), property types, foreigner-friendly agencies, contract terms |
17 | Tax |
| Income tax, consumption tax, withholding, year-end adjustment, tax filing for foreigners and businesses |
18 | Banking & Finance |
| Bank account types, remittance, fintech services, corporate banking, payment systems |
19 | Visa & Immigration |
| Visa categories, status of residence, renewal procedures, permanent residency, naturalization |
20 | Cross-Domain |
| 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 |
regulation, foreign_entry, organization | Company incorporation, visa, banking | |
protocol, calendar, regional, language | Meetings, nemawashi, business Japanese | |
travel, food, entertainment, disaster | Tourist assistance, dining, safety | |
daily_life, food, language | Utilities, garbage, healthcare | |
protocol, organization, language | Implicit communication, hierarchy | |
disaster, regulation | Earthquake response, regulatory 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 reportTool | Purpose |
| Create immutable, timestamped audit record after any regulatory check |
| Generate governance reports (summary / detailed / JSON) from audit trail |
Designed for EU AI Act (Aug 2026) and upcoming Japan AI governance compliance.
Quick Start
Option 1: npx (Recommended for Claude Desktop / Cursor)
npx -y edition-mcp-serverAdd 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/editionOption 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: presentThree-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 ( |
Resources | 2 |
|
Prompts | 2 |
|
API Endpoints
Memory
Method | Endpoint | Description |
POST |
| Store episode ( |
POST |
| Semantic search across episodes |
GET |
| List structured facts |
GET |
| Session context summary |
POST |
| Extract facts from text ( |
Regulation & Compliance
Method | Endpoint | Description |
POST |
| Check regulations (10 industries + tourist) |
GET |
| List all regulated industries |
GET |
| Tourist regulation categories |
Business Intelligence
Method | Endpoint | Description |
POST |
| Search business protocols |
GET |
| List all protocols |
POST |
| Search business calendar |
GET |
| List calendar categories |
POST |
| Search regional differences |
GET |
| List regional categories |
POST |
| Search organizational structures |
GET |
| List organization categories |
Market Entry
Method | Endpoint | Description |
POST |
| Foreign market entry guides |
GET |
| List entry categories (6 total) |
Lifestyle & Culture
Method | Endpoint | Description |
POST |
| Travel intelligence |
POST |
| Entertainment & pop culture |
POST |
| Daily life knowledge |
POST |
| Japanese language |
POST |
| Food culture |
POST |
| Disaster & safety |
POST |
| Healthcare system |
POST |
| Education system |
POST |
| Real estate |
POST |
| Tax system |
POST |
| Banking & finance |
POST |
| Visa & immigration |
Cross-Domain
Method | Endpoint | Description |
POST |
| 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 verificationconfidence— 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) |
|
A2A Agent Card |
|
MCP Server Card |
|
OpenAPI / Swagger |
|
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
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 toolscalendar_checkARead-onlyIdempotent
日本のビジネスカレンダー情報を検索します。祝日、決算期、贈答シーズン、行政締切、季節性ビジネスの5カテゴリ。
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | 検索クエリ(例: '開業のベストタイミング', 'GW', '確定申告の締切') |
TDQS
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.
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.
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.
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.
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.
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_listARead-onlyIdempotent
日本のビジネスカレンダーの全カテゴリ一覧を取得します。
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
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.
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.
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.
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.
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.
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_listARead-onlyIdempotent
日本の日常生活知識のトピック一覧を取得します。
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
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.
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.
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.
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.
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.
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.
daily_life_searchARead-onlyIdempotent
日本の日常生活に関する知識を検索します。住所・郵便システム、ゴミ分別ルール、公共料金(電気・ガス・水道・NHK)、医療・健康保険制度。外国人が日本で生活するために必要な実用知識。
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | 検索クエリ(例: 'ゴミの分別方法', '健康保険の加入', '引っ越しの手続き') |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and idempotentHint=true, so the agent knows it's a safe, idempotent read operation. The description adds domain context but no additional behavioral traits beyond what the 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two sentences, front-loading the action and listing topics concisely. Every sentence adds value without redundancy, making it efficient for an agent to parse.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the low complexity (one parameter, no nested objects), the description adequately covers the domain and parameter. However, missing an indication of return format (e.g., text or structured data) slightly reduces completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The single parameter 'query' has a schema description with concrete examples (e.g., 'ゴミの分別方法'), and the tool description reinforces the domain with example topics. This fully clarifies the parameter's intent and usage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly specifies the tool's function: searching for practical knowledge about Japanese daily life, covering specific topics like garbage sorting and health insurance. This distinguishes it from sibling search tools like disaster_search or food_search by its domain.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description lists covered topics but does not explicitly state when to use this tool over alternatives or provide exclusions. While the domain is clear, there is no comparative guidance for the agent to decide between this and other search tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
disaster_listARead-onlyIdempotent
日本の災害・安全知識のトピック一覧を取得します。
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
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.
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.
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.
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.
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.
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.
disaster_searchARead-onlyIdempotent
日本の災害・安全に関する知識を検索します。地震(震度スケール・緊急地震速報・耐震基準)、台風・水害(警戒レベル・計画運休)、緊急連絡先(110/119/多言語対応)、防災準備(防災バッグ・ハザードマップ・避難所マナー)。
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | 検索クエリ(例: '地震が来たらどうする', '緊急連絡先', '防災バッグの中身') |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, idempotentHint=true, destructiveHint=false. Description adds context about the knowledge domain and example topics, but does not disclose other behavioral traits (e.g., auth needs, rate limits, or handling of empty results).
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence with parenthetical examples is extremely concise and front-loaded. Every part of the description adds value; no wasted words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
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 and no output schema, the description adequately covers purpose and examples. Could mention return format (e.g., list of relevant passages), but not essential.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% (the only parameter 'query' has examples). Description reinforces the query's expected content (disaster/safety topics) but adds minimal value beyond the schema's own examples.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states the tool searches knowledge about Japanese disasters and safety, with specific examples (earthquake, typhoon, emergency contacts, disaster preparedness). This distinguishes it from siblings like disaster_list (which likely lists items) and general search.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Description implies usage for disaster/safety queries in Japanese context, but does not explicitly state when to use this tool versus alternatives like disaster_list or search. No when-not guidance is provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
entertainment_listARead-onlyIdempotent
日本のエンタメ知識のトピック一覧を取得します。
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
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.
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.
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.
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.
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.
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.
entertainment_searchARead-onlyIdempotent
日本のエンターテインメント・ポップカルチャーに関する知識を検索します。推し活(チケット取得・転売法)、アニメ聖地巡礼、ライブマナー(ペンライト・コール)、季節イベント(花見・花火・初詣)。
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | 検索クエリ(例: '推し活のチケット購入', 'コミケの参加方法', '花見のマナー') |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, idempotentHint=true, and destructiveHint=false, covering safety and idempotency. The description adds domain-specific context but no additional behavioral traits (e.g., response format, rate limits). Thus it provides moderate added value beyond annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence with examples, no fluff, and front-loaded with the purpose. Every part earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the simplicity (1 param, no output schema, annotations present), the description covers the domain and query format. It could mention when to use over sibling 'search' but is otherwise complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% with a single parameter 'query' well-described with examples. The tool description reiterates the domain but does not add semantic detail beyond the schema. Baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool searches for knowledge about Japanese entertainment and pop culture, with specific examples (oshikatsu, anime pilgrimage, live etiquette, seasonal events). It uses a specific verb ('検索します') and resource ('知識'), distinguishing it from siblings like 'entertainment_list' and general 'search'.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage when needing knowledge on Japanese entertainment/pop culture topics, but does not explicitly state when not to use or mention alternatives like the general 'search' tool. The context is clear but lacks explicit exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
food_listARead-onlyIdempotent
日本の食文化知識のトピック一覧を取得します。
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
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.
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.
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.
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.
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.
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.
food_searchARead-onlyIdempotent
日本の食文化に関する知識を検索します。食事マナー(箸のタブー・乾杯・割り勘)、料理分類(懐石・定食・ラーメン・郷土料理)、飲食店ガイド(食券機・居酒屋・回転寿司・おまかせ)、アレルギー・食制限(ハラル・ベジタリアン対応)。
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | 検索クエリ(例: '箸のマナー', 'ハラル対応レストラン', '回転寿司の注文方法') |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and idempotentHint=true; the description adds domain context (Japanese food culture topics) but does not disclose additional behavioral traits (e.g., no mention of pagination, response format, or any constraints beyond the schema).
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, well-structured paragraph in Japanese, front-loaded with the purpose and then listing categories. Every sentence provides distinct information with no redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
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, good annotations, and no output schema, the description sufficiently covers the tool's scope, domain, and example subtopics. No critical information is missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the schema already documents the 'query' parameter with examples. The description repeats the examples implicitly, adding marginal value by grouping them into categories but not adding new semantic meaning beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool searches for knowledge about Japanese food culture, listing specific subtopics (manners, dish categories, restaurant guides, allergies) that distinguish it from siblings like 'food_list' and 'daily_life_search'.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 (e.g., food_list, daily_life_search). The description implies usage for Japanese food queries but lacks when-not-to-use or alternative tool references.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
foreign_entry_checkBRead-onlyIdempotent
外国企業・外国人の日本進出に必要な基盤知識を検索します。法人設立、経営管理ビザ、銀行口座開設、物件探し、税務届出、従業員雇用(労働法・解雇規制・社会保険)の6カテゴリ。
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | 検索クエリ(例: '法人設立の手順', 'ビザ取得', '銀行口座開設') |
TDQS
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.
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.
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.
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.
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.
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_listARead-onlyIdempotent
外国企業・外国人の日本進出に関する知識カテゴリの一覧を取得します。
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
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.
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.
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.
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.
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.
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_listBRead-onlyIdempotent
日本語知識のトピック一覧を取得します。
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
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.
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.
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.
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.
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.
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.
language_searchARead-onlyIdempotent
日本語の構造的知識を検索します。敬語体系(尊敬語・謙譲語・丁寧語)、助数詞(数え方)、名前・住所の構造パターン、ビジネス日本語(電話応対・クッション言葉・メールテンプレート)。
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | 検索クエリ(例: '敬語の使い方', '助数詞の一覧', 'ビジネスメールの書き方') |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already specify readOnly, idempotent, non-destructive. Description adds no extra behavioral details beyond confirming it's a search. No contradiction.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two-sentence description, front-loaded with main action. Every word earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
No output schema, but description adequately covers what the tool searches for. Minor gap: no mention of return format or pagination.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema covers the single 'query' parameter 100%. Description adds value by providing example queries in Japanese, clarifying the types of valid inputs.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description states 'Searches for structural knowledge of Japanese' and lists specific categories (honorifics, counters, names, business Japanese). This clearly differentiates from sibling tools like language_list.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit when-to-use or when-not-to-use guidance. The context of being a search tool versus list tool is implied but not stated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
memory_contextARead-onlyIdempotent
現在のセッション状態(有効な事実・合意事項のサマリー)を取得します。エージェントのプロンプトに注入して文脈を維持するために使います。
| Name | Required | Description | Default |
|---|---|---|---|
| session_id | No | セッションID(省略で全体) |
TDQS
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.
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.
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.
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.
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.
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_extractAIdempotent
テキストからファクト(主語→述語→目的語の三つ組)を自動抽出します。日本語の敬語・主語省略・社会的階層を分析して構造化します。store=trueにすると抽出結果をメモリに永続保存します(書き込み発生)。store=false(デフォルト)なら読み取り専用で、保存せずに抽出結果のみ返します。memory_storeとの違い: memory_storeはエピソード全体を保存、memory_extractはテキストからファクトのみを抽出。
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | ファクトを抽出するテキスト | |
| store | No | 抽出したファクトを永続保存するか(trueで書き込み発生) | |
| context_hint | No | コンテキストヒント(例: ビジネスミーティング) |
TDQS
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.
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.
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.
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.
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.
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_factsARead-onlyIdempotent
現在有効なファクト(構造化された事実)の一覧を取得します。ファクトは「主語→述語→目的語」の三つ組で、確度と有効期限を持ちます。
| Name | Required | Description | Default |
|---|---|---|---|
| valid_only | No | 有効なファクトのみ取得するか |
TDQS
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.
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.
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.
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.
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.
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_recallARead-onlyIdempotent
過去の記憶をセマンティック検索で呼び出します。「前回の会議で○○部長が仰った件」のような曖昧な日本語クエリにも対応します。
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | 取得件数 | |
| query | Yes | 検索クエリ(日本語/英語対応) |
TDQS
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.
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.
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.
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.
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.
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にすると、テキストからファクト(主語→述語→目的語の三つ組)を自動抽出します。
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | 発話者の役割 | user |
| content | Yes | 保存する内容(日本語/英語対応) | |
| session_id | No | セッション識別子 | |
| auto_extract | No | LLMでファクトを自動抽出するか |
TDQS
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.
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.
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.
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.
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.
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_checkARead-onlyIdempotent
日本の組織構造・商慣行を検索します。役職体系、系列、支払慣行、契約慣行、業界団体。
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | 検索クエリ(例: '支払いサイトの標準', '契約書の印鑑', '部長と課長の違い') |
TDQS
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.
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.
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.
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.
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.
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_listARead-onlyIdempotent
日本の組織構造・商慣行の全カテゴリ一覧を取得します。
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
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.
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.
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.
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.
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.
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_checkARead-onlyIdempotent
日本のビジネスプロトコル(根回し、稟議、報連相、名刺交換、席順、贈答)を検索します。
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | 検索クエリ(例: '名刺交換の作法', '根回し') |
TDQS
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.
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.
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.
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.
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.
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_listARead-onlyIdempotent
日本のビジネスプロトコルの一覧を取得します。
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
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.
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.
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.
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.
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.
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_checkARead-onlyIdempotent
日本の地域別ビジネス情報を検索します。主要都市の特性、自治体の助成金・補助金、地域条例、商慣習の違い。
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | 検索クエリ(例: '大阪の飲食店条例', '東京のスタートアップ助成金') |
TDQS
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.
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.
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.
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.
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.
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_listARead-onlyIdempotent
日本の地域別ビジネス情報の全カテゴリ一覧を取得します。
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
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.
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.
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.
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.
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.
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_checkARead-onlyIdempotent
特定のビジネスアクションに必要な日本の規制・許認可情報を回答します。10業種の詳細データベース + 訪日旅行者向け規制に対応。
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | 実行しようとしているアクション(例: 東京でレストランを開業する) | |
| industry | No | 業種(省略可、自動判定) | |
| entity_type | No | 主体の種別 | foreign_company |
TDQS
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.
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.
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.
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.
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.
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_industriesARead-onlyIdempotent
日本の規制データベースに登録されている業種の一覧を取得します。
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
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.
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.
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.
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.
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.
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_touristARead-onlyIdempotent
訪日旅行者向けの規制・マナー情報のカテゴリ一覧を取得します。ビザ、免税、交通、宿泊、医療、マナーの6カテゴリ。
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
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.
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.
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.
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.
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.
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.
searchARead-onlyIdempotent
EDITION全14ドメインを横断検索します。1回のリクエストで規制・プロトコル・カレンダー・地域・組織・進出手続き・旅行・エンタメ・日常生活・日本語・食文化・災害安全の全12ドメインを同時検索。
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | 検索クエリ(例: '大阪で飲食店を開業', '地震の避難方法', '敬語の使い方') |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate read-only and idempotent behavior. The description adds value by specifying the scope of search (multiple domains), which is not captured by annotations. However, it does not mention rate limits or result format, which would be helpful.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, front-loaded with the main action. The list of domains is informative but lengthy, making the second sentence slightly crowded. Still, it is efficient and clear.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description is adequate for a simple search tool with one parameter and complete annotations. However, it lacks details about output format or pagination, which would be beneficial for an agent to process results. With no output schema, more return context is desirable.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% (one parameter 'query' with description). The description does not add new parameter details beyond the schema, such as query language or syntax tips. Baseline of 3 is appropriate given high coverage, but no extra semantic enrichment.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states that the tool performs a cross-domain search across 14 domains (though 12 are listed), with a specific verb '横断検索' (cross-search). It distinguishes itself from sibling tools that are domain-specific (e.g., calendar_list, daily_life_search) by emphasizing simultaneous search across multiple domains.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage when a broad search across many domains is needed, but does not explicitly state when to avoid this tool (e.g., when a single domain is sufficient) or provide alternative recommendations. The sibling tools are numerous, so clearer guidance would help, but the context is strong.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
travel_listARead-onlyIdempotent
日本の旅行知識のトピック一覧を取得します。
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
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.
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.
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.
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.
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.
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.
travel_searchARead-onlyIdempotent
日本の旅行・観光に関する知識を検索します。交通(新幹線・ICカード・タクシー)、宿泊(旅館マナー・ホテル)、飲食(ラーメン地域差・箸マナー・チップ不要)、実用情報(SIM・ATM・緊急連絡先・マナー)。
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | 検索クエリ(例: '新幹線の乗り方', '旅館のマナー', 'ラーメンの食べ方') |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, idempotentHint, destructiveHint. Description adds valuable context on topic coverage without contradicting annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Description is concise with categorized list, but could be structured better. Front-loaded with main purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a one-parameter, read-only search tool, description adequately covers typical topics. No output schema needed.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema covers 100% of parameters with descriptions. Description adds no new info beyond schema examples, so baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states it searches knowledge about Japanese travel/tourism and lists specific categories (transportation, accommodation, dining, practical info). This distinguishes it from sibling tools like travel_list or general search.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides example queries implying usage context, but does not explicitly compare to siblings or state when not to use.
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 tool update
v0.6.1- Changed
memory_extract1 field changed- changed
Input schema / properties / store / descriptionPrevious value: -"抽出したファクトを永続保存するか"New value: +"抽出したファクトを永続保存するか(trueで書き込み発生)"
31 tool updates
v0.6.0- First observed
calendar_check - First observed
calendar_list - First observed
daily_life_list - First observed
daily_life_search - First observed
disaster_list - First observed
disaster_search - First observed
entertainment_list - First observed
entertainment_search - First observed
food_list - First observed
food_search - First observed
foreign_entry_check - First observed
foreign_entry_list - First observed
language_list - First observed
language_search - First observed
memory_context - First observed
memory_extract - First observed
memory_facts - First observed
memory_recall - First observed
memory_store - First observed
organization_check - First observed
organization_list - First observed
protocol_check - First observed
protocol_list - First observed
regional_check - First observed
regional_list - First observed
regulation_check - First observed
regulation_industries - First observed
regulation_tourist - First observed
search - First observed
travel_list - First observed
travel_search
TDQS
Scored across 31 tools
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.
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.
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.
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
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
17+ Japan MCP tools (weather/calendar v2/local-pack/enrich). x402 on Base, wallet-free trial.
MCP server for Japan geodata: cadastral lot numbers (chiban) and reverse geocoding, for AI agents.
Official Japanese regulatory evidence MCP for tourism businesses and authorized AI agents.
Japan data tools for AI agents: calendar (rokuyo), address, name splitting, corporate number lookup
Related MCP Servers
- AlicenseAqualityCmaintenanceProvides 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.645MIT
- AlicenseNot gradedqualityCmaintenanceTorify 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 viaMIT
- FlicenseNot gradedqualityDmaintenanceProvides AI agents with comprehensive Japanese market intelligence through 27 MCP tools, covering corporate data, macroeconomics, financials, and environmental data from 14 integrated sources.-
- AlicenseAqualityBmaintenanceMCP server providing AI agents with access to Japanese data APIs (address, furigana, transit, diet, holiday, weather, houjin) via a pay-per-use x402 payment protocol.28521Apache 2.0