Edition Api

io.github.hiroshic9-pngPublished by GitHub account hiroshic9-pngv0.3.1Updated Oct 24, 2026

Japan business regulations, compliance, travel, protocols, memory — 10 knowledge domains, 23 tools.

VerifiedSTDIODesktop onlyLocation & LifestyleKnowledge & MemoryBusiness & Commerce

Overview

AI-generated overview

A local MCP server giving assistants structured Japan knowledge: regulations, business protocol, travel, daily life and Japanese-aware memory across 20 domains.

What you can do
Check regulations for 10 industries and tourist compliance, and log audit records with governance reports for regulatory checks performed by the assistant. Look up business protocol, calendar, regional, organization and foreign market-entry guidance for Japan. Search lifestyle and culture topics: travel, food, entertainment, daily life, language, disaster safety, healthcare, education, real estate, tax, banking and visas. Store, recall and extract persistent memory episodes, facts and context with Japanese keigo and hierarchy analysis. Run one cross-domain search across all 20 domains at once.
When to use it
Useful when an assistant must answer questions about operating in Japan, such as company incorporation, visas, industry regulation, business etiquette or everyday living, and should ground answers in structured entries rather than general model knowledge. Also relevant for agents that need Japanese-aware persistent memory or a compliance audit trail.
Requirements
Runs locally via npx (Node.js) as a stdio process, or can be reached through the hosted API. Needs network access to the EDITION API base URL (EDITION_API_URL) and an API key in EDITION_API_KEY; a free beta key is provided by default. The free tier covers 8 core domains at 100 requests per day; all 20 domains require a paid Pro tier.
Before you install
The API key is a secret passed by environment variable; keep it out of shared configuration files. Free tier is limited to 8 domains and 100 requests per day, and full access is a paid subscription. Memory tools write stored episodes and facts to the service, so conversation content is sent to a third-party API. Compliance log and report tools create records; review what is persisted before relying on them.

Installation

In SourceWeft

  1. Open Edition Api in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

EDITION Intelligence Platform

[Glama Score] [npm] [License: MIT]

Japan Knowledge Gateway for autonomous AI agents.

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

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

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

Why EDITION?

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

ChallengeWhat goes wrong
Keigo (敬語)「お持ちすれば喜ばれるかと存じます」 — hidden subject, layered honorifics, uncertainty expression. Generic NLP treats this as noise.
Implicit agreementsJapanese business communication rarely states things directly. Agents need cultural decoding.
Regulatory maze10+ industries with overlapping national/prefectural regulations, most documentation only in Japanese.
Procedural complexityCompany 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.

20 Knowledge Domains

#DomainToolsWhat it covers
1Memorymemory_store memory_recall memory_facts memory_context memory_extractThree-layer persistent memory (Episode/Fact/Context) with Japanese keigo analysis and social hierarchy detection
2Regulationregulation_check regulation_industries regulation_tourist10 industries (food, real estate, finance, healthcare, construction, education, transport, retail, IT, manufacturing) + tourist compliance
3Protocolprotocol_check protocol_listNemawashi, ringi, hourensou, meishi koukan, sekijun, zoutou — step-by-step procedures with cultural context
4Calendarcalendar_check calendar_listFiscal year (April start), Golden Week, Obon, year-end, gift seasons, administrative deadlines
5Regionalregional_check regional_listTokyo vs Osaka negotiation styles, local subsidies, prefectural regulations, dialect considerations
6Organizationorganization_check organization_listKeiretsu networks, corporate hierarchy (bucho/kacho), payment customs (net-60), contract practices
7Foreign Entryforeign_entry_check foreign_entry_list6 categories: company incorporation (KK/GK), management visa, bank account, real estate, tax registration, employee hiring
8Traveltravel_search travel_listShinkansen, IC cards, ryokan etiquette, onsen rules, restaurant ordering, tipping customs
9Entertainmententertainment_search entertainment_listOshi-katsu fan culture, anime pilgrimage, live event manners, seasonal festivals
10Daily Lifedaily_life_search daily_life_listPostal/address systems, garbage sorting by municipality, utilities (electricity/gas/water/NHK), healthcare navigation
11Languagelanguage_search language_listKeigo honorific system, counter words (josushi), name/address structure, business Japanese templates
12Food Culturefood_search food_listDining etiquette, cuisine classification, restaurant navigation (shokkenki, izakaya, sushi counter), dietary restrictions (halal, vegetarian, allergies)
13Disaster & Safetydisaster_search disaster_listEarthquake shindo scale & EEW, typhoon warning levels, emergency contacts (110/119/118), preparedness checklists
14Healthcarehealthcare_search healthcare_listNational health insurance, hospital navigation, prescription system, medical Japanese terminology
15Educationeducation_search education_listSchool system (6-3-3-4), entrance exams, international schools, university admission for foreigners
16Real Estatereal_estate_search real_estate_listRental process (shikikin/reikin/hoshoukin), property types, foreigner-friendly agencies, contract terms
17Taxtax_search tax_listIncome tax, consumption tax, withholding, year-end adjustment, tax filing for foreigners and businesses
18Banking & Financebanking_search banking_listBank account types, remittance, fintech services, corporate banking, payment systems
19Visa & Immigrationvisa_search visa_listVisa categories, status of residence, renewal procedures, permanent residency, naturalization
20Cross-DomainsearchSearch 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 PackDomainsUse Case
japan-market-entryregulation, foreign_entry, organizationCompany incorporation, visa, banking
japan-business-opsprotocol, calendar, regional, languageMeetings, nemawashi, business Japanese
japan-travel-guidetravel, food, entertainment, disasterTourist assistance, dining, safety
japan-daily-livingdaily_life, food, languageUtilities, garbage, healthcare
japan-cultural-contextprotocol, organization, languageImplicit communication, hierarchy
japan-safety-compliancedisaster, regulationEarthquake response, regulatory compliance
japan-governance-complianceregulation, governanceAudit trails, compliance reporting, AI Act readiness

→ Full Skills Pack documentation

Governance Intelligence

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

regulation_check → compliance_log → compliance_report      ↓                   ↓                  ↓  Check rules      Record audit       Generate report
ToolPurpose
compliance_logCreate immutable, timestamped audit record after any regulatory check
compliance_reportGenerate 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)

bash
npx -y edition-mcp-server

Add to claude_desktop_config.json:

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

bash
npx -y smithery mcp add hiroshi-c9/edition

Option 3: REST API (Direct)

bash
# Cross-domain searchcurl -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 checkcurl -X POST https://api.edition.sh/api/v1/regulation/check \  -d '{"action": "open restaurant", "industry": "food_service"}'
# Business protocolcurl -X POST https://api.edition.sh/api/v1/protocol/check \  -d '{"query": "nemawashi consensus building"}'

Memory API — Japanese-aware Persistent Memory

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

Input:  "佐藤部長にはワインをお持ちすれば喜ばれるかと存じます"
Output:  Subject:    佐藤 (役職: 部長)  Predicate:  好む  Object:     ワイン  Keigo:      Level 2 (尊敬語)  Hierarchy:  superior  Confidence: 0.7 (推測 — not stated as fact)  Tense:      present

Three-layer architecture:

  • Episodes — raw conversation logs
  • Facts — structured knowledge (subject→predicate→object triples)
  • Context — aggregated session summaries per entity/topic

MCP Capabilities

CategoryCountDetails
Tools43All with annotations (readOnlyHint, destructiveHint, idempotentHint)
Resources2edition://domains (domain catalog), edition://quality (trust scores)
Prompts2japan_business_briefing (by industry), japan_travel_guide (by destination)

API Endpoints

Memory

MethodEndpointDescription
POST/api/v1/memory/episodesStore episode (auto_extract=true for auto fact extraction)
POST/api/v1/memory/recallSemantic search across episodes
GET/api/v1/memory/factsList structured facts
GET/api/v1/memory/contextSession context summary
POST/api/v1/memory/extractExtract facts from text (store=true to persist)

Regulation & Compliance

MethodEndpointDescription
POST/api/v1/regulation/checkCheck regulations (10 industries + tourist)
GET/api/v1/regulation/industriesList all regulated industries
GET/api/v1/regulation/touristTourist regulation categories

Business Intelligence

MethodEndpointDescription
POST/api/v1/protocol/checkSearch business protocols
GET/api/v1/protocol/listList all protocols
POST/api/v1/calendar/checkSearch business calendar
GET/api/v1/calendar/listList calendar categories
POST/api/v1/regional/checkSearch regional differences
GET/api/v1/regional/listList regional categories
POST/api/v1/organization/checkSearch organizational structures
GET/api/v1/organization/listList organization categories

Market Entry

MethodEndpointDescription
POST/api/v1/foreign-entry/checkForeign market entry guides
GET/api/v1/foreign-entry/listList entry categories (6 total)

Lifestyle & Culture

MethodEndpointDescription
POST/api/v1/travel/searchTravel intelligence
POST/api/v1/entertainment/searchEntertainment & pop culture
POST/api/v1/daily-life/searchDaily life knowledge
POST/api/v1/language/searchJapanese language
POST/api/v1/food/searchFood culture
POST/api/v1/disaster/searchDisaster & safety
POST/api/v1/healthcare/searchHealthcare system
POST/api/v1/education/searchEducation system
POST/api/v1/real-estate/searchReal estate
POST/api/v1/tax/searchTax system
POST/api/v1/banking/searchBanking & finance
POST/api/v1/visa/searchVisa & immigration

Cross-Domain

MethodEndpointDescription
POST/api/v1/searchSearch all 20 domains simultaneously

Data Quality

All knowledge entries include:

  • source_url — Link to authoritative source (government websites, official organizations)
  • last_verified — Date of last verification
  • confidence — Verification status (verified / estimated)
  • version — Entry version with changelog

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

Tech Stack

LayerTechnology
APIFastAPI (Python)
Memory StoreSQLite + ChromaDB (vector search)
MCP ServerTypeScript (MCP SDK v1.12+)
LLMGemini / Claude / GPT (fact extraction)
HostingRender (api.edition.sh)

Agent Discovery

ProtocolEndpoint
MCP (Streamable HTTP)POST https://api.edition.sh/mcp
A2A Agent CardGET https://api.edition.sh/.well-known/agent.json
MCP Server CardGET https://api.edition.sh/.well-known/mcp/server-card.json
OpenAPI / SwaggerGET https://api.edition.sh/docs

Agent Harness Compatible

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

Freemium Access

TierDomainsRate LimitPrice
Free8 core domains100 req/dayFree
ProAll 20 domains (incl. tax, banking, healthcare, visa)10,000 req/day¥2,980/mo
EnterpriseAll domains + priority supportUnlimitedContact

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

Registries

RegistryStatus
npm✅ Published (v0.4.0)
Smithery✅ Listed (43 tools)
Glama✅ Grade A Coherence

Why Not Mem0 / Letta / Zep?

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

  • Parse Japanese keigo levels (丁寧語 / 尊敬語 / 謙譲語)
  • Detect implicit social hierarchy from honorific patterns
  • Score confidence based on Japanese speech patterns (断定 vs 推測 vs 伝聞)
  • Include a Japanese regulatory database with 20 knowledge domains

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

License

MIT

Source: README.md at commit 74b8cc9

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.3.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts