RuneScape Wiki

Install

Works with Claude Code, VS Code, Codex, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/birdwell-runescape-wiki-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

13 read · 0 write · 0 deleteRead-only

Secrets

None asked for

Install scripts

Not scanned yet

Runs as

Node.js package

Tools (13)

As the server listed them on Oct 25, 2026. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• browse_itemsBrowse Catalogue Itemsread-only

  Browse an RS3 catalogue group. Use lookup_item for name search or get_item_price for one item's detail. - Choose category from get_all_categories and a nonempty starting letter from get_category_info. category 24 + alpha "a" means high-level melee weapons beginning with A; # selects numbers. - page is local to the (category, alpha) pair: page 2 continues page 1 with those filters unchanged. Reset to page 1 when either filter changes. Defaults are alpha a and page 1. - Jagex total counts the category, not the selected letter. Advance pages until items is empty; an isError response is a failed r…

• compare_itemsCompare Itemsread-only

  Compare latest available Weirdgloop price snapshots for a chosen RS3 item set in one call. Supply exactly one of names or itemIds, with 1-10 entries; IDs avoid name lookup, while each name selects its first matching item. Resolve uncertain names with lookup_item first; use get_item_price for one item's detailed Jagex trends or estimate_flip for tax-adjusted profit. Rows preserve input order; unresolved entries become error rows and available volume/timestamps can be absent. No auth or local result cache; snapshots lag live offers and are not historical comparisons. HTTP shares a default 60 re…

• estimate_flipEstimate Flip Profitread-only

  Estimate RS3 resale profit after seller tax. ESTIMATE ONLY; never places an order. Use get_item_price for price detail, compare_items for snapshots or lookup_item for uncertain names. - Choose itemId to skip name resolution, or name to resolve first. buyPrice and sellPrice are per-unit offers; quantity scales total investment, tax and profit, not the per-unit margin. - An omitted price uses Weirdgloop, falling back to Jagex guide price. Omit both and both sides use the same price, usually producing a tax loss. Supply itemId and both offers for a calculation without network access. - Tax is 2% …

• get_all_categoriesAll Categoriesread-only

  List all 44 RS3 Grand Exchange category IDs and names to choose a catalogue group. Call with {} and no filters; returns categories sorted by ID from a built-in list, without network access or auth. Use a returned ID with get_category_info for letter counts, then browse_items for entries. For item-name search use lookup_item. Category IDs identify groups, not items; duplicate category names have distinct IDs.

• get_category_infoCategory Inforead-only

  Count entries under every starting letter of one RS3 catalogue category, to choose nonempty groups before browse_items. Use lookup_item for name search. - Get category from get_all_categories. It selects one catalogue group, not an item or starting letter: 24 means high-level melee weapons, and 0 is one Miscellaneous group. There is no all-categories sentinel; query each desired ID separately. - One call returns all alpha letters with item counts; no per-letter argument is needed. # denotes numeric names. These count distinct catalogue entries, not stock or available offers. - Each call makes …

• get_ge_infoGE Catalogue Refresh Statusread-only

  Check the date and age of the latest GE catalogue configuration update. This does not report how fresh item prices are. Call with {} for catalogue diagnostics; use get_item_price for item prices/metadata or get_all_categories for category IDs. Makes one Jagex read. No auth or cache; API failures are errors. Shared HTTP limit: 60 requests/IP/minute; honor Retry-After on 429.

• get_item_graphGet Item Price Time Seriesread-only

  Retrieve about 180 days of Jagex guide-price observations for plotting or custom calculations: daily/average timestamp maps, not statistics or an image. For a ready-made min/max/mean/change answer, use summarize_price_history instead; it computes statistics from Weirdgloop daily history. - Pass exactly one of itemId or name; an ID skips name lookup and ambiguous names return candidate errors. Optional from/to are inclusive UTC dates, YYYY-MM-DD, applied to both maps. Omitted bounds are open; from=to selects one whole UTC day. Reversed bounds fail. - Omit dates for the full upstream window. Fil…

• get_item_priceGet Item Metadata and Guide Pricesread-only

  Fetch Jagex catalogue details: examine text, type, membership, icons, guide price and trends. itemId or name returns item directly; itemIds returns results[].data.item, even for a one-ID array. IDs are GE IDs from lookup_item. Choose exactly one selector; name resolves first and ambiguous names fail with candidates. Batches preserve ID order with per-row data/errors; all failed rows make the call an error. At most two upstream requests run concurrently; upstream 429 stops queued work. Use compare_items for numeric Weirdgloop snapshot comparisons, not catalogue metadata; get_item_graph for date…

• get_player_statsGet Player Statsread-only

  Read an RS3 player's published hiscores ranks, levels and experience, including Overall. Use search_wiki for training guides rather than player data. - username is the literal in-game display name, including spaces; the server URL-encodes it. gameMode chooses a separate leaderboard, not a filter on normal stats. Omit it for normal mode. - Normal, ironman and hardcore boards are supported. A player absent from the selected board returns a 404 tool error; the tool never substitutes another board. Unranked skills use rank Unranked; unavailable level/XP becomes 0. - No login, account changes or lo…

• get_wiki_page_contentGet Wiki Content or Referencesread-only

  Get reviewed Wiki article content or a source reference when text is unavailable. Use search_wiki to find titles; use get_item_price for GE prices. - Pass page as one unencoded title or pages as 1-10 titles, e.g. ["Abyssal whip", "Grand Exchange"]. Titles must name existing pages after redirects. URLs, #fragments and |separators are rejected. - page returns a flat object; pages returns ordered rows even for one title. Repeated or redirected titles keep separate rows. - The server sets output contentStatus. Approved, unchanged article text returns reviewed_extract with attribution; otherwise a …

• lookup_itemLookup Itemread-only

  Find tradeable RS3 items by name, returning matches with ID, name, wiki URL and available price, volume and sample timestamp. - query is a literal item name or prefix: "Abyssal whip" tries an exact match; "abyssal" discovers alternatives. limit defaults to 5, maximum 10. An exact match stops the search even with a larger limit; otherwise wiki opensearch candidates are filtered to GE items. - Choose a returned ID for get_item_price detail, summarize_price_history statistics or get_item_graph daily samples. No matches returns a tool error; optional price fields can be absent and samples lag live…

• search_wikiSearch Wiki Articlesread-only

  Search RS3 Wiki articles and return matching titles and links. Use get_wiki_page_content for page content/references, lookup_item for GE IDs, or get_item_price for guide prices. - query searches article text by default. Quotes group phrases: "Abyssal whip" "special attack" finds pages discussing both. intitle:"Abyssal whip" focuses title matches. Pass raw syntax; the server handles URL encoding. - limit caps the first relevance-ranked set. It is not an offset, and no continuation cursor exists. Refine query to change the matches. - Searches article namespace 0 and returns references without co…

• summarize_price_historySummarize Daily Price Statisticsread-only

  Calculate min/max, mean and start-to-end change from Weirdgloop daily prices; this tool returns statistics, not a time series. For timestamped Jagex guide-price observations or UTC date bounds, call get_item_graph instead. Use get_item_price for catalogue detail. - Choose itemId to skip name resolution, or name to resolve first. days selects trailing usable samples from a fixed 90-day fetch; it does not change fetch size. Fewer available samples reduce windowDays. - Return one aggregate: sample min/max, unweighted mean, newest-minus-oldest change and percentage relative to oldest. Volume avera…

Signals

Stars

0

Forks

2

Open issues

0

Last commit

Oct 24, 2026 (5 days ago)

Last release

Oct 16, 2026 (13 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

io.github.birdwell/runescape-wiki-mcp

Version

1.2.1

Auth

Auth not stated

Packages

npm runescape-wiki-mcp

License

MIT

Repository

github.com/birdwell/runescape-wiki-mcp

Website

runescape-wiki-mcp.fly.dev

First seen

Oct 24, 2026

Last checked

Oct 25, 2026

Source

Official MCP Registrygithub-graphql