Skip to main content
The Coval connector connects AI assistants to your Coval organization through the Model Context Protocol. The hosted server uses OAuth, so each user signs in to Coval and selects the organization the assistant may access.

​
What You Can Do

With the MCP server, you can ask your assistant to:
  • Launch evaluations: “Run the billing test set against my support agent”
  • Inspect results: “Show my latest unsuccessful runs and explain what failed”
  • Manage agents: “Create a chat agent for the staging endpoint”
  • Build test coverage: “Create a test set for refund and cancellation scenarios”
  • Consult Sofia: “Ask Sofia what I should test next based on my recent runs”
Direct tools perform deterministic Coval API operations. consult_sofia adds Sofia’s Coval product knowledge and evaluation expertise while remaining read-only.

​
Quick Start

1

Install the Coval connector

Install Coval from the ChatGPT or Claude connector directory. For Codex and other MCP clients, add https://mcp.coval.dev/mcp as a remote MCP server.
2

Sign in and select an organization

Your browser opens Coval’s authorization flow. Sign in, select the Coval organization you want to use, and approve access.
3

Start using Coval

Ask your assistant: “List my Coval agents” or “Ask Sofia to review my latest failed run.”
See Installation for direct directory links, client-specific setup, and the local API-key option.

​
Available Tools

The hosted MCP server exposes 19 tools across 7 categories:

Tools Reference

See complete parameter documentation for all tools

​
Access and Safety

  • OAuth access is limited to the organization selected during consent.
  • Read and write operations are exposed as separate tools with explicit annotations.
  • consult_sofia can inspect resources and recommend actions, but cannot create, update, run, or delete resources.
  • To monitor and improve Sofia, Coval records the prompt, any optional conversation messages explicitly passed to consult_sofia, and Sofia’s response. The connector does not automatically receive unrelated messages from the surrounding assistant session. Do not send secrets or credentials in consultation content.
  • You can disconnect the connector from ChatGPT, Claude, Codex, or another MCP client at any time.

​
Requirements

  • An active Coval account with access to at least one organization
  • ChatGPT, Claude, or an MCP client that supports remote Streamable HTTP and OAuth
  • Node.js 20+ only when running the optional local server

​
Support