Skip to content
MCP server

Bunpro

Read your Bunpro study queue, JLPT progress and grammar points from an assistant

Runs locally
Install
Pricing
Free
Platforms
CLI, self-hosted
Runs
Locally
Version
1.0.1
Listing updated
4 days ago

Similar MCP servers

About Bunpro

Bunpro is a free MCP server for language learning. It runs locally on your machine and is started by your AI client.

This server logs in to a Bunpro account with an email and password, then reads data through Bunpro's frontend API. Login happens once at startup using the site's sign-in form, and the resulting token lasts about two days. Credentials are supplied as environment variables, so the account details sit in your client configuration.

Twelve tools are read-only and none changes Bunpro data. They cover the profile and streak, due review counts, deck settings, study statistics, JLPT N5 to N1 progress, hourly or daily review forecasts, SRS stage counts from beginner to master including ghosts, 30 days of review activity, paginated review items at a chosen stage, and details for a single grammar point or vocabulary word including pitch accent and JMDict entries.

It is a Go stdio server available as a prebuilt binary, MCPB bundle or source build. A free or paid Bunpro account works.

Install

Run in a terminal

claude mcp add bunpro-mcp --env BUNPRO_EMAIL='<BUNPRO_EMAIL>' --env BUNPRO_PASSWORD='<BUNPRO_PASSWORD>' -- npx -y https://github.com/jbeshir/mcp-servers/releases/download/bunpro-v1.0.1/bunpro-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "bunpro-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/jbeshir/mcp-servers/releases/download/bunpro-v1.0.1/bunpro-mcp.mcpb"
      ],
      "env": {
        "BUNPRO_EMAIL": "<BUNPRO_EMAIL>",
        "BUNPRO_PASSWORD": "<BUNPRO_PASSWORD>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "bunpro-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/jbeshir/mcp-servers/releases/download/bunpro-v1.0.1/bunpro-mcp.mcpb"
      ],
      "env": {
        "BUNPRO_EMAIL": "<BUNPRO_EMAIL>",
        "BUNPRO_PASSWORD": "<BUNPRO_PASSWORD>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "bunpro-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/jbeshir/mcp-servers/releases/download/bunpro-v1.0.1/bunpro-mcp.mcpb"
      ],
      "env": {
        "BUNPRO_EMAIL": "<BUNPRO_EMAIL>",
        "BUNPRO_PASSWORD": "<BUNPRO_PASSWORD>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "bunpro-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/jbeshir/mcp-servers/releases/download/bunpro-v1.0.1/bunpro-mcp.mcpb"
      ],
      "env": {
        "BUNPRO_EMAIL": "<BUNPRO_EMAIL>",
        "BUNPRO_PASSWORD": "<BUNPRO_PASSWORD>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "bunpro-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/jbeshir/mcp-servers/releases/download/bunpro-v1.0.1/bunpro-mcp.mcpb"
      ],
      "env": {
        "BUNPRO_EMAIL": "<BUNPRO_EMAIL>",
        "BUNPRO_PASSWORD": "<BUNPRO_PASSWORD>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • BUNPRO_EMAILBunpro account email addressRequired
  • BUNPRO_PASSWORDBunpro account passwordRequired

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

get_user
Profile: level, XP, streak and subscription status.
get_study_queue
Due grammar and vocabulary review counts.
get_decks
Deck settings, daily goals and batch sizes.
get_stats
Days studied, streak, accuracy and badges.
get_jlpt_progress
JLPT N5 to N1 progress with SRS stage counts.
get_review_forecast
Upcoming reviews by day or hour.
get_srs_overview
Aggregate SRS level counts.
get_review_activity
Daily review counts for about 30 days.
get_grammar_srs_details
Grammar review items at an SRS level.
get_vocab_srs_details
Vocabulary review items at an SRS level.
get_grammar_point
Grammar point meaning, structure, nuance and questions.
get_vocab
Vocabulary readings, pitch accent, frequency and JMDict entries.

What it does

Study queue
get_study_queue reports due grammar and vocabulary review counts.
JLPT progress
get_jlpt_progress shows N5 to N1 progress with SRS stage counts.
Review forecast
get_review_forecast predicts reviews by day or hour.
SRS stage listings
Paginated grammar and vocabulary items at a chosen SRS level.
Grammar and vocab detail
Meaning, structure, nuance, readings, pitch accent and frequency.
Read-only
No tool modifies Bunpro data.

Good for

  • Ask how many reviews are due today
  • See how far along each JLPT level is
  • Plan study around the upcoming review load
  • Look up a grammar point or word while chatting
  • Review which items are stuck at the beginner stage

Pricing

Free

Free to run; needs a Bunpro account

Bunpro FAQ

Is it read-only?

Yes. The README says no tool modifies Bunpro data.

What account do I need?

A Bunpro account, free or paid.

How does it sign in?

It uses your email and password through Bunpro's login flow at startup and keeps a token of about two days.

How many tools are there?

Twelve.

Is Bunpro free?

Yes. Bunpro is free to use.

How do I add Bunpro to Claude Code?

Run this command in your terminal: claude mcp add bunpro-mcp --env BUNPRO_EMAIL='<BUNPRO_EMAIL>' --env BUNPRO_PASSWORD='<BUNPRO_PASSWORD>' -- npx -y https://github.com/jbeshir/mcp-servers/releases/download/bunpro-v1.0.1/bunpro-mcp.mcpb

What are the best alternatives to Bunpro?

The closest alternatives to Bunpro are WaniKani, Japanese Skills · 言の葉, Hachimo, HanyuGuide and Bilingual Mix.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers