RuneScape Wiki

Official12 tools

by birdwell · TypeScript

RS3 Grand Exchange prices, item lookup, player hiscores, and RuneScape Wiki content

This MCP server provides RuneScape-related data including RS3 Grand Exchange prices, item lookup, player hiscores, and RuneScape Wiki content. The server is identified by the slug io-github-birdwell-runescape-wiki-mcp and described as io.github.birdwell/runescape-wiki-mcp.

🛠️ Key Features

RS3 Grand Exchange prices
Item lookup
Player hiscores
RuneScape Wiki content

🚀 Use Cases

Retrieve RS3 market prices for items
Look up item details
Fetch player hiscores
Access RuneScape Wiki content relevant to items or topics

⚡ Developer Benefits

Consolidates multiple RuneScape data sources (prices, items, hiscores, wiki content) under one MCP server

⚠️ Limitations

Available capabilities are limited to what is described: prices, item lookup, player hiscores, and wiki content.

Topics

grand-exchangemcpmcp-servermodel-context-protocolrs3runescapeai-agentgamingrunescape-wikirunescape3

Captured live from the server via tools/list.

lookup_item

Resolve an item name to Grand Exchange ID and latest price. Uses exact name match first, then wiki opensearch. Prefer this before get_item_price when you only know the name.

Parameters2

query	string	required	Item name or partial name to search for
limit	integer	optional	Max matches to return (default 5)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Item name or partial name to search for"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Max matches to return (default 5)"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

get_item_graph

Read the public Jagex Grand Exchange daily price series for one item, about the last 180 days. Pass exactly one of itemId or name. No auth and no side effects. Use summarize_price_history for min, max, and average instead of the raw series.

Parameters2

itemId	integer	optional	Grand Exchange item ID (provide itemId or name)
name	string	optional	Item name (provide itemId or name)

Raw schema

{
  "type": "object",
  "properties": {
    "itemId": {
      "type": "integer",
      "minimum": 0,
      "description": "Grand Exchange item ID (provide itemId or name)"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Item name (provide itemId or name)"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

get_item_price

Get current Grand Exchange price, trends, and examine text for an item. Pass exactly one of itemId or name.

Parameters2

itemId	integer	optional	Grand Exchange item ID (provide itemId or name)
name	string	optional	Item name (provide itemId or name). Prefer lookup_item for fuzzy search.

Raw schema

{
  "type": "object",
  "properties": {
    "itemId": {
      "type": "integer",
      "minimum": 0,
      "description": "Grand Exchange item ID (provide itemId or name)"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Item name (provide itemId or name). Prefer lookup_item for fuzzy search."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

get_ge_info

Read Grand Exchange database metadata, including lastConfigUpdateRuneday. This is not item prices; use get_item_price or lookup_item for those. Takes no arguments. Public Jagex endpoint, no auth.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

get_category_info

Get letter counts for a Grand Exchange category. Use get_all_categories for IDs.

Parameters1

get_all_categories

List all RS3 Grand Exchange category IDs and names (0-43).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

browse_items

Browse the Grand Exchange catalogue by category and starting letter. This is NOT a name search — use lookup_item for that. Use # for numeric names.

Parameters3

category	integer	required	Category ID (0-43)
alpha	string	optional	Starting letter (a-z) or # for numbers. Defaults to "a".
page	integer	optional	Page number (starting from 1)

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "type": "integer",
      "minimum": 0,
      "maximum": 43,
      "description": "Category ID (0-43)"
    },
    "alpha": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1,
      "description": "Starting letter (a-z) or # for numbers. Defaults to \"a\"."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Page number (starting from 1)"
    }
  },
  "required": [
    "category"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

summarize_price_history

Summarize one item's recent Grand Exchange prices: min, max, average, change, and average daily volume. Pass exactly one of itemId or name, and optional days from 7 to 90 (default 30). Use get_item_graph for the full daily series.

Parameters3

itemId	integer	optional	Grand Exchange item ID (provide itemId or name)
name	string	optional	Item name (provide itemId or name)
days	integer	optional	Size of the trailing window in days (7-90, default 30)

Raw schema

{
  "type": "object",
  "properties": {
    "itemId": {
      "type": "integer",
      "minimum": 0,
      "description": "Grand Exchange item ID (provide itemId or name)"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Item name (provide itemId or name)"
    },
    "days": {
      "type": "integer",
      "minimum": 7,
      "maximum": 90,
      "description": "Size of the trailing window in days (7-90, default 30)"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

compare_items

Compare latest Grand Exchange prices for up to 10 items in one call. Provide either names or itemIds. Returns one row per entry with id, name, price, volume and timestamp; entries that cannot be resolved come back as error rows instead of failing the call.

Parameters2

names	array	optional	Item names to compare (1-10). Provide names or itemIds, not both.
itemIds	array	optional	Grand Exchange item IDs to compare (1-10). Provide names or itemIds, not both.

Raw schema

{
  "type": "object",
  "properties": {
    "names": {
      "type": "array",
      "minItems": 1,
      "maxItems": 10,
      "uniqueItems": true,
      "items": {
        "type": "string",
        "minLength": 1,
        "description": "Item name, e.g. \"Abyssal whip\""
      },
      "description": "Item names to compare (1-10). Provide names or itemIds, not both."
    },
    "itemIds": {
      "type": "array",
      "minItems": 1,
      "maxItems": 10,
      "uniqueItems": true,
      "items": {
        "type": "integer",
        "minimum": 0,
        "description": "Grand Exchange item ID"
      },
      "description": "Grand Exchange item IDs to compare (1-10). Provide names or itemIds, not both."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

estimate_flip

Estimate Grand Exchange flip profit after the 2% RS3 sales tax for an item, by itemId or name. This is an ESTIMATE ONLY: guide prices lag the live market, buy limits and fill times are not modelled, and actual profit will differ. Pass buyPrice/sellPrice to model your own offers.

Parameters5

itemId	integer	optional	Grand Exchange item ID (provide itemId or name)
name	string	optional	Item name (provide itemId or name). Prefer lookup_item for fuzzy search.
buyPrice	integer	optional	Buy price per item in coins. Defaults to the current market price.
sellPrice	integer	optional	Sell price per item in coins. Defaults to the current market price.
quantity	integer	optional	Number of items to flip (default 1)

Raw schema

{
  "type": "object",
  "properties": {
    "itemId": {
      "type": "integer",
      "minimum": 0,
      "description": "Grand Exchange item ID (provide itemId or name)"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Item name (provide itemId or name). Prefer lookup_item for fuzzy search."
    },
    "buyPrice": {
      "type": "integer",
      "minimum": 0,
      "description": "Buy price per item in coins. Defaults to the current market price."
    },
    "sellPrice": {
      "type": "integer",
      "minimum": 0,
      "description": "Sell price per item in coins. Defaults to the current market price."
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "description": "Number of items to flip (default 1)"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

get_player_stats

Get RS3 hiscores for a player. Normal mode works via Jagex index_lite. Ironman/hardcore use documented Jagex endpoints that currently return HTTP 404; the tool reports that clearly instead of falling back to normal data.

Parameters2

username	string	required	Player username to lookup
gameMode	string	optional	Hiscores board (default: normal)

Raw schema

{
  "type": "object",
  "properties": {
    "username": {
      "type": "string",
      "minLength": 1,
      "description": "Player username to lookup"
    },
    "gameMode": {
      "type": "string",
      "enum": [
        "normal",
        "ironman",
        "hardcore"
      ],
      "description": "Hiscores board (default: normal)",
      "default": "normal"
    }
  },
  "required": [
    "username"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

get_wiki_page_content

Fetch plain-text content of a RuneScape Wiki page. Follows redirects. Prefer exact titles; use lookup_item or wiki search when unsure.

Parameters1

page

string

required

Wiki page title (spaces allowed; redirects are followed)

Raw schema

{
  "type": "object",
  "properties": {
    "page": {
      "type": "string",
      "minLength": 1,
      "description": "Wiki page title (spaces allowed; redirects are followed)"
    }
  },
  "required": [
    "page"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

README.md4 KBView on GitHub

RuneScape Wiki MCP Server

A Model Context Protocol (MCP) server for RuneScape 3 Grand Exchange prices, item name lookup, player hiscores, and wiki page extracts.

Speaks MCP 2026-07-28 (stateless) via stdio and Streamable HTTP, with legacy 2025-era clients still supported.

Remote endpoint: https://runescape-wiki-mcp.fly.dev/mcp

Registry name: io.github.birdwell/runescape-wiki-mcp

Prerequisites

Node.js 20+
npm

Install / Build / Run

bash

npm install
npm run build
npm start          # stdio MCP server
npm test           # unit + protocol compliance
npm run inspector  # MCP Inspector

Connect

Remote (Streamable HTTP):

json

{
  "mcpServers": {
    "runescape-wiki": {
      "url": "https://runescape-wiki-mcp.fly.dev/mcp"
    }
  }
}

Local stdio:

json

{
  "mcpServers": {
    "runescape-wiki": {
      "command": "node",
      "args": ["/path/to/runescape-wiki-mcp/dist/index.js"]
    }
  }
}

Discovery:

Server card: https://runescape-wiki-mcp.fly.dev/mcp/server-card
AI Catalog: https://runescape-wiki-mcp.fly.dev/.well-known/ai-catalog.json

Tools

Tool	Purpose
`lookup_item`	Name → ID + latest price (Weirdgloop + wiki opensearch). Start here when you only know the name.
`get_item_price`	GE detail + trends by `itemId` or `name`
`get_item_graph`	180-day price graph by `itemId` or `name`
`summarize_price_history`	Compact 7–90 day trend summary (min/max/avg/change/volume)
`compare_items`	Bulk compare up to 10 items by `names` or `itemIds`
`estimate_flip`	Flip profit estimate after RS3 2% GE sales tax
`browse_items`	Catalogue browse by category + starting letter (not a name search)
`get_all_categories`	Category ID → name map (0–43)
`get_category_info`	Letter counts for one category
`get_ge_info`	GE database metadata (`lastConfigUpdateRuneday`)
`get_player_stats`	RS3 hiscores by username (`gameMode`: `normal` works; ironman/hardcore currently 404 from Jagex)
`get_wiki_page_content`	Plain-text wiki extract (follows redirects)

Prompts (workflow templates)

Prompt	Args
`check_item_price`	`itemName`
`compare_ge_items`	`items` (comma-separated)
`estimate_item_flip`	`itemName`, optional `quantity`
`player_overview`	`username`

Typical agent flow

code

lookup_item { query: "abyssal whip" }
  → id 4151, price …
get_item_price { itemId: 4151 }   # or { name: "Abyssal whip" }
get_item_graph { itemId: 4151 }

Resources

URI	Contents
`runescape://ge/info`	GE database info (not prices)
`runescape://ge/categories`	Canonical category list

Data sources

Jagex GE: https://secure.runescape.com/m=itemdb_rs/api
Jagex hiscores lite: https://secure.runescape.com/m=hiscore/index_lite.ws
Weirdgloop RS exchange: https://api.weirdgloop.org/exchange/history/rs
RuneScape Wiki MediaWiki API: https://runescape.wiki/api.php

All requests send User-Agent:
RuneScape Wiki MCP Server - github.com/birdwell/runescape-wiki-mcp

Project layout

code

src/
├── index.ts          # stdio entry (serveStdio)
├── smithery.ts       # Smithery HTTP factory
├── server.ts         # createServer() + handlers
├── itemResolve.ts    # name → ID resolution
├── categories.ts     # GE category table
├── tools/            # MCP tools
└── resources.ts      # MCP resources

Notes

RS3 only, not OSRS (different IDs and endpoints).
Ironman/hardcore index_lite endpoints are documented by Jagex but currently return HTTP 404; the tool reports that instead of silently returning normal-mode data.
Smithery hosts should rebuild the server card after tool changes so the published schema matches this README.

License

MIT — unofficial; not affiliated with Jagex or the RuneScape Wiki.

Install

Tools (12)

lookup_itemget_item_graphget_item_priceget_ge_infoget_category_infoget_all_categoriesbrowse_itemssummarize_price_history

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://runescape-wiki-mcp.fly.dev/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "runescape-wiki-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://runescape-wiki-mcp.fly.dev/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

lookup_item

get_item_graph

get_item_price

get_ge_info

get_category_info

get_all_categories

browse_items

summarize_price_history

compare_items

estimate_flip

get_player_stats

get_wiki_page_content

RuneScape Wiki MCP Server

Prerequisites

Install / Build / Run

Connect

Tools

Prompts (workflow templates)

Typical agent flow

Resources

Data sources

Project layout

Notes

License

Install

Remote endpoint

Related servers