RS3 MCP Server

MCP (Model Context Protocol) server that exposes RuneScape 3 data from the RuneMetrics, Grand Exchange, and RuneScape Wiki APIs. Works with any MCP-compatible client — Claude, Gemini, Cursor, and others.

Tools

RuneMetrics

Grand Exchange

RuneScape Wiki

Related MCP server: Wiki OSRS MCP

Quick start

npm install
npm run build

HTTP mode (Claude, Gemini, web clients)

npm start
# Server listens on http://0.0.0.0:3001/mcp

Override the port with the PORT environment variable:

PORT=8080 npm start

stdio mode (Cursor, Claude Desktop)

npm run start:stdio

Client configuration

Cursor

Add to .cursor/mcp.json (or your global Cursor MCP config):

{
  "mcpServers": {
    "rs3": {
      "command": "node",
      "args": ["dist/index.js", "--stdio"],
      "cwd": "/path/to/RS3-MCP"
    }
  }
}

Or connect to the HTTP server:

{
  "mcpServers": {
    "rs3": {
      "url": "http://localhost:3001/mcp"
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "rs3": {
      "command": "node",
      "args": ["/path/to/RS3-MCP/dist/index.js", "--stdio"]
    }
  }
}

Claude (web) / Gemini / other HTTP clients

Point the client's MCP server URL to:

http://<host>:3001/mcp

The server uses Streamable HTTP transport with session management.

Development

npm run dev          # HTTP mode with hot reload (tsx)
npm run dev:stdio    # stdio mode with hot reload (tsx)

Health check

GET http://localhost:3001/health

Returns { "status": "ok", "server": "rs3-runemetrics", "version": "0.1.0" }.

Notes

• RuneMetrics and Grand Exchange endpoints are unofficial Jagex APIs — no auth required, but response shapes may change without notice.

• Players can make their RuneMetrics profile private; the server returns clear error messages when data is unavailable.

• The server sends a descriptive User-Agent header (RS3-MCP/0.1) with every request.