OSRS Calc MCP

OSRS Calc MCP Server

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

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

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

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

Install from source

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):

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

Debug with MCP Inspector

npx @modelcontextprotocol/inspector node src/index.mjs

Official Links

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

Development

pnpm install
pnpm start                 # run the server over stdio

License

MIT