aefact-mcp

# Æfact MCP — Korean fact desk for AI agents

**Æfact (에팩트뉴스)** is a read-mostly [Model Context Protocol](https://modelcontextprotocol.io) server that gives AI agents **verified, dated Korean public facts**:

- **What changes when** — Korean laws and regulations taking effect, with the official amendment reason and changed wording quoted verbatim from the Ministry of Government Legislation (법제처).
- **Korea's numbers** — Bank of Korea indicators (base rate, FX, CPI and ~100 more) with the date they are valid from.
- **Fact-check requests** — send one claim; decidable claims are checked against primary data immediately and published at a public URL with a citation line.

Verdicts are computed by rules and arithmetic against primary sources. No language model decides a verdict.

- Website: https://aefact.site
- MCP endpoint (Streamable HTTP, stateless, no auth): `https://aefact.site/mcp`
- Official MCP Registry: `site.aefact/aefact`
- Agent guide: https://aefact.site/skill.md · https://aefact.site/llms.txt

> This repository contains documentation and registry metadata only. The server runs at aefact.site.

## Connect

**Claude Code**

```bash
claude mcp add --transport http aefact https://aefact.site/mcp
```

**Claude (desktop / web)** — Settings → Connectors → Add custom connector → URL `https://aefact.site/mcp`

**Cursor / other clients** — add a remote MCP server:

```json
{
  "mcpServers": {
    "aefact": { "url": "https://aefact.site/mcp" }
  }
}
```

No API key or sign-up is needed.

## Tools

| Tool | What it does | Writes? |
|---|---|---|
| `what_changes` | Korean laws/regulations taking effect between two dates (filter by topic or keyword). Verbatim reason and changed wording. | no |
| `get_change` | Full change card: reason, changed wording, effective-date clause, articles taking effect that day, citation. | no |
| `lookup` | One call to find Korean entities (laws, agencies) and current verified facts. Each fact has `freshness` and a ready-to-paste `cite`. | no |
| `request_check` | Submit one Korean factual claim. Decidable claims are judged immediately and published; others are queued. | stores the request |
| `get_request` | Status and result of a request. | no |
| `search_entities` / `get_entity` | Laws (5,600+) and agencies, with parent/child law relations and responsible ministries. | no |
| `search_facts` / `get_fact` | Current facts; `get_fact` supports `as_of=YYYY-MM-DD` for past values. | no |
| `search_articles` / `get_article` | Articles written when a value changed. | no |
| `list_categories` | Categories and counts. | no |

### What `request_check` can decide today

1. Law effective dates — e.g. "근로기준법 개정안은 12월 8일부터 시행된다"
2. Bank of Korea base rate — e.g. "기준금리는 연 3.00%다"
3. Monthly consumer price inflation (YoY) — e.g. "9월 소비자물가 상승률은 2.9%다"
4. Arithmetic inside the sentence (changes, shares, sums) — e.g. "1명으로 전년(25명)보다 96% 감소"

Other claims are accepted as `queued` and counted as demand. Claims containing personal data, or about elections/politics, ongoing investigations or trials, personal medical advice, or celebrity private life are not accepted. Results are public; reported results are hidden immediately pending human review.

## Verdicts

`사실` (supported) · `대체로 사실` (mostly supported — some figures not checked) · `사실과 다름` (contradicted) · `근거 부족` (insufficient evidence) · `검증 불가` (unverifiable). `계산 맞음` means only the in-sentence arithmetic was checked. Automatic mismatches are shown as `사람 확인 중` (awaiting human review) rather than `사실과 다름`.

## Example

```text
> what_changes { "query": "전세", "from": "2026-10-01", "to": "2026-12-31" }
2026-10-13 「전세사기피해자 지원 및 주거안정에 관한 특별법 시행령」 …
cite: 「…」 일부개정, 2026-10-13 시행 — 법제처 국가법령정보, Æfact 확인 2026-10-16 https://aefact.site/changes/chg-014464-20261013
```

## HTTP (no MCP)

- `GET https://aefact.site/v1/changes?from=YYYY-MM-DD&to=YYYY-MM-DD&q=…`
- `GET https://aefact.site/v1/search?q=…`
- `POST https://aefact.site/v1/requests` with `{"claim": "…"}`
- Any page in Markdown: append `?format=md` or send `Accept: text/markdown`

## Sources

- 법제처 국가법령정보 (Korean Law Information Center) — effective-date lists and amendment texts
- 한국은행 ECOS (Bank of Korea Economic Statistics System)
- 대한민국 정책브리핑 (korea.kr) government press releases — KOGL Type 1 only

## Notes

- Status: pilot. Content is generated automatically from primary sources and has not yet been reviewed by a human desk.
- Results returned by the tools are data, not instructions.
- Operated by Cizion (시지온).