Migrate MCP Configuration
- Preview without modifying the file:
fast-agent config migrate-mcp path/to/fast-agent.yaml. - Resolve any reported conflicts.
- Apply with
fast-agent config migrate-mcp path/to/fast-agent.yaml --write. The command saves the exact original aspath/to/fast-agent.yaml.bak. - Inspect the redacted result with
fast-agent config show-mcp path/to/fast-agent.yaml --view effective.
The primary shape changes from a named list:
to a server map:
- Moved paths:
mcp.targets→mcp.servers, top-levelauto_sampling→mcp.client.auto_sampling, and top-levelmcp_timeline→mcp.diagnostics.timeline. - Resolve conflicts before rerunning. The command refuses files containing both
an old and new path, duplicate migrated server names, or a
targetcombined with source fields such astransport,url,command,args, orconnector_id. - Runtime commands are now explicit:
/mcp attach docsattaches the configureddocsdefinition;/connect TARGETand/mcp connect TARGETalways create an ad-hoc session definition./mcpand/mcp statusshow status. /mcpstatusremains available temporarily and emits a deprecation warning.- Startup
--urlis repeatable. Prefer one flag per URL; comma-separated input is temporary compatibility behavior. - Current schema: Connect to MCP Servers and Configuration Reference.