Skip to main content

​
Config File Locations

Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.jsonCursor: .cursor/mcp.json in your project rootClaude Code: ~/.claude/settings.json or .mcp.json in your project root
Connects to Coval’s managed MCP endpoint via mcp-remote. No local server to maintain — always up to date.
Add to your Claude Desktop config file:
{
  "mcpServers": {
    "coval": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.coval.dev/mcp",
        "--header",
        "X-API-Key: ${COVAL_API_KEY}"
      ],
      "env": {
        "COVAL_API_KEY": "your_api_key_here"
      }
    }
  }
}
Restart your MCP client after modifying the config file. For Claude Desktop, fully quit from the menu bar — don’t just close the window.

​
Local Server (NPX)

Runs the Coval MCP server locally on your machine via npm. Useful if you need a custom API endpoint or want to develop against the server. 
npx @covalai/mcp-server

{
  "mcpServers": {
    "coval": {
      "command": "npx",
      "args": ["-y", "@covalai/mcp-server"],
      "env": {
        "COVAL_API_KEY": "your_api_key_here"
      }
    }
  }
}

​
Environment Variables

VariableRequiredDefaultDescription
COVAL_API_KEYYes-Your API key from dashboard
COVAL_API_BASE_URLNohttps://api.coval.dev/v1Custom API endpoint (local server only)
LOG_LEVELNoinfoLogging level: debug, info, warn, error (local server only)

​
Local Development

Clone and run from source: 
git clone https://github.com/coval-ai/mcp-server
cd coval-mcp-server
npm install
npm run build

# Set your API key
export COVAL_API_KEY=your_api_key_here

# Run the server
npm start

​
Testing with MCP Inspector

npm run inspector
This launches a web UI for testing tool calls interactively.