add optional timeout field to mcp config to allow users to use responding servers

[mattgillard]

This issue was blocking my work so contributing a fix.

I needed to set this slightly higher timeout so opencode registers the atlassian tools. Otherwise i get this error in the logs:

INFO  2025-10-30T04:43:45 +16ms service=mcp name=atlassian type=local found 
WARN  2025-10-30T04:44:11 +25749ms service=mcp name=atlassian mcp client verification failed, dropping client

With this slightly higher timeout its fine - there is still a weird delay but I have not debugged that yet:

INFO  2025-10-30T04:38:20 +16ms service=mcp name=atlassian type=local found
INFO  2025-10-30T04:38:51 +31600ms service=bus type=message.updated publishing

My MCP config:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "atlassian": {
      "type": "local",
      "command": ["npx", "-y", "mcp-remote", "https://mcp.atlassian.com/v1/sse", "--transport", "sse-only", "--debug"],
      "enabled": true,
    }
  },
}

[rekram1-node]

@mattgillard can we instead make timeout an optional param for an mcp server in the config? We like to error earlier if possible and 10 seconds is a long time

[mattgillard]

@mattgillard can we instead make timeout an optional param for an mcp server in the config? We like to error earlier if possible and 10 seconds is a long time

sure i can have a go at that

[mattgillard]

@mattgillard can we instead make timeout an optional param for an mcp server in the config? We like to error earlier if possible and 10 seconds is a long time

this is done and tested

[rekram1-node]

Thanks!

[rekram1-node]

/oc in this PR reword all "Timeout in milliseconds for tools....." to say "Timeout in ms for fetching tools from the MCP server."

[opencode-agent]

Perfect! I've successfully updated all 4 occurrences of the timeout description text:

1. packages/opencode/src/config/config.ts:289 - McpLocal timeout description
2. packages/opencode/src/config/config.ts:351 - McpRemote timeout description
3. packages/web/src/content/docs/mcp-servers.mdx:115 - Local MCP timeout table entry
4. packages/web/src/content/docs/mcp-servers.mdx:149 - Remote MCP timeout table entry

All instances now say "Timeout in ms for fetching tools from the MCP server." instead of "Timeout in milliseconds for tools verification." as requested.

opencode session  |  github run

[rekram1-node]

Thanks Matt!