Skip to content

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