Quickstart
Run the core and gateway with a minimal setup.
This path assumes you want a headless deployment with config files. It uses the default layout: one config directory, one core process, and one gateway.
Create a config directory and add a YAML file with at least one server definition.
Validate the configuration so the core can load it.
Start the core and point it at your config directory.
Start the gateway and choose a routing mode.
Connect a client to the gateway and make a test call.
Minimal config example
Create a YAML file in your config directory, for example runtime.yaml:
servers:
- name: weather
transport: stdio
cmd: [node, ./path/to/server.js]
tags: [chat]
idleSeconds: 60
maxConcurrent: 1
strategy: stateless
activationMode: on-demand
protocolVersion: "2025-11-25"Validate and run
Validate your config, then start the core:
go run ./cmd/mcpv validate --config .
go run ./cmd/mcpv serve --config .Start the gateway in one of two modes:
# Tag mode
go run ./cmd/mcpvmcp --tag chat
# Single-server mode
go run ./cmd/mcpvmcp --server weatherIf your client can list tools successfully, the system is wired correctly.