Runescape Wiki Mcp
About
This MCP server provides AI assistants with real-time access to RuneScape 3 game data through the RuneScape Wiki APIs. It enables AI systems to retrieve current Grand Exchange prices, detailed item information (including stats, examine text, and alchemy values), historical price
Details
- Transport
- SSE
Explore
- Real-time Grand Exchange Prices: Get current, 5-minute, and 1-hour average prices for all items
- Item Database: Access complete item mappings with metadata (names, IDs, examine text, etc.)
- Price Time Series: Historical price data with configurable time intervals
- Player Statistics: Lookup player stats from RuneScape 3 hiscores
- Multiple Game Modes: Support for normal, ironman, and hardcore ironman accounts
- MCP Resources: Direct access to price and item data through MCP resource URIs
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Runescape Wiki McpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Node.js 18.0.0 or higher
- npm or yarn
npm install
Verify the server is working correctly:
npm test
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.
get_item_graph
Get historical Grand Exchange price graph data (last 180 days) by itemId or name.
get_item_price
Get current Grand Exchange price, trends, and examine text for an item by itemId or exact/near-exact name.
get_ge_info
Get Grand Exchange database metadata (lastConfigUpdateRuneday).
get_category_info
Get letter counts for a Grand Exchange category. Use get_all_categories for IDs.
get_all_categories
List all RS3 Grand Exchange category IDs and names (0-43).
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.
summarize_price_history
Summarize recent Grand Exchange price trends for an item (min/max/average price, change, and average daily volume) by itemId or name. Returns a compact summary instead of raw data points — use get_item_graph when you need the full price series.
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.
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.
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.
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.
1. Define the tool in the tools array with proper schema
2. Add a case handler in the CallToolRequestSchema handler
3. Implement the API logic with proper error handling
4. Update this README with documentation
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"runescape wiki mcp": {
"runescape-wiki": {
"command": "node",
"args": [
"/path/to/runescape-wiki-mcp/dist/index.js"
]
}
}
}
}McpServers
{
"runescape-wiki": {
"command": "node",
"args": [
"/path/to/runescape-wiki-mcp/dist/index.js"
]
}
}A Model Context Protocol (MCP) server that provides access to RuneScape Wiki APIs, including real-time Grand Exchange prices, item data, and player statistics for RuneScape 3 (RS3).
Features
- Real-time Grand Exchange Prices: Get current, 5-minute, and 1-hour average prices for all items
- Item Database: Access complete item mappings with metadata (names, IDs, examine text, etc.)
- Price Time Series: Historical price data with configurable time intervals
- Player Statistics: Lookup player stats from RuneScape 3 hiscores
- Multiple Game Modes: Support for normal, ironman, and hardcore ironman accounts
- MCP Resources: Direct access to price and item data through MCP resource URIs
Installation
Prerequisites
- Node.js 18.0.0 or higher
- npm or yarn
Install Dependencies
npm install
Build the Project
npm run build
Development Mode
npm run dev
This will start the TypeScript compiler in watch mode and automatically restart the server when files change.
Usage
With Claude Desktop
Add the following configuration to your Claude Desktop config file:
{
"mcpServers": {
"runescape-wiki": {
"command": "node",
"args": ["/path/to/runescape-wiki-mcp/dist/index.js"]
}
}
}
With MCP Inspector
Test the server using the MCP Inspector:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
