docs.businys.dev

@businys/ops

Production MCP Middleware

@businys/ops is the operational layer for MCP servers in production. Observability, rate limiting, billing, audit logging, Agent Lineage, and human oversight — assembled from a production deployment of 188+ tools, packaged as a single open-source library.

Quickstart →CLI reference
$npm install @businys/ops
Observer Mode
Zero-config real-time dashboard. Every tool call visible in seconds.
Agent Lineage
Causal DAG from human prompt to tool call. Immutable hash chain.
MCP Revenue
Per-call billing. Credit wallets. Budget enforcement before execution.
Rate Limiting
Per-agent + per-group sliding window. Automatic reputation scoring.
Audit Logging
Structured JSON audit trail. EU AI Act Art. 12 compliant.
Human Oversight
Confirmation middleware. Override any tool call before execution.

How it works

@businys/ops wraps any MCP server in a middleware pipeline. Each request passes through layers in order: lineage, telemetry, metering, reputation, rate limiting, confirmation, revenue, and audit. You control which layers are active.

The pipeline is storage-agnostic. Swap between MemoryAdapter (zero config), FileAdapter (persistent local), PostgresAdapter (production), or HostedAdapter (streams to the hosted dashboard).

Three ways to use it

1
CLI — zero code
npx @businys/ops observe — Observer Mode in seconds. Wrap any stdio MCP server with a one-liner.
2
Proxy — one function
createMCPProxy() assembles the full pipeline. Drop it in front of any MCP handler.
3
Hosted dashboard
HostedAdapter + npx @businys/ops deploy. Call data streams to businys.dev in real time.

Compatibility

RuntimeMinimum versionNotes
Node.js18+Full support
Bun1.0+Full support
Deno1.40+ESM only
Edge runtimesCLI not supported; library adapters work

License

MIT. Free for commercial use. View on GitHub →