CLI Reference

The Conduit CLI lets you deploy, manage, and monitor MCP servers from your terminal.

Installation

npm install -g conduit-cli

Requires Node.js 18 or later. Verify installation with conduit --version.

Commands

conduit login

Authenticate with Conduit. Opens a browser for login, or accepts an API key directly.

Usage

conduit login [--key <api-key>]

Flags

--key <key>Authenticate with an existing API key instead of browser flow

Example

$ conduit login
Opening browser for authentication...
Paste the token from your browser: ********
Logged in as sky@example.com (My Org)
conduit logout

Clear stored credentials from your machine.

Usage

conduit logout

Example

$ conduit logout
Logged out successfully.
conduit deploy

Deploy an MCP server to Conduit. Registers the server, generates an API key, and runs a trust scan.

Usage

conduit deploy <path-or-url>

Example

$ conduit deploy https://my-mcp.example.com/mcp
Registering server...
Generating API key...
Running trust scan...

╔══════════════════════════════════════════╗
║   Server deployed successfully!          ║
╚══════════════════════════════════════════╝

  Server:    my-mcp
  Gateway:   https://gateway.conduitapi.dev/s/my-org/my-mcp
  API Key:   cnd_live_xxxxxxxxxxxxxxxxxxxx
  Trust:     A (92/100)
conduit servers

List all MCP servers in your organization.

Usage

conduit servers

Example

$ conduit servers

  Name               Status   Grade  Health   Endpoint
  my-mcp-server      active   A      healthy  https://gateway.conduitapi.dev/...
  analytics-tools    active   B+     healthy  https://gateway.conduitapi.dev/...
conduit scan

Trigger a trust scan for a server.

Usage

conduit scan <server-slug>

Example

$ conduit scan my-mcp-server
Scanning my-mcp-server...

  Trust Score: 92 / 100  Grade: A

  Security:    ████████████████████ 95
  Compliance:  █████████████████░░░ 88
  Auth:        ██████████████████░░ 90
  Performance: ███████████████████░ 94

  Findings: 2 (1 medium, 1 low)
conduit keys list

List all API keys for your organization.

Usage

conduit keys list

Example

$ conduit keys list

  Name             Prefix            Created       Last Used
  Production       cnd_live_xxxx     2026-02-01    2026-02-08
  Development      cnd_live_yyyy     2026-02-05    2026-02-07
conduit keys create

Create a new API key.

Usage

conduit keys create --name <name>

Flags

--name <name>Name for the key (required)

Example

$ conduit keys create --name "CI/CD Pipeline"

  Key created: cnd_live_xxxxxxxxxxxxxxxxxxxx
  Name:        CI/CD Pipeline

  Save this key — it won't be shown again.
conduit keys revoke

Revoke an API key immediately.

Usage

conduit keys revoke <key-id>

Example

$ conduit keys revoke abc123
Key revoked successfully.
conduit status

Show your account status including plan, usage, and server count.

Usage

conduit status

Example

$ conduit status

  Email:    sky@example.com
  Org:      My Org
  Plan:     pro
  Servers:  3
  Usage:    1,234 / 50,000 calls today
conduit whoami

Print the email and organization associated with your API key.

Usage

conduit whoami

Example

$ conduit whoami
sky@example.com (My Org)

Configuration

The CLI stores configuration in ~/.conduit/config.json:

{
  "api_key": "cnd_live_xxxxxxxxxxxxxxxxxxxx",
  "api_url": "https://conduitapi.dev"
}

Environment variables

VariableDescription
CONDUIT_API_URLOverride the API base URL (default: https://conduitapi.dev)
CONDUIT_API_KEYOverride the API key (takes precedence over config file)

Global flags

FlagDescription
--help, -hShow help for any command
--version, -VPrint the CLI version