Example prompts

• What does “gemas” mean according to KBBI?

• Apa arti kata “mempunyai”? Apa kata dasarnya?

• Explain “layarnya tidak makan” using KBBI.

Getting started

The server runs locally over stdio with uv’s uvx; no API key or account is needed. Most clients accept this standard config:

{
    "mcpServers": {
        "kbbi": {
            "command": "uvx",
            "args": ["kbbi-mcp"]
        }
    }
}

claude mcp add kbbi -- uvx kbbi-mcp

codex mcp add kbbi -- uvx kbbi-mcp

gemini mcp add kbbi uvx kbbi-mcp

code --add-mcp '{"name":"kbbi","command":"uvx","args":["kbbi-mcp"]}'

Tools

• kbbi_lookup: Look up an Indonesian word or phrase in KBBI. Returns each headword with its homograph number, pronunciation, root words, and senses (labels such as the word class, the definition, and examples with their meanings). Read-only.

  • query (string, required): a word or phrase, e.g. makan or rumah sakit

An empty query or a failed lookup (e.g. KBBI unreachable) is returned as a tool error. The full result structure is published as the tool’s outputSchema (kbbi_mcp.types in Python).

Resources

• kbbi://{query}: the same result as kbbi_lookup, as JSON (e.g. kbbi://makan).

Configuration

Optional environment variables:

• KBBI_TIMEOUT_SECONDS (default: 10.0): timeout for each request to KBBI

• KBBI_LOG_LEVEL (default: INFO): level of the server’s logs, written to stderr

• KBBI_BASE_URL (default: https://kbbi.kemendikdasmen.go.id): the KBBI site to query

For example, with Claude Code: claude mcp add kbbi -e KBBI_TIMEOUT_SECONDS=20 -- uvx kbbi-mcp. In the standard config, add an "env": {"KBBI_TIMEOUT_SECONDS": "20"} object next to "args".

Limitations

• Lookups are anonymous. KBBI shows etymology, related entries, and suggestions for missing words only to signed-in users, so they are not returned. When nothing is found, try the base word or another spelling.

• Each lookup fetches https://kbbi.kemendikdasmen.go.id/entri/{query}. KBBI limits anonymous searches, so avoid rapid bulk lookups. Results are cached in memory while the server runs.

• The result depends on KBBI’s page markup; if KBBI changes it, parsing may break until this package is updated.

Debugging

Use the MCP Inspector:

npx @modelcontextprotocol/inspector uvx kbbi-mcp

Development

With uv installed, run the server over stdio from a checkout:

uv run kbbi-mcp

To point an MCP client at the checkout, use uv with --directory (an absolute path to your clone):

{
    "mcpServers": {
        "kbbi-dev": {
            "command": "uv",
            "args": ["--directory", "/path/to/kbbi-mcp", "run", "kbbi-mcp"]
        }
    }
}

Checks (see AGENTS.md):

uv sync --frozen --group dev
uv run ruff format .
uv run ruff check .
uv run ty check
uv run pytest

Tests use saved KBBI pages in tests/fixtures and make no network requests. Set KBBI_MCP_RUN_NETWORK_TESTS=1 to also run a live smoke test.

Related projects

• kbbi.mbt: a MoonBit library, CLI, and agent skill for KBBI. The parser and output schema of this server follow it.

• kbbi-python: a Python library and CLI for KBBI.

Disclaimer

This project is unofficial and is not affiliated with or endorsed by the Language Development and Cultivation Agency (Badan Bahasa) or KBBI Daring. Dictionary content belongs to its copyright holders; see KBBI’s legal notice. This server is meant for personal, non-commercial lookups. You are responsible for how you use the results.

License

BlueOak-1.0.0.