Bareun MCP Server — Korean NLP & Spell/Grammar Checking

바른(Bareun) is a Korean natural-language platform. This is its MCP (Model Context Protocol) server — it lets any MCP-compatible AI tool (Claude, Cursor, VS Code, Claude Desktop, …) perform Korean morphological analysis and spell/grammar correction by calling Bareun as a tool.

Large language models still miss the subtle spacing, particle agreement, and confusable-word rules of Korean. Plug Bareun in as an MCP tool and your agent can hand off analysis and proofreading to a dedicated Korean engine, then use the result to produce more accurate Korean output.

• Hosted endpoint: https://api.bareun.ai/mcp

• Transport: Streamable HTTP (JSON-RPC 2.0) — no SSE, no extra port, no install

• Auth: API key (api-key header or Authorization: Bearer <key>)

• Get an API key: https://bareun.ai

The /mcp endpoint is available on the spell-checker–included build of Bareun (the morphological-analysis-only build does not expose /mcp). The same endpoint works on self-hosted/on-prem installs — just swap the host.

Tools

correct_grammar options (all boolean, default off): treat_as_title, disable_split_sentence, disable_caret_spacing, disable_vx_spacing, enable_limited_punctuation, disable_confusion, enable_cleanup_whitespace, disable_typo_correction, enable_sentence_check.

encoding controls the unit for morpheme offsets: utf32 (default, code points — matches Python), utf16 (JS/Java), utf8 (bytes — Go/C++).

Related MCP server: mcp-korean-spell

Resources

Quick start

Tip — register globally. Most tools default to project scope (the server is only available in one project). To use Bareun across all your projects, register it at global / user scope as shown below.

Claude Code

# -s user → global: available in every project
claude mcp add -s user --transport http bareun https://api.bareun.ai/mcp \
  --header "api-key: YOUR_API_KEY"

Omit -s user for project-local scope. Check with claude mcp get bareun.

Cursor

Global: ~/.cursor/mcp.json · Project: <project>/.cursor/mcp.json

{
  "mcpServers": {
    "bareun": {
      "url": "https://api.bareun.ai/mcp",
      "headers": { "api-key": "YOUR_API_KEY" }
    }
  }
}

VS Code

Global: run MCP: Open User Configuration · Project: <project>/.vscode/mcp.json

{
  "servers": {
    "bareun": {
      "type": "http",
      "url": "https://api.bareun.ai/mcp",
      "headers": { "api-key": "YOUR_API_KEY" }
    }
  }
}

Claude Desktop — claude_desktop_config.json

Claude Desktop bridges header-authenticated remote servers via mcp-remote (Node.js required):

{
  "mcpServers": {
    "bareun": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.bareun.ai/mcp",
        "--header", "api-key: YOUR_API_KEY"
      ]
    }
  }
}

Test with MCP Inspector

npx @modelcontextprotocol/inspector

Set Transport to Streamable HTTP, URL to https://api.bareun.ai/mcp, and add header api-key: YOUR_API_KEY.

Example

// tools/call → analyze_syntax  (format: compact)
{ "text": "나는 학교에 간다.", "format": "compact" }
// → "나/NP 는/JX 학교/NNG 에/JKB 가/VV ㄴ다/EF ./SF"

Links

• Service: https://bareun.ai

• Docs: https://bareun.ai/docs

• MCP guide: https://bareun.ai/docs/howtouse/mcp

• API keys & usage: https://bareun.ai/docs/howtouse/cloud-api

License

The contents of this repository (documentation, registry manifests, examples) are released under the MIT License. The Bareun engine itself is a proprietary service operated by Baikal AI; access is governed by the bareun.ai terms of service.