ClearRun API, CLI, SDK, and MCP
Score an answer from the API, the terminal, your own code, or an MCP client.
Last updated
Start here
How to score an answer with the ClearRun API
Send an answer to POST /api/score. If you also have the question, send both to POST /api/evaluate. Both need an API key. Keep the verdict id for later.
How to use the ClearRun CLI
Install @clearrun/cli, save your key with clearrun login, and score text with clearrun score. clearrun verify looks up a past verdict.
How to use the ClearRun SDK
Use @clearrun/sdk to score text, score an answer with its question, get a scored chat answer, or look up a past verdict.
How to use the ClearRun MCP server
Add the @clearrun/mcp server (1.2.0) to Claude, Cursor, or VS Code. It can score, evaluate, or chat. A verified free account can create one developer key. It does not check facts.
How to store and revoke ClearRun API keys
Create a key at api.clearrun.net/account/keys. It is shown once. Save it in an environment variable or with clearrun login, and revoke it if it leaks.
All API, CLI, SDK, and MCP articles
How to score an answer with the ClearRun API
Send an answer to POST /api/score. If you also have the question, send both to POST /api/evaluate. Both need an API key. Keep the verdict id for later.
How to use the ClearRun CLI
Install @clearrun/cli, save your key with clearrun login, and score text with clearrun score. clearrun verify looks up a past verdict.
How to use the ClearRun SDK
Use @clearrun/sdk to score text, score an answer with its question, get a scored chat answer, or look up a past verdict.
How to use the ClearRun MCP server
Add the @clearrun/mcp server (1.2.0) to Claude, Cursor, or VS Code. It can score, evaluate, or chat. A verified free account can create one developer key. It does not check facts.
How to store and revoke ClearRun API keys
Create a key at api.clearrun.net/account/keys. It is shown once. Save it in an environment variable or with clearrun login, and revoke it if it leaks.