Skip to main content
Glama

Jisho MCP

A lightweight Model Context Protocol (MCP) server for Jisho.org, the popular Japanese-English dictionary.

Look up Japanese words, readings, JLPT levels, and definitions directly inside MCP-compatible AI clients — or let your agent search for you.

Features

  • Word search with all Jisho filters (#jlpt-n5, #verb, wildcards, etc.)

  • Exact lookup by word slug (e.g. 食べる)

  • Compact responses (Wikipedia/dbpedia padding stripped, linguistic fields like see_also, antonyms, source preserved)

  • Read-only resources: jisho://word/{keyword} and jisho://search/{keyword}

Related MCP server: Yomitan MCP Server

Quick start

No installation required. You only need uv and Python >= 3.10.

Claude Code

claude mcp add jisho -- uvx --from git+https://github.com/giuliocapecchi/jisho-mcp jisho-mcp

Other MCP clients (Claude Desktop, Codex, OpenCode, …)

Add the following block to your client's MCP config file:

{
  "mcpServers": {
    "jisho": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/giuliocapecchi/jisho-mcp", "jisho-mcp"]
    }
  }
}

Common config locations:

Client

Config file

Claude Desktop

claude_desktop_config.json

Codex (OpenAI)

~/.codex/config.json

OpenCode

opencode.json

Permanent install

If you prefer a system-wide command:

uv tool install git+https://github.com/giuliocapecchi/jisho-mcp

Then run directly:

jisho-mcp

Or add to your MCP config:

{
  "mcpServers": {
    "jisho": {
      "command": "jisho-mcp"
    }
  }
}

Development

git clone https://github.com/giuliocapecchi/jisho-mcp.git
cd jisho-mcp
uv sync
uv run jisho-mcp

Tools

Tool

Description

search_words(keyword, page=1)

Search dictionary entries.

get_word(slug)

Fetch the entry with the exact slug, or None if no exact match.

Example

get_word("水") returns:

{
  "slug": "水",
  "is_common": true,
  "jlpt": ["jlpt-n5"],
  "japanese": [{"word": "水", "reading": "みず"}],
  "senses": [
    {
      "english_definitions": ["water (esp. cool or cold)"],
      "parts_of_speech": ["Noun"],
      "see_also": ["湯 ゆ"]
    },
    {
      "english_definitions": ["fluid (esp. in an animal tissue)", "liquid"],
      "parts_of_speech": ["Noun"]
    }
  ]
}

License

MIT

Available Tools

2 tools
get_wordA

Look up a single word by its exact Jisho slug.

Returns None if no entry with that exact slug exists. Note: Jisho has no by-slug endpoint, so this performs a keyword search and filters for an exact slug match. For fuzzy lookup, use search_words.

Inputs: slug (required). Returns: result

search_wordsA

Search Jisho.org for words matching a keyword.

Supports all Jisho search filters, e.g. #jlpt-n5, #verb, 水, or English terms like water.

Inputs: keyword (required), page. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 2 tools

    Disambiguation4/5

    The two tools have distinct purposes: search_words is for flexible keyword/filtered searches, while get_word is for exact slug lookup. They overlap slightly since get_word performs a search internally, but the descriptions clearly differentiate them and guide users to the appropriate tool.

    Naming Consistency5/5

    Both tool names follow a consistent verb_noun pattern: search_words and get_word. The verbs are clear and the pattern is predictable, making it easy to infer tool behavior from the name.

    Tool Count3/5

    With only two tools, the server feels slightly thin for a language dictionary service, though it covers the core search and exact-lookup needs. The count is borderline appropriate for a focused Jisho wrapper but leaves little room for other operations.

    Completeness4/5

    The server covers the primary lookup workflows: searching with filters and retrieving a specific word by slug. It lacks dedicated tools for related features like kanji details or example sentences, but most dictionary needs are met through the search functionality.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides AI agents with direct access to local Yomitan dictionary databases for offline Japanese vocabulary lookups, kanji searches, and sentence tokenization. It leverages the Yomitan browser extension's API to enable rich dictionary interactions and Anki flashcard field generation.
      5
      48 npm
      6
      Mozilla Public 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables ChatGPT to interact with ZpDIC dictionaries, allowing word lookup, creation, deletion, and overwriting through natural language.
      ISC
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables searching and retrieving anime and manga data from MyAnimeList via the Jikan API, including anime details, top rankings, and character information.
      140 npm
      MIT