Connect your editor — MCP

Codex

codex mcp add aperveil -- npx -y @aperveil/cli@0.2.1 mcp

Restart the MCP connection and check /mcp. For manual configuration, use ~/.codex/config.toml or a trusted project's .codex/config.toml; set startup_timeout_sec = 60 if the first download needs more time. See the Codex MCP documentation.

Cursor

Add this to .cursor/mcp.json in your project, or ~/.cursor/mcp.json for all projects. If the file already contains other servers, add the aperveil entry to its existing mcpServers object.

{
  "mcpServers": {
    "aperveil": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@aperveil/cli@0.2.1",
        "mcp"
      ]
    }
  }
}

Enable Aperveil in Cursor's MCP settings and confirm that its three tools appear. See the Cursor MCP documentation.

Claude Code

claude mcp add aperveil -- npx -y @aperveil/cli@0.2.1 mcp
claude mcp get aperveil

Check the connection in /mcp. You can also use the JSON server configuration above in your project's .mcp.json, then approve the server when Claude asks. See the Claude Code MCP documentation.

Windows

If your editor cannot launch npx.cmd directly, use cmd.exe. In Cursor or a Claude project configuration, the entry is:

{
  "mcpServers": {
    "aperveil": {
      "type": "stdio",
      "command": "cmd.exe",
      "args": [
        "/d",
        "/c",
        "npx",
        "-y",
        "@aperveil/cli@0.2.1",
        "mcp"
      ]
    }
  }
}

For Codex, register the same command with:

codex mcp add aperveil -- cmd.exe /d /c npx -y @aperveil/cli@0.2.1 mcp

Restart your editor after changing PATH. A fixed local CLI installation with an absolute path to node_modules/@aperveil/cli/dist/index.js is another option.