openclaw - 💡(How to fix) Fix MCP tools not accessible to main agent — only to embedded Pi/coding sessions [3 comments, 3 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#74387Fetched 2026-04-30 06:24:28
View on GitHub
Comments
3
Participants
3
Timeline
9
Reactions
2
Author
Timeline (top)
commented ×3cross-referenced ×3closed ×1mentioned ×1

Fix Action

Fix / Workaround

Option A: Allow mcp.servers definitions to be used by the main agent tool dispatch layer Option B: Add a config flag like mcp.exposeToMainAgent: true Option C: Document the limitation clearly and provide best-practice guidance

Workaround (Current)

RAW_BUFFERClick to expand / collapse

Problem

Currently, MCP servers configured under mcp.servers in openclaw.json are only accessible to embedded Pi / coding agent runtimes, not to the main OpenClaw agent.

The openclaw mcp list command only manages the MCP server registry, not the actual tool exposure to the main agent. MCP server definitions stored via mcp.servers are consumed by embedded runtime adapters (like Pi), while the main agent communicates with models via model providers directly.

This means:

  • Main agent image tool → model provider (e.g. Minimax API) → limited by model capability
  • Main agent cannot use MCP tools like web_search, understand_image from MCP servers

Expected Behavior

MCP tools should be usable by the main OpenClaw agent in the same way they are usable by embedded Pi/coding sessions.

Proposed Solutions

Option A: Allow mcp.servers definitions to be used by the main agent tool dispatch layer Option B: Add a config flag like mcp.exposeToMainAgent: true Option C: Document the limitation clearly and provide best-practice guidance

Workaround (Current)

Use shell exec to call mmx CLI directly for image understanding and web search. This works but bypasses the MCP abstraction layer.


Submitted via OpenClaw agent.

extent analysis

TL;DR

To make MCP tools accessible to the main OpenClaw agent, consider modifying the configuration to expose MCP servers to the main agent tool dispatch layer.

Guidance

  • Review the proposed solutions (Option A, B, C) and assess their feasibility for your specific use case.
  • If a direct configuration change is not possible, evaluate the current workaround using shell exec to call mmx CLI directly, understanding its limitations and potential security implications.
  • Investigate the openclaw.json configuration file to understand how mcp.servers definitions are currently being used and how they might be extended or modified to support main agent access.
  • Consider the trade-offs between directly exposing MCP tools to the main agent versus maintaining the current abstraction layer for model interactions.

Example

No specific code example is provided due to the lack of detailed implementation information in the issue.

Notes

The solution may depend on the specific requirements and constraints of the OpenClaw agent and its interaction with MCP servers. Directly exposing MCP tools to the main agent could introduce complexity or security risks that need to be carefully evaluated.

Recommendation

Apply a workaround, such as using the shell exec method to call mmx CLI directly, until a more integrated solution can be implemented, as it provides an immediate, albeit temporary, fix to the accessibility issue of MCP tools.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING