{ "markdown": "# OSRS Wiki MCP\n\n

\n \"OSRS\n

\n\nA local, read-only [Model Context Protocol](https://modelcontextprotocol.io/)\nserver for the [Old School RuneScape Wiki](https://oldschool.runescape.wiki/).\nIt gives AI clients ten focused tools for Wiki research, with validated\nstructured output and source provenance on every successful response.\n\n- **Stateless:** no player account, database, telemetry, or disk cache.\n- **Source-backed:** results include canonical Wiki URLs and fetch timestamps;\n parsed pages also include an exact revision link.\n- **Bounded:** response sizes, pagination, retries, and request time are capped.\n- **Read-only:** the server only retrieves public Wiki data.\n\n## Quick start\n\nNode.js 24 or newer and `npx` are required.\n\n### Codex\n\n```powershell\ncodex plugin marketplace add SSanderV/osrs-wiki-mcp --ref v1.1.3\ncodex plugin add osrs-wiki-mcp@osrs-wiki\n```\n\n### Claude Code\n\n```powershell\nclaude plugin marketplace add SSanderV/osrs-wiki-mcp@v1.1.3 --scope user\nclaude plugin install osrs-wiki-mcp@osrs-wiki --scope user\n```\n\n### Gemini CLI\n\n```powershell\ngemini extensions install https://github.com/SSanderV/osrs-wiki-mcp --ref v1.1.3\n```\n\nThe plugin and extension include the MCP setup plus a small Wiki-research\nskill. All three launch the pinned npm package `osrs-wiki-mcp@1.1.3`.\n\n### Other MCP clients\n\nConfigure a standard-input/output server with:\n\n```json\n{\n \"command\": \"npx\",\n \"args\": [\"--yes\", \"osrs-wiki-mcp@1.1.3\"]\n}\n```\n\nStart a fresh client session after installation. If you previously configured\nan `osrs-wiki` MCP server directly, remove that registration first so the\nplugin is the only provider of the server.\n\n## Tools\n\n| Tool | Inputs | Use it for |\n| --- | --- | --- |\n| `search_wiki` | `query`, optional `limit` and `offset` | Find canonical pages and snippets. |\n| `get_wiki_page` | `title` | Read a bounded, cleaned page with its section index. |\n| `get_wiki_sections` | `title` | List a page's sections. |\n| `get_wiki_section` | `title`, `section` | Read one section by its numeric index. |\n| `get_item_info` | `item` | Get an item's description, properties, bonuses, and creation facts. |\n| `find_shop` | `item`, optional `limit` and `offset` | Page through complete shop listings. |\n| `find_drop_sources` | `item`, optional `limit` and `offset` | Page through complete monster-drop listings. |\n| `get_item_sources` | `item`, optional `perCategoryLimit` | Get a bounded overview of drops, shops, recipes, and ground spawns. |\n| `get_quest_requirements` | `quest` | Get Wiki-sourced requirements without evaluating a player. |\n| `get_monster_info` | `monster`, optional `variant` | Get separate monster variants, map points, and access notes. |\n\nExample requests:\n\n- “What are the requirements for Dragon Slayer I?”\n- “Where can an ironman obtain a rune scimitar?”\n- “Find the exact Wiki section explaining Hespori mechanics.”\n\nAll public text inputs accept 1–256 Unicode characters. Tool schemas declare\nthe exact limits and defaults. When results are truncated or upstream\npagination is incomplete, `warnings` explains the safe follow-up action.\n\n## Responses and provenance\n\nSuccessful calls return:\n\n- `content` for clients that display readable text; and\n- `structuredContent`, validated against the tool's MCP output schema.\n\nProvenance includes the contributing Wiki URLs, original `fetchedAt` time,\nattribution, license details, and whether content was transformed. Parsed-page\nresponses additionally include the exact revision ID and revision URL.\n\nFailures use stable error codes such as `NOT_FOUND`, `UPSTREAM_TIMEOUT`,\n`UPSTREAM_RATE_LIMITED`, `UPSTREAM_UNAVAILABLE`,\n`UPSTREAM_INVALID_RESPONSE`, and `RESPONSE_TOO_LARGE`. Invalid arguments remain\nstandard JSON-RPC parameter errors.\n\n## Reliability and privacy\n\n- A tool call has a 30-second total budget; each upstream request gets at most\n 20 seconds within that budget.\n- Transient network and rate-limit failures receive at most two bounded\n retries, respecting `Retry-After` only when time remains.\n- Responses are capped at 5 MiB. Large Bucket scans stop after 10,000 raw rows\n and report incomplete or truncated results.\n- Valid upstream responses may be cached in memory for five minutes. The cache is\n limited per process, never written to disk, and cleared on restart.\n- Standard output is reserved for MCP traffic. Sanitized diagnostics use\n standard error.\n\n## Scope\n\nThe server deliberately does **not** provide player progress, hiscores, Grand\nExchange prices, DPS calculations, Wiki images, persistent storage, hosting,\nor a local Wiki mirror. Quest requirements are facts rather than met/missing\nevaluations, and monster variants are never combined.\n\n## Development\n\n```powershell\nnpm.cmd ci --ignore-scripts\nnpm.cmd run typecheck\nnpm.cmd test\nnpm.cmd run build\nnpm.cmd run smoke:stdio\nnpm.cmd run pack:check\n```\n\nTests use synthetic fixtures and do not contact the live Wiki. The optional\nlive smoke makes two low-volume requests and does not persist responses:\n\n```powershell\nnpm.cmd run test:live\n```\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development guidance and\n[SECURITY.md](SECURITY.md) for private vulnerability reporting.\n\n## Licensing and attribution\n\nThe source code is [MIT licensed](LICENSE). Retrieved Old School RuneScape Wiki\ncontent remains subject to\n[CC BY-NC-SA 3.0](https://creativecommons.org/licenses/by-nc-sa/3.0/), including\nits non-commercial and ShareAlike conditions. Downstream users are responsible\nfor how they reuse that content. See\n[THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).\n\nRuneScape and Old School RuneScape are trademarks of Jagex Limited. This\nindependent project is not affiliated with, endorsed by, or sponsored by Jagex\nLimited, Weird Gloop, or the Old School RuneScape Wiki.\n", "bytes": 5861, "sha": "61d1fa287aba8f977aa9824a789c1b35bf1197612869f19b503cbff1aaeecb33", "repo_slug": "ssanderv/osrs-wiki-mcp", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/plg_ssanderv_osrs_wiki_mcp_a7e5dfb0/readme" }