MCP connection refused and timeout errors
TL;DR
An MCP connection error means the client could not reach the server. For local servers the process failed to start; for remote servers the HTTP endpoint was unreachable, timed out, or was misaddressed. Verify the transport, address, port, and that the server is running.
Local (stdio) errors
A stdio server that cannot start (bad command, missing binary) produces a connection failure. Confirm the command works when run directly and the transport config matches.
Remote (HTTP) errors
Connection refused on HTTP means nothing is listening at the address, or a firewall blocks the port. A timeout means the host is reachable but not answering. Verify the URL, port, and that the service is running behind any proxy.
In this collection
- Best MCP servers →
- How to choose an MCP server →
- Verified MCP servers →
- MCP server comparison methodology →
- MCP registries, directories, and marketplaces →
- MCP servers for databases →
- Read-only database access with MCP →
- MCP servers for developers →
- MCP browser automation →
- MCP servers for search and research →
- MCP servers for productivity →
- MCP servers for DevOps and cloud →
- Enterprise MCP →
- Postgres MCP server guide →
- Playwright MCP →
- MCP server not showing in Claude Desktop →
- Cursor MCP tools not showing →
- Claude Desktop MCP configuration →
- VS Code MCP configuration →
- Remote MCP servers with OAuth →
- MCP server for GitHub →