# Bunpro

> Bunpro is a free MCP server for language learning. Read your Bunpro study queue, JLPT progress and grammar points from an assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/jbeshir/mcp-servers/tree/HEAD/bunpro
- **MCP Registry name:** io.github.jbeshir/bunpro-mcp
- **Categories:** [language learning](https://ai-powered.com/categories/language-learning), [education and exams](https://ai-powered.com/categories/education-and-exams)
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [WaniKani](https://ai-powered.com/mcp/wanikani): WaniKani is an MCP server for language learning.
- [Japanese Skills · 言の葉](https://ai-powered.com/mcp/japanese-skills): Japanese Skills · 言の葉 is a freemium MCP server for language learning.
- [Hachimo](https://ai-powered.com/mcp/hachimo): Hachimo is a paid MCP server for language learning.
- [HanyuGuide](https://ai-powered.com/mcp/hanyuguide): HanyuGuide is a freemium MCP server for language learning.
- [Bilingual Mix](https://ai-powered.com/mcp/bilingual-mix-2): Bilingual Mix is a freemium MCP server for language learning.
- [Study Planner MCP](https://ai-powered.com/mcp/study-planner-mcp): Study Planner MCP is an open-source MCP server for education and exams.
- [NuBerea](https://ai-powered.com/mcp/nuberea): NuBerea is a freemium MCP server for religion.
- [Replio](https://ai-powered.com/mcp/replio): Replio is a freemium MCP server for education and exams.

---
Source: https://ai-powered.com/mcp/bunpro
