Cline error
Cline: Invalid MCP settings format
Invalid MCP settings format. Please ensure your settings follow the correct JSON format.Status: WorkaroundLast verified 3 documented fixes4 sources
What it means
Cline could not validate cline_mcp_settings.json against its MCP settings schema, so no servers load.
Causes
- Settings file that does not match the expected schema (for example a missing top-level "mcpServers" object).
- Reported on 3.8.3 and 3.16.3 even after marketplace installs; consolidated by maintainers into the MCP system issues tracker #4391.
How to fix it
- Fix 1.
Use the documented structure: a top-level "mcpServers" object, one entry per server. Local (STDIO) example from the docs:
JSON{ "mcpServers": { "local-server": { "command": "node", "args": ["/path/to/server.js"], "env": { "API_KEY": "your_api_key" }, "disabled": false, "autoApprove": [] } } } - Fix 2.
For remote servers, the docs say the "type" field selects the transport; omitting it defaults to legacy "sse", so set "type": "streamableHttp" explicitly.
JSON"type": "streamableHttp" - Fix 3.
Update Cline: 4.0.0 "Migrate legacy MCP files and formats into the shared settings file and protect MCP settings writes with safer locking/atomic updates."
More Cline errors
All 17 Cline errorsShell Integration Unavailable. Cline may have trouble viewing the command's output. Please update VSCode (CMD/CTRL + Shift + P → "Update") and make sure you're using a supported shell: zsh, bash, fish, or PowerShell (CMD/CTRL + Shift + P → "Terminal: Select Default Profile").Status: WorkaroundError executing command: The command ran successfully, but we couldn't capture its output. Please proceed accordingly.Status: Fixed in releaseCommand failed with exit code 1: powershell (Get-CimInstance -ClassName Win32_OperatingSystem).caption 'powershell' is not recognized as an internal or external command, operable program or batch file.Status: WorkaroundUnexpected API Response: The language model did not provide any assistant messages. This may indicate an issue with the API or the model's output.Status: WorkaroundInvalid API Response: The provider returned an empty or unparsable response. This is a provider-side issue where the model failed to generate valid output or returned tool calls that Cline cannot process. Retrying the request may help resolve this issue.Status: OpenModel returned empty responseStatus: OpenFunction call is missing a thought_signature in functionCall parts. This is required for tools to work correctly, and missing thought_signature may lead to degraded model performance.Status: Fixed in release429 {"type":"error","error":{"type":"rate_limit_error","message":"Number of request tokens has exceeded your per-minute rate limit (https://docs.anthropic.com/en/api/rate-limits); see the response headers for current usage. Please reduce the prompt length or the maximum tokens requested, or try again later. You may also contact sales at https://www.anthropic.com/contact-sales to discuss your options for a rate limit increase."}}Status: Workaround
Related reading
- What Is Cline? The Open-Source AI Coding Agent for VS CodeCline is a free, open-source VS Code extension for agentic AI coding. Bring your own model, a cloud API or a local one via Ollama, with no vendor lock-in.
- Every AI Coding Tool Compared: The 2026 MatrixEvery AI coding tool compared: 15 terminal, IDE, cloud and browser tools side by side on pricing, model surface, strengths, weaknesses and best use cases.
FAQ
What does "Invalid MCP settings format" mean in Cline?
Cline could not validate cline_mcp_settings.json against its MCP settings schema, so no servers load.
How do I fix "Invalid MCP settings format"?
There are 3 documented fixes. Start with the first: Use the documented structure: a top-level "mcpServers" object, one entry per server. Local (STDIO) example from the docs:
Is this Cline error fixed?
Status: Workaround. No release removes the cause. The documented fixes work around it. Affected versions: Reported on 3.8.3 and 3.16.3
Sources
Last verified against 4 sources: official docs, maintainer replies and release notes.
- github.comhttps://github.com/cline/cline/issues/2459
- github.comhttps://github.com/cline/cline/issues/4391
- docs.cline.bothttps://docs.cline.bot/mcp/mcp-overview
- github.comhttps://github.com/cline/cline/blob/main/CHANGELOG.md
Newsletter
Fixes for the tools you use, weekly
One email per week. New coding agent releases, what broke, and how developers are working around it.