Exa MCP server unable to connect in KiloCode: remote URL vs npx config
I configured the Exa MCP server in KiloCode on Windows 11 (Node.js v22.17.0) using
npx -y exa-mcp-server https://mcp.exa.ai/mcpwith anEXA_API_KEYenv var, but the server fails to connect and never becomes operational. What is the correct configuration for KiloCode?Originally asked on GitHub: https://github.com/exa-labs/exa-mcp-server/issues/82
4 answers
This was a configuration issue, not a server outage: the original config mixes two connection methods that Exa provides separately — the hosted remote MCP endpoint and the local npm package. A contributor explained that you should pick one.
Option 1 — hosted remote URL (recommended for KiloCode, no API key):
json"exa": { "type": "streamable-http", "url": "https://mcp.exa.ai/mcp" }To enable only specific tools, append them as a query parameter:
https://mcp.exa.ai/mcp?tools=get_code_context_exa,web_search_exaOption 2 — local npm package (requires your own API key, no URL):
json"exa": { "command": "npx", "args": ["-y", "exa-mcp-server"], "env": { "EXA_API_KEY": "YOUR_API_KEY" } }The failing setup combined
npx exa-mcp-serverwith the remote URL inargs, which is why KiloCode could not connect. The contributor also opened issue #166 to add KiloCode setup instructions to the README.Security note: with the remote URL option no API key is needed, so you don't have to put an
EXA_API_KEYin your client config at all; if you use the npm package, keep the key out of shared or committed config files.Did this work for you?What a GitHub user tried on GitHub (Didn't work)
User configured Exa in KiloCode on Windows 11 with
npx -y exa-mcp-server https://mcp.exa.ai/mcp tools=get_code_context_exa,web_search_exaand anEXA_API_KEYenv var; the server failed to connect.Source: https://github.com/exa-labs/exa-mcp-server/issues/82 (opens external site)
Did this work for you?What @devin-ai-integration tried on GitHub (Outcome unclear)
Contributor showed two valid configs: remote streamable-http URL without an API key (optional
?tools=query parameter), or the npm package without any URL but with a realEXA_API_KEY. The issue was closed as completed, but the thread does not explicitly confirm the user applied either fix.Source: https://github.com/exa-labs/exa-mcp-server/issues/82#issuecomment-3861060490 (opens external site)
Did this work for you?What @richtong tried on GitHub (Outcome unclear)
Commenter suggested the syntax was wrong and that the http URL should be removed while using a real API key; no confirmation that this alone worked.
Source: https://github.com/exa-labs/exa-mcp-server/issues/82#issuecomment-3621332797 (opens external site)
Did this work for you?
Related questions
- exa-mcp-server stdio fails with SyntaxError: Invalid or unexpected token on shebang line
- exa-mcp-server crashes with "SyntaxError: Invalid or unexpected token" — how to fix?
- exa-mcp-server ignores --tools option after update: how to select enabled tools?
- Exa MCP server returns HTTP 400 on remote setup (Smithery / mcp-remote)
- Exa MCP hosted SSE endpoint (mcp.exa.ai/mcp) down?