# edition-api [Health: Active] **Category:** 🖥️ OS Automation **Repository:** https://github.com/hiroshic9-png/edition-api **GitHub Stars:** 0 **npm Downloads (last month):** 333 **Views:** 1 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/edition-api ## Description Japan Operations OS for AI agents. 10 knowledge domains, 23 MCP tools for the Japanese market. ## Tools Capabilities this server exposes over MCP: - **memory_store** — 会話やイベントのエピソードを永続記憶に保存します。日本語の文脈（敬語レベル、主語省略、暗黙の了解）も構造化して保持します。auto_extract=trueにすると、テキストからファクト（主語→述語→目的語の三つ組）を自動抽出します。 - **memory_recall** — 過去の記憶をセマンティック検索で呼び出します。「前回の会議で○○部長が仰った件」のような曖昧な日本語クエリにも対応します。 - **memory_facts** — 現在有効なファクト（構造化された事実）の一覧を取得します。ファクトは「主語→述語→目的語」の三つ組で、確度と有効期限を持ちます。 - **memory_context** — 現在のセッション状態（有効な事実・合意事項のサマリー）を取得します。エージェントのプロンプトに注入して文脈を維持するために使います。新しい会話セッション開始時や、長い会話の途中で文脈を再確認したい場合に呼び出してください。個別のファクトを一覧で見たい場合はmemory_factsを使ってください。 - **memory_extract** — テキストからファクト（主語→述語→目的語の三つ組）を自動抽出します。日本語の敬語・主語省略・社会的階層を分析して構造化します。store=trueにすると抽出結果をメモリに永続保存します（書き込み発生）。store=false（デフォルト）なら読み取り専用で、保存せずに抽出結果のみ返します。memory_storeとの違い: memory_storeはエピソード全体を保存、memory_extractはテキストからファクトのみを抽出。 - **regulation_check** — 特定のビジネスアクションに必要な日本の規制・許認可情報を回答します。10業種の詳細データベース + 訪日旅行者向け規制に対応。 - **regulation_industries** — 日本の規制データベースに登録されている業種の一覧を取得します。対応業種を確認したい場合や、regulation_checkに渡すindustryパラメータの値を調べたい場合に使ってください。特定の規制内容を知りたい場合はregulation_checkを使ってください。 - **regulation_tourist** — 訪日旅行者向けの規制・マナー情報のカテゴリ一覧を取得します。ビザ、免税、交通、宿泊、医療、マナーの6カテゴリ。どのカテゴリがあるか一覧で確認したい場合に使ってください。特定のカテゴリの詳細を知りたい場合はregulation_check（entity_type='tourist'）を使ってください。 - **protocol_check** — 日本のビジネスプロトコル（根回し、稟議、報連相、名刺交換、席順、贈答）を検索します。 - **protocol_list** — 日本のビジネスプロトコルの一覧を取得します。カテゴリを一覧で確認したい場合はこのツールを使い、特定のプロトコル（例: 名刺交換）の詳細を知りたい場合はprotocol_checkを使ってください。 - **calendar_check** — 日本のビジネスカレンダー情報を検索します。祝日、決算期、贈答シーズン、行政締切、季節性ビジネスの5カテゴリ。 - **calendar_list** — 日本のビジネスカレンダーの全カテゴリ一覧を取得します。カテゴリを一覧で確認したい場合はこのツールを使い、特定の日付やイベント（例: GW、確定申告）を検索する場合はcalendar_checkを使ってください。 - **regional_check** — 日本の地域別ビジネス情報を検索します。主要都市の特性、自治体の助成金・補助金、地域条例、商慣習の違い。 - **regional_list** — 日本の地域別ビジネス情報の全カテゴリ一覧を取得します。どの地域情報があるか確認する場合はこのツールを使い、特定地域の詳細（例: 大阪の商慣習）を検索する場合はregional_checkを使ってください。 - **organization_check** — 日本の組織構造・商慣行を検索します。役職体系、系列、支払慣行、契約慣行、業界団体。 - **organization_list** — 日本の組織構造・商慣行の全カテゴリ一覧を取得します。どのカテゴリがあるか確認する場合はこのツールを使い、特定の慣行（例: 支払いサイト）の詳細を検索する場合はorganization_checkを使ってください。 - **foreign_entry_check** — 外国企業・外国人の日本進出に必要な基盤知識を検索します。法人設立、経営管理ビザ、銀行口座開設、物件探し、税務届出、従業員雇用（労働法・解雇規制・社会保険）の6カテゴリ。 - **foreign_entry_list** — 外国企業・外国人の日本進出に関する知識カテゴリの一覧を取得します。利用可能なカテゴリを確認する場合はこのツールを使い、特定の手続き（例: ビザ取得、法人設立）の詳細を検索する場合はforeign_entry_checkを使ってください。 - **travel_search** — 日本の旅行・観光に関する知識を検索します。交通（新幹線・ICカード・タクシー）、宿泊（旅館マナー・ホテル）、飲食（ラーメン地域差・箸マナー・チップ不要）、実用情報（SIM・ATM・緊急連絡先・マナー）。 - **travel_list** — 日本の旅行知識のトピック一覧を取得します。どのトピックがあるか確認する場合はこのツールを使い、特定の旅行情報（例: 新幹線の乗り方）を検索する場合はtravel_searchを使ってください。 - **entertainment_search** — 日本のエンターテインメント・ポップカルチャーに関する知識を検索します。推し活（チケット取得・転売法）、アニメ聖地巡礼、ライブマナー（ペンライト・コール）、季節イベント（花見・花火・初詣）。 - **entertainment_list** — 日本のエンタメ知識のトピック一覧を取得します。どのトピックがあるか確認する場合はこのツールを使い、特定の情報（例: コミケ参加方法）を検索する場合はentertainment_searchを使ってください。 - **daily_life_search** — 日本の日常生活に関する知識を検索します。住所・郵便システム、ゴミ分別ルール、公共料金（電気・ガス・水道・NHK）、医療・健康保険制度。外国人が日本で生活するために必要な実用知識。 - **daily_life_list** — 日本の日常生活知識のトピック一覧を取得します。どのトピックがあるか確認する場合はこのツールを使い、特定の情報（例: ゴミ分別）を検索する場合はdaily_life_searchを使ってください。 - **language_search** — 日本語の構造的知識を検索します。敬語体系（尊敬語・謙譲語・丁寧語）、助数詞（数え方）、名前・住所の構造パターン、ビジネス日本語（電話応対・クッション言葉・メールテンプレート）。 - **language_list** — 日本語知識のトピック一覧を取得します。どのトピックがあるか確認する場合はこのツールを使い、特定の日本語知識（例: 敬語の使い方）を検索する場合はlanguage_searchを使ってください。 - **food_search** — 日本の食文化に関する知識を検索します。食事マナー（箸のタブー・乾杯・割り勘）、料理分類（懐石・定食・ラーメン・郷土料理）、飲食店ガイド（食券機・居酒屋・回転寿司・おまかせ）、アレルギー・食制限（ハラル・ベジタリアン対応）。 - **food_list** — 日本の食文化知識のトピック一覧を取得します。どのトピックがあるか確認する場合はこのツールを使い、特定の情報（例: 箸のマナー）を検索する場合はfood_searchを使ってください。 - **disaster_search** — 日本の災害・安全に関する知識を検索します。地震（震度スケール・緊急地震速報・耐震基準）、台風・水害（警戒レベル・計画運休）、緊急連絡先（110/119/多言語対応）、防災準備（防災バッグ・ハザードマップ・避難所マナー）。 - **disaster_list** — 日本の災害・安全知識のトピック一覧を取得します。どのトピックがあるか確認する場合はこのツールを使い、特定の情報（例: 地震が来たらどうする）を検索する場合はdisaster_searchを使ってください。 - **tax_search** — 日本の税制に関する知識を検索します。所得税、消費税、法人税、源泉徴収、租税条約、ふるさと納税、譲渡所得、確定申告。 - **tax_list** — 日本の税務トピック一覧を取得します。 - **visa_search** — 日本のビザ・在留資格に関する知識を検索します。在留資格一覧、永住権、高度人材ポイント制、経営管理ビザ、帰化。 - **visa_list** — ビザ・在留資格トピック一覧を取得します。 - **banking_search** — 日本の銀行・金融サービスに関する知識を検索します。口座開設、海外送金、モバイル決済、クレジットカード、ATM、外貨両替。 - **banking_list** — 銀行・金融トピック一覧を取得します。 - **healthcare_search** — 日本の医療・健康保険に関する知識を検索します。健康保険制度、高額療養費、病院受診、処方薬、出産育児支援、メンタルヘルス、介護保険。 - **healthcare_list** — 医療・健康保険トピック一覧を取得します。 - **education_search** — 日本の教育制度・留学に関する知識を検索します。学校制度、大学入学、奨学金、日本語学校、JLPT、留学生活。 - **education_list** — 教育・留学トピック一覧を取得します。 - **real_estate_search** — 日本の不動産・住宅に関する知識を検索します。賃貸（敷金・礼金）、不動産購入、UR住宅、住宅支援制度、引越し手続き。 - **real_estate_list** — 不動産・住宅トピック一覧を取得します。 - **search** — EDITION全20ドメインを横断検索します。規制・プロトコル・カレンダー・地域・組織・進出・旅行・エンタメ・日常生活・日本語・食文化・災害・税務・ビザ・銀行・医療・教育・不動産・メモリの全20ドメインを同時検索。 - **compliance_log** — Record a Japan regulatory/compliance check with full audit trail. Use this AFTER performing a regulation_check, foreign_entry_check, or any compliance-sensitive query. Creates an immutable, timestamped record for governance reporting. Agents operating under compliance requirements should call this after every regulatory lookup. - **compliance_report** — Generate a structured compliance/governance report from accumulated audit records. Returns all logged compliance checks with statistics. Use for periodic compliance reviews, audit preparation, or governance dashboards. Supports filtering by domain, date range, or compliance status. ## Claude Desktop Quick Installation Install path detected from listing signals. Uses `npx` (confidence: high): ```json "mcpServers": { "edition-api": { "command": "npx", "args": ["-y","edition-mcp-server"], "env": { "EDITION_API_URL": "", "EDITION_API_KEY": "" } } } ``` **Requires environment variables:** `EDITION_API_URL`, `EDITION_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for). ## Documentation ## What the edition-api MCP server does The edition-api MCP server exposes Japan-focused operational knowledge to AI agents through the Model Context Protocol. Its material spans business formation, regulatory questions, workplace customs, travel, food, healthcare, education, housing, banking, taxation, immigration, disaster response, and everyday administration. The repository describes 20 knowledge domains and 43 MCP tools. Each domain generally provides search or check operations plus list operations, while a cross-domain `search` tool can query all domains in one request. The content is intended to provide structured reference information for situations where Japanese procedures, terminology, cultural expectations, or local rules matter. Memory tools add a separate capability for storing episodes, recalling information, retrieving facts, building context, and extracting structured knowledge. The documented memory model separates raw conversation episodes, extracted subject-predicate-object facts, and aggregated context. Extraction can include Japanese honorific analysis, social hierarchy detection, confidence scoring, and tense. ## How it works The package runs as an MCP server and forwards agent requests to the EDITION API. The documented production endpoint is `https://api.edition.sh`, and the API is described as a free beta that does not require registration. The repository also documents direct REST calls for search, regulation checks, and protocol checks, but the MCP package is the route intended for MCP clients. Tools are grouped by subject. Examples include `regulation_check` for industry-related rules, `protocol_check` for practices such as nemawashi and ringi, `calendar_check` for Japanese business and administrative timing, `foreign_entry_check` for incorporation and visa-related procedures, and `travel_search` for transport, etiquette, and tourist questions. Governance tools can record an immutable, timestamped compliance event with `compliance_log` and produce summary, detailed, or JSON reports with `compliance_report`. Seven documented Skills Packs combine domain guidance with procedures and orchestration instructions. They cover market entry, business operations, travel, daily living, cultural context, safety and compliance, and governance compliance. ## Setup and configuration The recommended installation uses the published npm package: ```bash npx -y edition-mcp-server ``` Configure the MCP client to start that command and provide `EDITION_API_URL` and `EDITION_API_KEY`. The example configuration uses `https://api.edition.sh` and the development key `edition_dev_key_for_testing`. The README specifically shows setup examples for Claude Desktop and Cursor. A Smithery installation command is also documented: ```bash npx -y smithery mcp add hiroshi-c9/edition ``` The repository additionally provides a hosted API path for clients or applications that use HTTP directly instead of MCP. ## Tools and capabilities The edition-api MCP server documents tools for: - Searching all domains or querying a specific subject area. - Checking Japanese regulations across industries and tourist activities. - Explaining business protocols, hierarchy, regional differences, calendars, and language. - Supporting company incorporation, management visas, banking, tax, real estate, and hiring research. - Answering travel, food, entertainment, healthcare, education, safety, and daily-life questions. - Storing and extracting Japanese-aware memory with facts, context, hierarchy, and confidence information. - Creating and reporting governance audit trails after regulatory checks. The listed Skills Packs can help skills-aware agents load a predefined combination of domains for a particular workflow. ## Limitations and notes The repository contains inconsistent counts in its surrounding description: the current README presents 20 domains and 43 tools, while the supplied current description mentions 10 domains and 23 tools. This writeup follows the detailed README tables. The service is described as a free beta, so its availability and behavior may change. Regulatory, immigration, tax, healthcare, and safety information should be checked against the relevant official authority before making a consequential decision. _Full upstream README: https://allmcps.com/mcp/edition-api/readme_