# OSRS Wiki MCP Server

A [Model Context Protocol](https://modelcontextprotocol.io/) server for the [Old School RuneScape Wiki](https://oldschool.runescape.wiki/), deployed on Cloudflare Workers.

## Tools

| Tool | Description |
|------|-------------|
| `search` | Search the wiki for articles matching a query |
| `summary` | Get the introductory summary of a wiki page |
| `price` | Look up current Grand Exchange prices for an item |
| `player` | Fetch RuneLite player data via WikiSync plugin |

## Transports

| Transport | Endpoint |
|-----------|----------|
| Streamable HTTP (preferred) | `/mcp` |
| SSE (legacy) | `/sse` |

## Setup

### Claude Code / Cursor

Run the install script to add this server to your MCP config:

```bash
./scripts/install-claude-mcp.sh
```

### Claude Desktop

Add to your Claude Desktop config (`Settings > Developer > Edit Config`):

```json
{
  "mcpServers": {
    "osrs-wiki": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://wiki-osrs-mcp.isaachansen2400.workers.dev/mcp"
      ]
    }
  }
}
```

### Direct connection

Any MCP client that supports remote servers can connect directly to:

```
https://wiki-osrs-mcp.isaachansen2400.workers.dev/mcp
```

## Development

```bash
npm install
npm run dev        # Start local dev server on :8787
npm run deploy     # Deploy to Cloudflare Workers
```