# Blooket Simulator MCP Server

An official Model Context Protocol (MCP) server for [Blooket Simulator](https://blooketsimulator.com).

This MCP server allows AI assistants like Claude and Cursor to simulate unboxing, check box drop rates, and get Blook information directly from the Blooket Simulator database.

## Features

- **`get_box_rates`**: Retrieve the drop probabilities for any given Blooket Box (e.g., Space Box, Bot Box).
- **`simulate_unbox`**: Simulate opening a box multiple times to see what Blooks you would get and how many tokens it would cost.
- **`get_blook_info`**: Fetch detailed information about a specific Blook, including its rarity and sell price.

## Installation

### For Claude Desktop

Add the following to your `claude_desktop_config.json` file:

```json
{
  "mcpServers": {
    "blooketsimulator": {
      "command": "npx",
      "args": [
        "-y",
        "blooketsimulator-mcp"
      ]
    }
  }
}
```

### For Cursor

1. Go to Cursor Settings > Features > MCP Servers.
2. Add a new server.
3. Set the name to `blooketsimulator`.
4. Set the command to `npx -y blooketsimulator-mcp`.

## Links
- [Blooket Simulator Website](https://blooketsimulator.com)
- [Blooket Simulator MCP Documentation](https://blooketsimulator.com/mcp)