# yasashii.org

> yasashii.org is a free MCP server for legal and government. Easy Japanese guides to administrative procedures and disaster info, verified by people. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, CLI, Web
- **Website:** https://yasashii.org/data/
- **Repository:** https://github.com/dror-jp/yasashii.org/tree/HEAD/mcp
- **MCP Registry name:** io.github.dror-jp/yasashii-org-mcp
- **Categories:** legal and government
- **Listing updated:** 2026-11-14

## About

Written in やさしい日本語, a simplified register for people who find standard Japanese hard, these documents cover moving-in notices, other municipal procedures and emergency preparedness. The text is written from national primary sources, checked by a person and licensed CC BY 4.0. Furigana appears in 《》 brackets after the kanji and half-width spaces mark word breaks, following a guideline from the Immigration Services Agency and the Agency for Cultural Affairs.

Four tools are exposed: list_documents, filterable by procedures, disaster or daily life, get_document for the full text with term explanations and primary-source links, search_terms for plain explanations of official words such as 住民票 and 転入届, and get_meta. Each response carries a disclaimer and last_verified dates, and the README asks assistants to cite the go.jp or e-Gov links.

The remote endpoint needs no sign-in and the npm package has zero dependencies. The site states it is not a government website, and an official page prevails if the two differ.

## Features

- **Easy Japanese documents:** Procedures, disaster and daily-life guides in simplified Japanese.
- **Furigana and word breaks:** Readings in 《》 brackets and spaces between words.
- **Plain term lookup:** Explains official terms like 住民票 simply.
- **Primary-source links:** Returns go.jp and e-Gov links for citation.
- **Verification dates:** Each response includes last_verified and a disclaimer.
- **Remote or npm:** Use the hosted endpoint or run the zero-dependency package.

## Good for

- Explain a moving-in notice to a foreign resident in simple Japanese
- Look up what an official term means in plain words
- Pull disaster-preparedness guidance for a multilingual helpline
- Cite the official source behind an answer
- Build a chatbot for municipal staff helping newcomers

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http yasashii-org-mcp https://mcp.yasashii.org/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.yasashii.org/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "yasashii-org-mcp": {
      "url": "https://mcp.yasashii.org/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "yasashii-org-mcp": {
      "type": "http",
      "url": "https://mcp.yasashii.org/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "yasashii-org-mcp": {
      "serverUrl": "https://mcp.yasashii.org/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "yasashii-org-mcp": {
      "type": "http",
      "url": "https://mcp.yasashii.org/mcp"
    }
  }
}
```

## Tools

- `list_documents`: List documents with id, summary and verification tier, optionally by category.
- `get_document`: Full document text with furigana, term explanations and primary-source links.
- `search_terms`: Easy Japanese explanations of official terms.
- `get_meta`: API metadata.

## FAQ

### Is it an official government source?

No. The site says it is not a government website and official pages take precedence.

### What license is the content under?

CC BY 4.0 with attribution to yasashii.org; the code is MIT.

### Do I need to sign in?

No. The remote endpoint at mcp.yasashii.org/mcp is free and needs no authentication.

### How is the text formatted?

Markdown with furigana in 《》 brackets and half-width spaces as word breaks.

### Is yasashii.org free?

Yes. yasashii.org is free to use.

### How do I add yasashii.org to Claude Code?

Run this command in your terminal: claude mcp add --transport http yasashii-org-mcp https://mcp.yasashii.org/mcp

### What are the best alternatives to yasashii.org?

The closest alternatives to yasashii.org are NY LLC Publication (FileMyPublication), TribuJus, SupplyClub Catalog, SynomosAI Governance MCP and MedXpert 标准检索连接器.

## Alternatives

- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [SupplyClub Catalog](https://ai-powered.com/mcp/supplyclub-catalog): SupplyClub Catalog is a free MCP server for legal and government.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/yasashii-org
