Skip to content

Getting Started

Prerequisites

Install

go install github.com/Veedubin/neuralgentics-broker/cmd/broker@v0.1.0

This puts the broker binary in $GOPATH/bin (or $HOME/go/bin by default). Make sure that directory is on your $PATH.

Verify:

broker --help

Minimal config

Create a servers.yaml listing the MCP servers the broker should spawn:

servers:
  - name: filesystem
    command: npx
    args: [-y, @modelcontextprotocol/server-filesystem, /tmp]
  - name: github
    command: npx
    args: [-y, @modelcontextprotocol/server-github]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: $GITHUB_TOKEN

See Configuration for the full schema.

First call

Start the broker:

broker --config=servers.yaml

The broker exposes an MCP server on stdio. Point your agent (or any MCP client) at the broker as if it were a single MCP server; the broker will fan requests out to the configured servers, return results, and write one audit record per tool call to ~/.neuralgentics/broker_audit.jsonl.

To enable Postgres audit alongside JSONL:

broker --config=servers.yaml --audit=jsonl+pg --audit-pg-url=postgres://user:pass@host/db

See Audit for the schema and the T-117.5 race-fix note.

Next steps