fix: add EXA_API_KEY header support for websearch_exa MCP (#499)

raydocs · junhoyeo · web-flow · commit 7981c8661375 · 2026-01-07T06:12:22.000+09:00
The remote MCP endpoint https://mcp.exa.ai/mcp requires API key authentication via x-api-key header. Without this, the connection times out waiting for auth. This change: - Reads EXA_API_KEY from environment variable - Passes it as x-api-key header when available - Updates RemoteMcpConfig type to support optional headers Co-authored-by: Junho Yeo <i@junho.io>
diff --git a/src/mcp/index.ts b/src/mcp/index.ts
@@ -5,14 +5,21 @@ import type { McpName } from "./types"
 
 export { McpNameSchema, type McpName } from "./types"
 
-const allBuiltinMcps: Record<McpName, { type: "remote"; url: string; enabled: boolean }> = {
+type RemoteMcpConfig = {
+  type: "remote"
+  url: string
+  enabled: boolean
+  headers?: Record<string, string>
+}
+
+const allBuiltinMcps: Record<McpName, RemoteMcpConfig> = {
   websearch,
   context7,
   grep_app,
 }
 
 export function createBuiltinMcps(disabledMcps: string[] = []) {
-  const mcps: Record<string, { type: "remote"; url: string; enabled: boolean }> = {}
+  const mcps: Record<string, RemoteMcpConfig> = {}
 
   for (const [name, config] of Object.entries(allBuiltinMcps)) {
     if (!disabledMcps.includes(name)) {
diff --git a/src/mcp/websearch.ts b/src/mcp/websearch.ts
@@ -2,4 +2,7 @@ export const websearch = {
   type: "remote" as const,
   url: "https://mcp.exa.ai/mcp?tools=web_search_exa",
   enabled: true,
+  headers: process.env.EXA_API_KEY
+    ? { "x-api-key": process.env.EXA_API_KEY }
+    : undefined,
 }

Original file line number	Diff line number	Diff line change
`@@ -2,4 +2,7 @@ export const websearch = {`
`2`	`2`	`type: "remote" as const,`
`3`	`3`	`url: "https://mcp.exa.ai/mcp?tools=web_search_exa",`
`4`	`4`	`enabled: true,`
	`5`	`+ headers: process.env.EXA_API_KEY`
	`6`	`+ ? { "x-api-key": process.env.EXA_API_KEY }`
	`7`	`+ : undefined,`
`5`	`8`	`}`