Skip to main content
The DevHelm MCP server supports multiple transport modes and configuration options.

​
Transport modes

​
stdio (default)

Used by Cursor, Claude Desktop, and other local MCP clients: 
{
  "mcpServers": {
    "devhelm": {
      "command": "npx",
      "args": ["-y", "@devhelm/mcp-server"],
      "env": {
        "DEVHELM_API_TOKEN": "dh_live_xxxxxxxx"
      }
    }
  }
}

​
Streamable HTTP (hosted)

Connect to the hosted MCP server at https://mcp.devhelm.io: With Bearer auth: 
{
  "mcpServers": {
    "devhelm": {
      "url": "https://mcp.devhelm.io/mcp",
      "headers": {
        "Authorization": "Bearer dh_live_xxxxxxxx"
      }
    }
  }
}
With path-based API key (for clients that don’t support custom headers): 
{
  "mcpServers": {
    "devhelm": {
      "url": "https://mcp.devhelm.io/dh_live_xxxxxxxx/mcp"
    }
  }
}

​
Client setup

​
Cursor

Add to .cursor/mcp.json in your project root or ~/.cursor/mcp.json globally: 
{
  "mcpServers": {
    "devhelm": {
      "command": "npx",
      "args": ["-y", "@devhelm/mcp-server"],
      "env": {
        "DEVHELM_API_TOKEN": "dh_live_xxxxxxxx"
      }
    }
  }
}

​
Claude Desktop

Add to your Claude Desktop config file:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "devhelm": {
      "command": "npx",
      "args": ["-y", "@devhelm/mcp-server"],
      "env": {
        "DEVHELM_API_TOKEN": "dh_live_xxxxxxxx"
      }
    }
  }
}

​
Windsurf

Add to your Windsurf MCP settings: 
{
  "mcpServers": {
    "devhelm": {
      "command": "npx",
      "args": ["-y", "@devhelm/mcp-server"],
      "env": {
        "DEVHELM_API_TOKEN": "dh_live_xxxxxxxx"
      }
    }
  }
}

​
Environment variables

VariableDefaultDescription
DEVHELM_API_TOKEN—API token for authentication
DEVHELM_API_URLhttps://api.devhelm.ioAPI base URL (for self-hosted or testing)
DEVHELM_ORG_ID1Organization ID

​
Health check

The hosted server exposes a health endpoint: 
curl https://mcp.devhelm.io/health

{"status": "healthy", "service": "devhelm-mcp-server"}

​
Troubleshooting

Restart your MCP client after adding the configuration. In Cursor, use the Command Palette and search for “MCP: Restart Server”.
Verify your API token is correct and has not expired. Test it with:
curl -H "Authorization: Bearer dh_live_xxxxxxxx" https://api.devhelm.io/api/v1/monitors
Ensure Node.js 18+ is installed and npx is available in your PATH. Run node --version to verify.

​
Next steps

Tools reference

Complete catalog of all MCP tools.

MCP overview

Introduction and example interactions.