Bunpro
Read your Bunpro study queue, JLPT progress and grammar points from an assistant
- 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.mcpbAdd 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 addressRequiredBUNPRO_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.
