Skip to main content
The Coval MCP Server enables AI assistants to interact with Coval’s evaluation APIs through the Model Context Protocol. Coval MCP in Claude Desktop

​
What You Can Do

With the MCP server, you can ask Claude or Cursor to:
  • Launch evaluations - “Run the billing test set against my support agent”
  • Monitor runs - “What’s the status of my latest evaluation?”
  • Manage agents - “Create a new voice agent for customer service”
  • View metrics - “Show me the metrics for run abc123”
  • Organize tests - “List my test sets and their configurations”

​
Quick Start

1

Get your API key

Go to Coval Dashboard and copy your API key.
2

Configure Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
  "mcpServers": {
    "coval": {
      "command": "npx",
      "args": ["-y", "@covalai/mcp-server"],
      "env": {
        "COVAL_API_KEY": "your_api_key_here"
      }
    }
  }
}
3

Restart Claude Desktop

Quit and reopen Claude Desktop to load the server.
4

Start using Coval

Ask Claude: “List my Coval agents” or “Show my recent evaluation runs”

​
Available Tools

The MCP server exposes 18 tools across 6 categories:
CategoryToolsDescription
Runslist_runs, get_run, create_run, delete_runLaunch and monitor evaluations
Agentslist_agents, get_agent, create_agent, update_agentManage agent configurations
Test Setslist_test_sets, get_test_set, create_test_setOrganize test cases
Test Caseslist_test_cases, get_test_case, create_test_case, update_test_caseManage individual test cases
Metricslist_metrics, get_metricView evaluation metrics
Personaslist_personas, get_personaConfigure simulated users

Tools Reference

See complete parameter documentation for all tools

​
Example Usage

Once connected, you can ask Claude or Cursor things like:
  • “Show me my recent evaluation runs”
  • “List all my agents”
  • “Run an evaluation of my customer-support-agent against the billing-inquiries test set”
  • “What are the metrics for run abc123?”
  • “Create a new test set for voice agent scenarios”

​
Requirements

  • Node.js 20+
  • Coval API key
  • MCP-compatible client (Claude Desktop, Cursor, etc.)

​
Support