# Nerf Watch MCP server

> Provides read-only access to daily model performance scores and historical trends from a private, code-graded evaluation suite.

- Repository: https://github.com/stdcmms-lang/tokenusage-codex-mcp
- Page: https://hostedmcp.org/servers/stdcmms-lang/nerfwatch
- Transport: remote
- Stars: 0
- License: MIT
- Latest version: 1.0.0

## Install

### Claude Code

```sh
claude mcp add --transport http nerfwatch https://tokenusage.dev/mcp/nerfwatch
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "nerfwatch": {
      "url": "https://tokenusage.dev/mcp/nerfwatch"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "nerfwatch": {
      "type": "http",
      "url": "https://tokenusage.dev/mcp/nerfwatch"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"nerfwatch","type":"http","url":"https://tokenusage.dev/mcp/nerfwatch"}'
```

### Codex

```sh
codex mcp add nerfwatch --url https://tokenusage.dev/mcp/nerfwatch
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.nerfwatch]
url = "https://tokenusage.dev/mcp/nerfwatch"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http nerfwatch https://tokenusage.dev/mcp/nerfwatch
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "nerfwatch": {
      "url": "https://tokenusage.dev/mcp/nerfwatch",
      "type": "http"
    }
  }
}
```

## Tools (2)

- `get_nerfwatch_scores`
- `get_nerfwatch_history`

## FAQ

### What data does the server provide?

The server provides the latest public scores, previous runs, changes, baselines, trends, and model history.

### Do I need an API key to use this server?

No, the server does not require an API key, account, or sign-in.

### How often should I poll the server?

You should poll the server no more frequently than every five minutes.

### Does a lower score mean a model has changed?

No, a lower score is simply a lower score on this specific suite and is not definitive proof of a model change.
