osrs-calc-mcp

# OSRS Calc MCP Server

> OSRS Calculator - XP, Goals and Time to 99 | OSRS Calc

[![MCP Badge](https://lobehub.com/badge/mcp/rocnubie-osrs-calc-mcp)](https://lobehub.com/mcp/rocnubie-osrs-calc-mcp)
[![Stdio Transport](https://img.shields.io/badge/transport-stdio-6e6e6e)](https://modelcontextprotocol.io/specification)
[![Node](https://img.shields.io/badge/node-%3E%3D18-339933?logo=node.js&logoColor=white)](https://nodejs.org)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
[![Read Only](https://img.shields.io/badge/server-read--only-2ea44f)](#tools)
[![MCP](https://img.shields.io/badge/MCP-1.0-blue)](https://modelcontextprotocol.io)

A Model Context Protocol server that exposes the canonical OSRS Calc knowledge surface — calculators, training plans, and reference data, FAQ, official links — to MCP-compatible AI clients such as Claude Desktop, Cursor, Windsurf, and Continue. Read-only, no API keys, no quota, ~50 ms cold start.

Official website: https://osrs-calc.com

## 🧮 About OSRS Calc

OSRS Calc is a browser-based Old School RuneScape planning toolkit. Its skill calculators estimate XP, actions, hours, and time to a target level across 24 skills, including Sailing.

The site also exposes DPS, Max Hit, Dry, Combat Level, prices, and wiki reference tools. This MCP provides the public calculator catalog and data caveats as read-only context; it does not access a player's account or promise that prices and wiki data are current outside the live site.

Old School RuneScape, RuneScape, and related names are owned by their respective rights holders. Check the live calculator and OSRS Wiki sources before making an in-game decision.

## Tools

### `get_calculator_overview`
Return the calculator workflows and reference-data boundaries the site exposes. (OSRS Calc)

_Input:_ no parameters. _Returns:_ text/markdown.

### `get_official_links`
Return the canonical list of official links for OSRS Calc (website, support, docs when available).

_Input:_ no parameters. _Returns:_ text/markdown.

## Resources

- `site://osrs-calc/calculators` — Public calculator workflows, training targets, and reference-data boundaries.
- `site://osrs-calc/faq` — Short FAQ generated from public site metadata.
- `site://osrs-calc/links` — Canonical URLs to share with users.

## Prompts

### `tell_me_about_osrs_calc`
Summarize what the site is, who it's for, and how it works. — OSRS Calc

### `plan_a_calculation_osrs_calc`
Choose a calculator workflow while respecting the site's data scope. — OSRS Calc

## Installation

### Install via Smithery

```bash
npx -y @smithery/cli install osrs-calc-mcp --client claude
```

(Replace `claude` with `cursor`, `windsurf`, or `continue` for those clients.)

### Install from source

```bash
git clone https://github.com/rocnubie/osrs-calc-mcp.git
cd osrs-calc-mcp
pnpm install
```

Then add to your MCP client config (`claude_desktop_config.json` for Claude Desktop, `mcp.json` for Cursor / Windsurf / Continue):

```json
{
  "mcpServers": {
    "osrs-calc-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/osrs-calc-mcp/src/index.mjs"
      ]
    }
  }
}
```

### Debug with MCP Inspector

```bash
npx @modelcontextprotocol/inspector node src/index.mjs
```

## Official Links

- Website: https://osrs-calc.com

## Development

```bash
pnpm install
pnpm start                 # run the server over stdio
```

## License

MIT