Setup

Configuration

Add to your MCP client's config (Claude Desktop, Claude Code, Cursor all use the same shape):

{
  "mcpServers": {
    "solvemax": {
      "command": "npx",
      "args": ["-y", "solvemax-mcp"],
      "env": {
        "SOLVEMAX_API_KEY": "smx_live_...",
        "SOLVEMAX_BASE_URL": "https://solvemax.solveright.ai"
      }
    }
  }
}

SOLVEMAX_BASE_URL defaults to https://solvemax.app if omitted — set it explicitly to the domain your solvemax instance is actually deployed to.

Environment variables

Create your API key first — see Authentication.

Running locally (before publishing your own build)

{
  "mcpServers": {
    "solvemax": {
      "command": "node",
      "args": ["/path/to/integrations/mcp/index.mjs"],
      "env": { "SOLVEMAX_API_KEY": "smx_live_...", "SOLVEMAX_BASE_URL": "https://solvemax.solveright.ai" }
    }
  }
}

Verifying it's working

Restart your MCP client after editing the config, then ask it to run a decision through solvemax. If SOLVEMAX_API_KEY isn't set, the tool returns a clear error pointing you to create one, rather than failing silently.