io.github.birdwell/runescape-wiki-mcp·Memory

RuneScape Wiki

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

01Stars: 0
02Version: 1.2.1
03License: MIT
04Review: Partial

Source Website npm

Language: TypeScript
Last commit: 21m ago
Forks: 2
Open issues: 8
Registry update: Oct 16, 2026

grand-exchangemcpmcp-servermodel-context-protocolrs3runescapewiki

Connect

remote + npm

Terminal

$claude mcp add --transport http runescape-wiki-mcp https://runescape-wiki-mcp.fly.dev/mcp

Headers

Nothing to configure — it works as is.

Security review

Partly reviewed

Reviewed 10m ago. Tool definitions changed on Oct 16, 2026.

tools: 12 tools scanned
metadata: scanned
packages: 1 checked

mediumReviewTool definitions changed after an earlier review
A server that changes its tool descriptions after being approved ("rug pull") can slip new instructions to agents. Re-check what changed before trusting it.
changed 2026-10-16

Tools

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
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.
get_item_price
Get current Grand Exchange price, trends, and examine text for an item. Pass exactly one of itemId or name.
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.
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 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.
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.

README

birdwell/runescape-wiki-mcp/README.md

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

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

Connect

Remote (Streamable HTTP):

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

stdio via npm:

{
  "mcpServers": {
    "runescape-wiki": {
      "command": "npx",
      "args": ["-y", "runescape-wiki-mcp"]
    }
  }
}

Local stdio:

{
  "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

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

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.

From the server's repository — third-party content, read it before running anything it suggests.

RuneScape Wiki

Connect

Headers

Security review

Tools

README

RuneScape Wiki MCP Server

Prerequisites

Install / Build / Run

Connect

Tools

Prompts (workflow templates)

Typical agent flow

Resources

Data sources

Project layout

Notes

License

More in Memory

rutter

inspeximus: agent memory with provenance, GDPR erasure and a tamper-evident audit trail

knowmind

brains

Semurg agent memory

Selvedge