Skip to content
kagent 0.10.x is superseded by kagent 1.0. For the current release, see the latest docs. To move an existing installation, see Upgrade from 0.x.

For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.

kagent add-mcp

Page as Markdown
Add an MCP server entry to kagent.yaml.
Add an MCP server entry to kagent.yaml. Use flags for non-interactive setup or run without flags to open the wizard.
kagent add-mcp [name] [args...] [flags]
Flags:
  • --arg strings - Command argument (repeatable)
  • --build string - Container build (optional; mutually exclusive with –image)
  • --command string - Command to run MCP server (e.g., npx, uvx, kmcp, or a binary)
  • --env strings - Environment variable in KEY=VALUE format (repeatable)
  • --header strings - HTTP header for remote MCP in KEY=VALUE format (repeatable, supports ${VAR} for env vars)
  • -h, --help - help for add-mcp
  • --image string - Container image (optional; mutually exclusive with –build)
  • --project-dir string - Project directory (default: current directory)
  • --remote string - Remote MCP server URL (http/https)
Global Flags:
  • --config string - config file (default is $HOME/.kagent/config.yaml) (default “$HOME/.kagent/config.yaml”)
  • --kagent-url string - KAgent URL (default “http://localhost:8083”)
  • -n, --namespace string - Namespace (default “kagent”)
  • -o, --output-format string - Output format (default “table”)
  • --timeout duration - Timeout (default 5m0s)
  • -v, --verbose - Verbose output
kagent bug-report