Back to the catalog

OSRS Calc MCP

OSRS Calculator plans XP, actions, hours, and time to a target level across skills, with combat

Open source Open in the app JSON README (API)

About

OSRS Calculator plans XP, actions, hours, and time to a target level across skills, with combat

Details

Kind
MCP servers
Topic
No topic detected
Publisher
rocnubie
Origin
official
Category
ferramentas
Transport
desconhecido
Version
0.1.0
Last push
2026-07-28T14:41:29Z
Repository state
ativo
Language
JavaScript
License
MIT
Added
2026-08-29 04:01:19
Updated
2026-08-29 04:01:19
Origin id
io.github.rocnubie/osrs-calc-mcp

README

# 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

More