Reference

CLI Reference

All commands are available via npx @businys/ops or the global binary businys-ops after installation.

`init`

Scaffold mcp-ops.config.json in the current directory.

Usagesh

npx @businys/ops init

Examplesh

npx @businys/ops init
# Creates mcp-ops.config.json with default rate limits and a placeholder API key

`deploy`

Validate an API key against the hosted dashboard and write it to mcp-ops.config.json. Creates the config file if it does not exist.

Usagesh

npx @businys/ops deploy [options]

Option	Default	Description
`--key <api-key>`	—	API key from businys.dev/dashboard (or set BDEV_API_KEY)
`--url <base-url>`	https://businys.dev	Override the dashboard base URL

Examplesh

npx @businys/ops deploy --key sk-live-abc123
# or
BDEV_API_KEY=sk-live-abc123 npx @businys/ops deploy

`observe`

Start Observer Mode — an in-memory dashboard. Resets on restart. Good for development and demos.

Usagesh

npx @businys/ops observe [options]

Option	Default	Description
`--port <n>`	3100	Dashboard port
`--host <host>`	localhost	Bind hostname
`--token <tok>`	—	Bearer token required for API access

Examplesh

npx @businys/ops observe
npx @businys/ops observe --port 3200 --token mysecret

`dev`

Local dev server with persistent storage. Optionally wraps a stdio MCP server as a bridge. Observer dashboard at the main port; bridge at port+1.

Usagesh

npx @businys/ops dev [cmd...] [options]

Option	Default	Description
`<cmd...>`	—	Optional stdio server command — starts bridge at port+1
`--port <n>`	3100	Dashboard port
`--host <host>`	localhost	Bind hostname
`--storage <path>`	.ops-data.json	Data file path
`--token <tok>`	—	Bearer token required for API access

Examplesh

# Dashboard only (persistent)
npx @businys/ops dev

# Dashboard + bridge wrapping a stdio server
npx @businys/ops dev node ./my-server.js
npx @businys/ops dev python server.py --storage ./data.json

`bridge`

Wrap a stdio MCP server as a managed HTTP endpoint with full middleware. Use this to add rate limiting, auth, and audit logging to any stdio server without modifying it.

Usagesh

npx @businys/ops bridge <cmd...> [options]

Option	Default	Description
`<cmd...>`	—	Required — the stdio server command
`--port <n>`	3100	HTTP port
`--host <host>`	localhost	Bind hostname
`--name <name>`	—	Server name for middleware context
`--rate-limit <n>`	100	Max tool calls per agent per minute
`--timeout <ms>`	30000	Response timeout in ms

Examplesh

npx @businys/ops bridge node ./server.js
npx @businys/ops bridge python server.py --port 3200 --rate-limit 50

`status`

Print current stats from a running Observer Mode instance.

Usagesh

npx @businys/ops status [options]

Option	Default	Description
`--port <n>`	3100	Observer port to query

Examplesh

npx @businys/ops status
npx @businys/ops status --port 3200

Environment variables

Variable	Description
`BDEV_API_KEY`	API key for the hosted dashboard. Used by `deploy` and `HostedAdapter`.