Skip to main content

​
Installation

npx @covalai/mcp-server

​
Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
Restart Claude Desktop after modifying the config file.

​
Cursor

Add to .cursor/mcp.json in your project: 
{
  "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
LOG_LEVELNoinfoLogging level (debug, info, warn, error)

​
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.

​
Troubleshooting

  1. Check that Node.js 20+ is installed: node --version
  2. Verify the config file path is correct
  3. Ensure JSON syntax is valid (no trailing commas)
  4. Restart Claude Desktop completely (quit from menu bar)
  1. Verify your API key at dashboard
  2. Check the key is correctly set in COVAL_API_KEY
  3. Ensure no extra whitespace around the key
  1. Check Claude Desktop logs: ~/Library/Logs/Claude/
  2. Run the server manually to see errors: COVAL_API_KEY=xxx npx @covalai/mcp-server
  3. Verify you have a valid API key (without one, only ping tool is available)