Getting started

Quickstart

From zero to your first tool call in the dashboard — under 3 minutes.

1. Install

npm install @businys/ops
# or
pnpm add @businys/ops

2. Start Observer Mode

The fastest way to start is observe — a zero-config in-memory dashboard that shows every tool call in real time. No config file, no API key, no database.

npx @businys/ops observe

Open http://localhost:3100. You'll see a live dashboard ready to receive calls.

3. Wrap your MCP server

If you have a stdio MCP server, bridge it to HTTP with full middleware in one command:

# Start Observer + Bridge together
npx @businys/ops dev node ./my-server.js

# Observer dashboard: http://localhost:3100
# Bridge endpoint:   http://localhost:3101

Point your MCP client at http://localhost:3101 and watch calls appear in the dashboard at http://localhost:3100.

4. Use the library directly

For programmatic use, createMCPProxy assembles the full middleware pipeline:

import { createMCPProxy, observe } from "@businys/ops"

// Assemble middleware pipeline
const proxy = createMCPProxy()

// Start the Observer Mode dashboard
const ops = await observe({ port: 3100 })

// In your MCP request handler:
const result = await proxy.run(ctx, async () => {
  return yourActualToolHandler(ctx)
})

5. Connect to the hosted dashboard

To persist call data across restarts and share dashboards with your team, connect to the hosted dashboard:

# 1. Get an API key from businys.dev/dashboard
# 2. Run deploy to link your project
npx @businys/ops deploy --key sk-live-your-key

import { HostedAdapter, createMCPProxy } from "@businys/ops"

const storage = new HostedAdapter({ apiKey: process.env.BDEV_API_KEY! })
const proxy = createMCPProxy({ storage })

Calls stream to your project dashboard in real time. Data persists with your configured retention period.