How to add ClearRun to Claude Desktop

Add a clearrun entry to claude_desktop_config.json with your API key, then restart Claude Desktop. Ask Claude to score an answer with clearrun_score.

Last updated

You need Node.js 18 or newer and a ClearRun API key. A verified free account can create one developer key. @clearrun/mcp is at 1.2.0.

Steps

  1. Open the config file

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. Add ClearRun

    {
  "mcpServers": {
    "clearrun": {
      "command": "npx",
      "args": ["-y", "@clearrun/mcp"],
      "env": {
        "CLEARRUN_API_KEY": "YOUR_CLEARRUN_API_KEY"
      }
    }
  }
}

    Replace YOUR_CLEARRUN_API_KEY with your key. If the file already has mcpServers, add the clearrun entry inside it.

  3. Restart Claude Desktop

    Quit it fully and open it again.

  4. Try it

    Ask: "Use clearrun_score on this answer:" and paste the answer.

If it does not work

  • Tools not listed: check that npx works in a terminal, then restart again.
  • "No ClearRun API key is configured." The env block is missing or empty.
  • 403 API_ACCESS_REQUIRED. That key is not a free developer key. Create one on a verified free account.