Relationship to KBBI Daring

This project is unofficial and is not affiliated with or endorsed by the official KBBI Daring service.

Features

• MCP tool: kbbi_lookup(query: str)

• MCP resource: kbbi://{query} (same payload as kbbi_lookup)

• No login/auth flow required

• Uses official KBBI VI Daring by default

Configure in an MCP client (JSON)

Most MCP clients (including Claude Desktop) use a JSON config with a top-level mcpServers object. This mcpServers format is an emergent standard across the MCP ecosystem (see: https://gofastmcp.com/integrations/mcp-json-configuration.md).

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

uv run kbbi-mcp

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

Tool: kbbi_lookup

Input

• query (string): a word or phrase

Example tool arguments:

{
    "query": "makan"
}

Output

Returns a JSON object:

• found (bool): whether entries is non-empty

• query (string): the trimmed query

• url (string): the KBBI page that was read

• entries (list): one item per headword; homographs such as makan¹ and makan² are separate entries

• suggestions (list of strings): similar headwords, only when nothing was found

Each entry has:

• headword (string): syllable dots removed (ma.kan → makan)

• homograph (int | null): the superscript number, if any

• pronunciation (string | null): e.g. /gêmas/

• root_words (list of strings): e.g. ["punya"] for mempunyai

• senses (list), in page order, each with:

  • labels: {code, name, description} for word classes (v, n, …) and usage labels (ki, Tas, …)

  • gloss (string): the definition text

  • examples: {text, meaning}; -- or ~ in text stands for the headword, and meaning (string | null) explains idiomatic examples

Every key is always present (null or an empty list when absent), so the output shape is stable.

An empty query or a failed lookup (e.g. KBBI unreachable) is reported as an MCP tool error (isError: true) with a message, not as a JSON payload.

Example tool output:

{
    "found": true,
    "query": "gemas",
    "url": "https://kbbi.kemendikdasmen.go.id/entri/gemas",
    "entries": [
        {
            "headword": "gemas",
            "homograph": null,
            "pronunciation": "/gêmas/",
            "root_words": [],
            "senses": [
                {
                    "labels": [
                        {
                            "code": "a",
                            "name": "Adjektiva",
                            "description": "kata yang menjelaskan nomina atau pronomina"
                        }
                    ],
                    "gloss": "sangat jengkel (marah) dalam hati",
                    "examples": [
                        {
                            "text": "saya sangat -- pada anak itu karena selalu mengotori lantai",
                            "meaning": null
                        }
                    ]
                },
                {
                    "labels": [
                        {
                            "code": "a",
                            "name": "Adjektiva",
                            "description": "kata yang menjelaskan nomina atau pronomina"
                        }
                    ],
                    "gloss": "sangat suka (cinta) bercampur jengkel; jengkel-jengkel cinta",
                    "examples": [
                        {
                            "text": "-- aku melihat anak ini",
                            "meaning": null
                        }
                    ]
                }
            ]
        }
    ],
    "suggestions": []
}

Resource: kbbi://{query}

This server also exposes the same payload as a read-only MCP resource (application/json).

• kbbi://makan

For low-level debugging, a client would read it using resources/read with {"uri": "kbbi://makan"}.

Data source

Lookup behavior:

• Official source: https://kbbi.kemendikdasmen.go.id/entri/{query}

Optional environment variables:

• KBBI_BASE_URL (default: https://kbbi.kemendikdasmen.go.id)

• KBBI_TIMEOUT_SECONDS (default: 10.0)

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