Bunpro MCP Server

Bunpro MCP

A read-only Model Context Protocol server that lets MCP clients work with your Bunpro profile, review queue, forecasts, SRS progress, vocabulary, learning content, and search.

[!WARNING]

This project uses Bunpro's unofficial, reverse-engineered frontend API. It may change without notice. This project is not affiliated with or endorsed by Bunpro.

What you can do

• Ask for your profile, due count, review queue, or current quiz questions.
• Inspect JLPT progress, SRS levels, forecasts, activity, and last-session accuracy.
• Search Bunpro grammar and vocabulary with compact results.
• Retrieve vocabulary details and notes, deck learning content, or topic replies.

The server exposes no account-changing, review-submission, or deletion tools.

Requirements

• A Bunpro account and a current frontend bearer token.
• Node.js 22 or newer when running from source or through npx.
• An MCP client that supports local stdio servers.

Get your Bunpro token

1. Sign in to Bunpro in your browser.
2. Open the browser developer tools and select Network.
3. Select a request to https://api.bunpro.jp/api/frontend/....
4. Copy the Authorization request header value without the Bearer prefix.

Treat this token like a password. Do not commit it, paste it into issues, or expose it in screenshots.

Configure an MCP client

Install and launch the published package directly from your MCP client:

{
  "mcpServers": {
    "bunpro": {
      "command": "npx",
      "args": ["-y", "bunpro-mcp-server"],
      "env": { "BUNPRO_API_TOKEN": "your-token" }
    }
  }
}

For local development, build the repository and configure the client with an absolute path:

{
  "mcpServers": {
    "bunpro": {
      "command": "node",
      "args": ["/absolute/path/to/bunpro-mcp-server/dist/index.js"],
      "env": { "BUNPRO_API_TOKEN": "your-token" }
    }
  }
}

Restart the MCP client after changing its configuration or rebuilding the server.

Run locally

npm ci
npm run build
BUNPRO_API_TOKEN='your-token' node dist/index.js

The last command starts an MCP stdio process and waits for protocol messages; it has no interactive prompt. Prefer the MCP client's environment configuration so the token does not enter shell history.

Example requests

• “Show my Bunpro profile.”
• “How many reviews are due?”
• “Show my hourly review forecast.”
• “Search Bunpro vocabulary for 日本語.”
• “What was my last review-session accuracy?”

Available tools

Exact inputs, outputs, defaults, and errors are in MCP contracts.

Configuration

Shortened. The full README is on GitHub.