Skip to main content
Glama
rocnubie

osrs-calc-mcp

by rocnubie

OSRS Calc MCP Server

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

MCP Badge Stdio Transport Node License: MIT Read Only MCP

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.

Related MCP server: Wiki OSRS MCP

Tools

get_calculator_overview

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

Input: no parameters. Returns: text/markdown.

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

Development

pnpm install
pnpm start                 # run the server over stdio

License

MIT

Available Tools

2 tools
get_calculator_overviewA

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

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description indicates a read-only retrieval (via 'Return'), but lacks details on authentication, rate limits, or other behavioral traits.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The single sentence is concise and front-loaded, containing all essential information without superfluous text.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no parameters or output schema, the description is largely complete for a simple retrieval, though the terms 'workflows' and 'reference-data boundaries' could be slightly ambiguous.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With zero parameters and 100% schema coverage, the description adequately conveys no additional input is needed, earning the baseline of 4.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool returns 'calculator workflows and reference-data boundaries' with context 'OSRS Calc', which distinguishes it from the sibling tool 'get_official_links'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage when one needs calculator workflows and boundaries, but no explicit guidance on when to avoid this tool or compare with alternatives is provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 2 tool updatesv0.1.0
    • First observedget_calculator_overview
    • First observedget_official_links

TDQS

A3.9/5.0

Scored across 2 tools

Disambiguation5/5

The two tools have clearly distinct purposes: one provides an overview of calculator workflows, the other returns official links. No overlap or ambiguity.

Naming Consistency5/5

Both tools follow a consistent 'get_' prefix pattern, making the naming predictable and uniform.

Tool Count2/5

With only two informational tools, the server feels severely under-scoped for a 'calculator' server. Users would expect actual calculation tools.

Completeness1/5

The server name suggests calculations, but no actual calculation tools are provided. The two tools only offer metadata (overview and links), leaving a massive gap in core functionality.

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    Enables access to RuneScape 3 data including real-time Grand Exchange prices, item information, historical price trends, and player statistics. Supports multiple game modes and provides comprehensive RuneScape Wiki API integration through natural language.
    12
    MIT
  • F
    license
    A
    quality
    C
    maintenance
    Exposes Old School RuneScape account data (quests, skills, diaries, etc.) via WikiSync and official HiScores, allowing Claude to query player progress without manual copy-pasting.
    2
    -