Skip to content
kagent 1.0 is available as an alpha release. To read its documentation, see the 1.x docs.

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