{"ok":true,"service":"akn-spec-api","version":"1.0.0","description":"Read-only REST API for the Akoma Ntoso (LegalDocML) specification knowledge base. The same static snapshot is served by the MCP endpoint at mcp.akn.kr.","base_url":"https://api.akn.kr","mcp_url":"https://mcp.akn.kr/mcp","agent_url":"https://api.akn.kr/agent.json","llms_txt":"https://api.akn.kr/llms.txt","content_version":"2026.10.02-15127ed","auth":"none","format":"JSON envelope: {ok, data, meta} or {ok:false, error}","workflow":"search -> get -> tools verify","agent":{"name":"AKN Spec API","description":"Read-only REST API for the Akoma Ntoso (LegalDocML) specification knowledge base. Use it to find vocabulary objects, specification documents, and section chunks, then read and verify the selected result before answering.","url":"https://api.akn.kr","mcp":"https://mcp.akn.kr/mcp","api_version":"v1","auth":"none","workflow":["Search first: GET /v1/search?q=...&mode=keyword for exact tag/ID names; use semantic or hybrid for concepts.","Read the selected result: GET /v1/get?type=object|document|chunk&id=...","Inspect structure when needed: GET /v1/tools?action=relations&id=...&depth=1","Verify before quoting or citing: GET /v1/tools?action=verify&id=...","If a search returns no results, shorten the query, change scope, or retry with keyword mode."],"rules":["Do not invent definitions, descriptions, schema fragments, or citations.","Always cite title + spec_version + URL. Prefix site-editorial content with [site editorial].","If a lookup returns not_found, say so instead of guessing.","Search is top-N only; there is no offset or pagination.","Keyword is the default. Semantic and hybrid are opt-in and English-only.","Use tools?action=verify before quoting; a failed verification is a real answer."],"endpoints":{"search":"GET /v1/search?q=article&mode=keyword&limit=10","get":"GET /v1/get?type=object&id=elements/article","tools":"GET /v1/tools?action=list&kind=elements&limit=20","help":"GET /v1/help?action=stats","openapi":"GET /v1/openapi.json","agent":"GET /agent.json","llms":"GET /llms.txt"},"examples":["curl 'https://api.akn.kr/v1/search?q=hierarchy&mode=hybrid&limit=5'","curl 'https://api.akn.kr/v1/get?type=object&id=elements/article'","curl 'https://api.akn.kr/v1/tools?action=relations&id=elements/article&depth=1'","curl 'https://api.akn.kr/v1/tools?action=verify&id=elements/article'"],"limitations":["Read-only, stateless, no sessions or writes.","The semantic index is English-only.","Some AKN concepts (for example the informal synonym 'tag') may not resolve to a vocabulary object; browse with tools?action=list when needed."]},"endpoints":{"search":"GET /v1/search?q=article&mode=keyword&limit=10","get":"GET /v1/get?type=object&id=elements/article","tools":"GET /v1/tools?action=list&kind=elements&limit=20","help":"GET /v1/help?action=stats","openapi":"GET /v1/openapi.json","agent":"GET /agent.json","llms":"GET /llms.txt"},"examples":["curl 'https://api.akn.kr/v1/search?q=hierarchy&mode=hybrid&limit=5'","curl 'https://api.akn.kr/v1/get?type=object&id=elements/article'","curl 'https://api.akn.kr/v1/tools?action=relations&id=elements/article&depth=1'","curl 'https://api.akn.kr/v1/tools?action=verify&id=elements/article'"]}