[Feature]: Externel MCP Server Support

[vuthanhtrung2010]

Summary

Support externel MCP server via npm or remote MCP

Problem statement

The tools should be more mature and wider support

Proposed solution

Add config for external mcp server, for eg:

{
  "mcpServers": {
    "camoufox": {
      "command": "npx",
      "args": ["-y", "camoufox-mcp-server"]
    }
  }
}

Non-goals / out of scope

Only change the config file and it's handler code

Alternatives considered

No response

Acceptance criteria

• COnfig key should documented & validated

Architecture impact

idk

Risk and rollback

disable MCP, I think no risk

Breaking change?

No

Data hygiene checks

• I removed personal/sensitive data from examples, payloads, and logs.
• I used neutral, project-focused wording and placeholders.

[github-actions]

Thanks for opening this issue.

Before maintainers triage it, please confirm:

• Repro steps are complete and run on latest main
• Environment details are included (OS, Rust version, ZeroClaw version)
• Sensitive values are redacted

This helps us keep issue throughput high and response latency low.

[nightwalker89]

You can add the mcportor skill for it

[vuthanhtrung2010]

You can add the mcportor skill for it

Ah ok i will try it

[theonlyhennygod]

Implemented in this fix set. Added external MCP server support via config ( with named servers, plus alias compatibility) and strict validation for stdio vs remote transports.\n\nClosing as fixed. If there is a missing provider/transport scenario, share a sample config and we can reopen.

[theonlyhennygod]

Correction/clean summary:

Implemented external MCP server support in config:

• [mcp] with named server entries
• compatibility alias mcpServers
• validation for stdio vs remote transports (command/args vs url/headers)

Closing as fixed. If there is still a missing transport/provider case, share a minimal repro config and we can reopen.

[krishnapraveen7]

@theonlyhennygod Awesome dude.

[muhlba91]

is there an example config for this? unfortunately. i haven‘t found something in the docs. are npx based servers also supported?

[danividalg]

Hi, I searched the code and I only found "mcp" word in some places related to "osaurus".
Is MCP server support actually in the main branch ?

[theonlyhennygod]

Root cause

• main did not contain MCP server integration and had no [mcp] runtime config path.

What changed

• Added native MCP client stack (stdio / http / sse) and MCP tool wrapper integration.
• Wired MCP tool discovery into channel startup so MCP tools register at runtime.
• Added [mcp] schema with compatibility alias mcpServers and transport validation.
• Added daemon startup port-conflict guard.

Why this resolves

• ZeroClaw can now connect to configured external MCP servers and expose discovered tools in runtime tool registry.

PR

• feat(mcp): add external MCP server support on main #2013

Validation

• cargo check
• cargo test mcp_ -- --nocapture