ClearRun MCP help

Start here

1. How to add ClearRun to Claude Desktop

   Add a clearrun entry with your API key to claude_desktop_config.json, restart Claude Desktop, and ask it to use clearrun_score. Paths for Mac and Windows.

2. How to add ClearRun to Claude Code

   Run claude mcp add clearrun --env CLEARRUN_API_KEY=YOUR_KEY -- npx -y @clearrun/mcp. Then run /mcp in Claude Code to check that clearrun is connected.

3. How to add ClearRun to Cursor

   Add the ClearRun MCP server to .cursor/mcp.json with your API key. Then ask Cursor's agent to score an answer with clearrun_score. ClearRun help center.

4. What tools does the ClearRun MCP server have?

   Four: clearrun_score, clearrun_evaluate, clearrun_chat and clearrun_verify. The first three call the hosted API with your key and use credits. ClearRun help.

All MCP articles

• How to add ClearRun to Claude Desktop

  Add a clearrun entry with your API key to claude_desktop_config.json, restart Claude Desktop, and ask it to use clearrun_score. Paths for Mac and Windows.

• How to add ClearRun to Claude Code

  Run claude mcp add clearrun --env CLEARRUN_API_KEY=YOUR_KEY -- npx -y @clearrun/mcp. Then run /mcp in Claude Code to check that clearrun is connected.

• How to add ClearRun to Cursor

  Add the ClearRun MCP server to .cursor/mcp.json with your API key. Then ask Cursor's agent to score an answer with clearrun_score. ClearRun help center.

• How to add ClearRun to VS Code

  Add a clearrun entry under servers in .vscode/mcp.json. Use "${env:CLEARRUN_API_KEY}" as the key value so the key stays out of the file. Steps inside.

• What tools does the ClearRun MCP server have?

  Four: clearrun_score, clearrun_evaluate, clearrun_chat and clearrun_verify. The first three call the hosted API with your key and use credits. ClearRun help.

• How to score an answer in chat with clearrun_score

  Ask your assistant to run clearrun_score on the answer. It sends the text to POST /api/score and returns the score and verdict. From the ClearRun help center.

• How to score an answer with its prompt using clearrun_evaluate

  Ask your assistant to run clearrun_evaluate with both the answer and the prompt that produced it. It calls POST /api/evaluate. From the ClearRun help center.

• How to get and score an answer with clearrun_chat

  Ask your assistant to send your question with clearrun_chat. ClearRun writes an answer, scores it, and returns both. Read more in the ClearRun help center.

• How to look up a verdict with clearrun_verify

  Ask your assistant to run clearrun_verify with a verdict id. It calls the public lookup, sends no API key, and uses no credits. From the ClearRun help center.

• How to keep your API key out of mcp.json

  Leave the key out of the file. Either run npx @clearrun/cli login once, which the MCP server reads, or reference an environment variable. Steps inside.

• Why does the ClearRun MCP server say no API key is configured?

  The server found no key in its env block, in CLEARRUN_API_KEY, or in the file saved by clearrun login. Add one and restart your MCP host. Steps inside.

• Why does a ClearRun MCP tool return 403 'API access requires a Pro plan or higher'?

  403 API_ACCESS_REQUIRED means the key is not a free developer key. A verified free account can create one and use it with the MCP server.

• How to run the ClearRun MCP server from source

  Clone the ClearRun repo, run npm install and npm run build -w @clearrun/mcp, then point your MCP host at node with the path to packages/mcp/dist/index.js.

Other topics

• Get started with ClearRun
• What the ClearRun score means
• ClearRun API, CLI, SDK, and MCP
• ClearRun signed receipts
• ClearRun plans and credits
• ClearRun privacy and data
• ClearRun limits and errors
• ClearRun CLI help
• ClearRun SDK help
• ClearRun API help
• ClearRun API key help
• Use ClearRun with other tools
• ClearRun best practices