{
  "markdown": "# EDITION Intelligence Platform\n\n[![Glama Score](https://glama.ai/mcp/servers/hiroshic9-png/edition-api/badge)](https://glama.ai/mcp/servers/hiroshic9-png/edition-api)\n[![npm](https://img.shields.io/npm/v/edition-mcp-server)](https://www.npmjs.com/package/edition-mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n**Japan Knowledge Gateway for autonomous AI agents.**\n\n20 knowledge domains · 43 MCP tools · 7 Skills Packs · 100+ REST endpoints\nVerified ground truth for operating in the Japanese market. Quality score: 97.8/100.\n\n> **Production API:** [api.edition.sh](https://api.edition.sh) — Free beta, no registration required.\n>\n> **Interactive Demo:** [Tourist Agent Demo](https://hiroshic9-png.github.io/edition-api/demo.html) — Watch 6 domains work together in real-time.\n\n---\n\n## Why EDITION?\n\nAI agents working in Japan hit walls that generic LLMs can't solve:\n\n| Challenge | What goes wrong |\n|-----------|----------------|\n| **Keigo (敬語)** | 「お持ちすれば喜ばれるかと存じます」 — hidden subject, layered honorifics, uncertainty expression. Generic NLP treats this as noise. |\n| **Implicit agreements** | Japanese business communication rarely states things directly. Agents need cultural decoding. |\n| **Regulatory maze** | 10+ industries with overlapping national/prefectural regulations, most documentation only in Japanese. |\n| **Procedural complexity** | Company incorporation, visa, banking — each requires 5-8 steps with specific documents, deadlines, and costs. |\n\n**EDITION provides verified, structured intelligence** that agents can use as ground truth instead of hallucinating cultural nuances, legal requirements, and procedural details.\n\n---\n\n## 20 Knowledge Domains\n\n| # | Domain | Tools | What it covers |\n|---|--------|-------|----------------|\n| 1 | **Memory** | `memory_store` `memory_recall` `memory_facts` `memory_context` `memory_extract` | Three-layer persistent memory (Episode/Fact/Context) with Japanese keigo analysis and social hierarchy detection |\n| 2 | **Regulation** | `regulation_check` `regulation_industries` `regulation_tourist` | 10 industries (food, real estate, finance, healthcare, construction, education, transport, retail, IT, manufacturing) + tourist compliance |\n| 3 | **Protocol** | `protocol_check` `protocol_list` | Nemawashi, ringi, hourensou, meishi koukan, sekijun, zoutou — step-by-step procedures with cultural context |\n| 4 | **Calendar** | `calendar_check` `calendar_list` | Fiscal year (April start), Golden Week, Obon, year-end, gift seasons, administrative deadlines |\n| 5 | **Regional** | `regional_check` `regional_list` | Tokyo vs Osaka negotiation styles, local subsidies, prefectural regulations, dialect considerations |\n| 6 | **Organization** | `organization_check` `organization_list` | Keiretsu networks, corporate hierarchy (bucho/kacho), payment customs (net-60), contract practices |\n| 7 | **Foreign Entry** | `foreign_entry_check` `foreign_entry_list` | 6 categories: company incorporation (KK/GK), management visa, bank account, real estate, tax registration, employee hiring |\n| 8 | **Travel** | `travel_search` `travel_list` | Shinkansen, IC cards, ryokan etiquette, onsen rules, restaurant ordering, tipping customs |\n| 9 | **Entertainment** | `entertainment_search` `entertainment_list` | Oshi-katsu fan culture, anime pilgrimage, live event manners, seasonal festivals |\n| 10 | **Daily Life** | `daily_life_search` `daily_life_list` | Postal/address systems, garbage sorting by municipality, utilities (electricity/gas/water/NHK), healthcare navigation |\n| 11 | **Language** | `language_search` `language_list` | Keigo honorific system, counter words (josushi), name/address structure, business Japanese templates |\n| 12 | **Food Culture** | `food_search` `food_list` | Dining etiquette, cuisine classification, restaurant navigation (shokkenki, izakaya, sushi counter), dietary restrictions (halal, vegetarian, allergies) |\n| 13 | **Disaster & Safety** | `disaster_search` `disaster_list` | Earthquake shindo scale & EEW, typhoon warning levels, emergency contacts (110/119/118), preparedness checklists |\n| 14 | **Healthcare** | `healthcare_search` `healthcare_list` | National health insurance, hospital navigation, prescription system, medical Japanese terminology |\n| 15 | **Education** | `education_search` `education_list` | School system (6-3-3-4), entrance exams, international schools, university admission for foreigners |\n| 16 | **Real Estate** | `real_estate_search` `real_estate_list` | Rental process (shikikin/reikin/hoshoukin), property types, foreigner-friendly agencies, contract terms |\n| 17 | **Tax** | `tax_search` `tax_list` | Income tax, consumption tax, withholding, year-end adjustment, tax filing for foreigners and businesses |\n| 18 | **Banking & Finance** | `banking_search` `banking_list` | Bank account types, remittance, fintech services, corporate banking, payment systems |\n| 19 | **Visa & Immigration** | `visa_search` `visa_list` | Visa categories, status of residence, renewal procedures, permanent residency, naturalization |\n| 20 | **Cross-Domain** | `search` | Search all 20 domains simultaneously with a single query |\n\n---\n\n## Skills Packs (MCP Skills Primitive)\n\nPre-built knowledge packs that bundle domain expertise, SOPs, and tool orchestration instructions. Skills-aware agents can load these to gain structured Japan operational knowledge.\n\n| Skill Pack | Domains | Use Case |\n|-----------|---------|----------|\n| [japan-market-entry](./skills/japan-business/japan-market-entry.md) | regulation, foreign_entry, organization | Company incorporation, visa, banking |\n| [japan-business-ops](./skills/japan-business/japan-business-ops.md) | protocol, calendar, regional, language | Meetings, nemawashi, business Japanese |\n| [japan-travel-guide](./skills/japan-business/japan-travel-guide.md) | travel, food, entertainment, disaster | Tourist assistance, dining, safety |\n| [japan-daily-living](./skills/japan-business/japan-daily-living.md) | daily_life, food, language | Utilities, garbage, healthcare |\n| [japan-cultural-context](./skills/japan-business/japan-cultural-context.md) | protocol, organization, language | Implicit communication, hierarchy |\n| [japan-safety-compliance](./skills/japan-business/japan-safety-compliance.md) | disaster, regulation | Earthquake response, regulatory compliance |\n| [japan-governance-compliance](./skills/japan-business/japan-governance-compliance.md) | regulation, governance | Audit trails, compliance reporting, AI Act readiness |\n\n→ [Full Skills Pack documentation](./skills/japan-business/README.md)\n\n---\n\n## Governance Intelligence\n\nEDITION includes built-in compliance audit trail tools for agents operating under governance requirements. Available in **both** Progressive Discovery and Legacy modes.\n\n```\nregulation_check → compliance_log → compliance_report\n      ↓                   ↓                  ↓\n  Check rules      Record audit       Generate report\n```\n\n| Tool | Purpose |\n|------|---------|\n| `compliance_log` | Create immutable, timestamped audit record after any regulatory check |\n| `compliance_report` | Generate governance reports (summary / detailed / JSON) from audit trail |\n\nDesigned for EU AI Act (Aug 2026) and upcoming Japan AI governance compliance.\n\n---\n\n## Quick Start\n\n### Option 1: npx (Recommended for Claude Desktop / Cursor)\n\n```bash\nnpx -y edition-mcp-server\n```\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"edition\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"edition-mcp-server\"],\n      \"env\": {\n        \"EDITION_API_URL\": \"https://api.edition.sh\",\n        \"EDITION_API_KEY\": \"edition_dev_key_for_testing\"\n      }\n    }\n  }\n}\n```\n\n### Option 2: Smithery\n\n```bash\nnpx -y smithery mcp add hiroshi-c9/edition\n```\n\n### Option 3: REST API (Direct)\n\n```bash\n# Cross-domain search\ncurl -X POST https://api.edition.sh/api/v1/search \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"query\": \"How do I start a tech company in Tokyo?\"}'\n\n# Regulation check\ncurl -X POST https://api.edition.sh/api/v1/regulation/check \\\n  -d '{\"action\": \"open restaurant\", \"industry\": \"food_service\"}'\n\n# Business protocol\ncurl -X POST https://api.edition.sh/api/v1/protocol/check \\\n  -d '{\"query\": \"nemawashi consensus building\"}'\n```\n\n---\n\n## Memory API — Japanese-aware Persistent Memory\n\nStore episodes, auto-extract structured facts with **keigo analysis, social hierarchy detection, and confidence scoring**.\n\n```\nInput:  \"佐藤部長にはワインをお持ちすれば喜ばれるかと存じます\"\n\nOutput:\n  Subject:    佐藤 (役職: 部長)\n  Predicate:  好む\n  Object:     ワイン\n  Keigo:      Level 2 (尊敬語)\n  Hierarchy:  superior\n  Confidence: 0.7 (推測 — not stated as fact)\n  Tense:      present\n```\n\nThree-layer architecture:\n- **Episodes** — raw conversation logs\n- **Facts** — structured knowledge (subject→predicate→object triples)\n- **Context** — aggregated session summaries per entity/topic\n\n## MCP Capabilities\n\n| Category | Count | Details |\n|----------|-------|---------|\n| **Tools** | 43 | All with annotations (`readOnlyHint`, `destructiveHint`, `idempotentHint`) |\n| **Resources** | 2 | `edition://domains` (domain catalog), `edition://quality` (trust scores) |\n| **Prompts** | 2 | `japan_business_briefing` (by industry), `japan_travel_guide` (by destination) |\n\n## API Endpoints\n\n### Memory\n| Method | Endpoint | Description |\n|--------|----------|-------------|\n| POST | `/api/v1/memory/episodes` | Store episode (`auto_extract=true` for auto fact extraction) |\n| POST | `/api/v1/memory/recall` | Semantic search across episodes |\n| GET | `/api/v1/memory/facts` | List structured facts |\n| GET | `/api/v1/memory/context` | Session context summary |\n| POST | `/api/v1/memory/extract` | Extract facts from text (`store=true` to persist) |\n\n### Regulation & Compliance\n| Method | Endpoint | Description |\n|--------|----------|-------------|\n| POST | `/api/v1/regulation/check` | Check regulations (10 industries + tourist) |\n| GET | `/api/v1/regulation/industries` | List all regulated industries |\n| GET | `/api/v1/regulation/tourist` | Tourist regulation categories |\n\n### Business Intelligence\n| Method | Endpoint | Description |\n|--------|----------|-------------|\n| POST | `/api/v1/protocol/check` | Search business protocols |\n| GET | `/api/v1/protocol/list` | List all protocols |\n| POST | `/api/v1/calendar/check` | Search business calendar |\n| GET | `/api/v1/calendar/list` | List calendar categories |\n| POST | `/api/v1/regional/check` | Search regional differences |\n| GET | `/api/v1/regional/list` | List regional categories |\n| POST | `/api/v1/organization/check` | Search organizational structures |\n| GET | `/api/v1/organization/list` | List organization categories |\n\n### Market Entry\n| Method | Endpoint | Description |\n|--------|----------|-------------|\n| POST | `/api/v1/foreign-entry/check` | Foreign market entry guides |\n| GET | `/api/v1/foreign-entry/list` | List entry categories (6 total) |\n\n### Lifestyle & Culture\n| Method | Endpoint | Description |\n|--------|----------|-------------|\n| POST | `/api/v1/travel/search` | Travel intelligence |\n| POST | `/api/v1/entertainment/search` | Entertainment & pop culture |\n| POST | `/api/v1/daily-life/search` | Daily life knowledge |\n| POST | `/api/v1/language/search` | Japanese language |\n| POST | `/api/v1/food/search` | Food culture |\n| POST | `/api/v1/disaster/search` | Disaster & safety |\n| POST | `/api/v1/healthcare/search` | Healthcare system |\n| POST | `/api/v1/education/search` | Education system |\n| POST | `/api/v1/real-estate/search` | Real estate |\n| POST | `/api/v1/tax/search` | Tax system |\n| POST | `/api/v1/banking/search` | Banking & finance |\n| POST | `/api/v1/visa/search` | Visa & immigration |\n\n### Cross-Domain\n| Method | Endpoint | Description |\n|--------|----------|-------------|\n| POST | `/api/v1/search` | Search all 20 domains simultaneously |\n\n---\n\n## Data Quality\n\nAll knowledge entries include:\n- **`source_url`** — Link to authoritative source (government websites, official organizations)\n- **`last_verified`** — Date of last verification\n- **`confidence`** — Verification status (`verified` / `estimated`)\n- **`version`** — Entry version with changelog\n\nSources include: 厚生労働省 (MHLW), 国税庁 (NTA), 法務省 (MOJ), 国土交通省 (MLIT), 経済産業省 (METI), 日本経団連 (Keidanren), JETRO, 入管庁 (ISA).\n\n## Tech Stack\n\n| Layer | Technology |\n|-------|-----------|\n| API | FastAPI (Python) |\n| Memory Store | SQLite + ChromaDB (vector search) |\n| MCP Server | TypeScript (MCP SDK v1.12+) |\n| LLM | Gemini / Claude / GPT (fact extraction) |\n| Hosting | Render (api.edition.sh) |\n\n## Agent Discovery\n\n| Protocol | Endpoint |\n|----------|----------|\n| MCP (Streamable HTTP) | `POST https://api.edition.sh/mcp` |\n| A2A Agent Card | `GET https://api.edition.sh/.well-known/agent.json` |\n| MCP Server Card | `GET https://api.edition.sh/.well-known/mcp/server-card.json` |\n| OpenAPI / Swagger | `GET https://api.edition.sh/docs` |\n\n## Agent Harness Compatible\n\nEDITION 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.\n\n## Freemium Access\n\n| Tier | Domains | Rate Limit | Price |\n|------|---------|------------|-------|\n| **Free** | 8 core domains | 100 req/day | Free |\n| **Pro** | All 20 domains (incl. tax, banking, healthcare, visa) | 10,000 req/day | ¥2,980/mo |\n| **Enterprise** | All domains + priority support | Unlimited | Contact |\n\nAnonymous access defaults to Free tier. Register for an API key at `POST /api/v1/auth/register`.\n\n## Registries\n\n| Registry | Status |\n|----------|--------|\n| [npm](https://www.npmjs.com/package/edition-mcp-server) | ✅ Published (v0.4.0) |\n| [Smithery](https://smithery.ai/server/@hiroshi-c9/edition) | ✅ Listed (43 tools) |\n| [Glama](https://glama.ai/mcp/servers/hiroshic9-png/edition-api) | ✅ Grade A Coherence |\n\n## Why Not Mem0 / Letta / Zep?\n\nThose are excellent general-purpose memory tools. But they don't:\n- Parse Japanese keigo levels (丁寧語 / 尊敬語 / 謙譲語)\n- Detect implicit social hierarchy from honorific patterns\n- Score confidence based on Japanese speech patterns (断定 vs 推測 vs 伝聞)\n- Include a Japanese regulatory database with 20 knowledge domains\n\n**Japanese business context is structurally different.** Agents need purpose-built infrastructure to navigate it.\n\n## License\n\nMIT\n",
  "bytes": 14534,
  "sha": "b0210c45ffab4bb39d5a3e06e319fe10dac94a98933ba545480a732dad1753f8",
  "repo_slug": "hiroshic9-png/edition-api",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_hiroshic9_png_edition_api_829a3232/readme"
}