openclaw - 💡(How to fix) Fix [Feature]: Feature Request: Support tool alias/renaming for MCP servers to avoid name conflicts [1 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#54886Fetched 2026-04-08 01:34:49
View on GitHub
Comments
0
Participants
1
Timeline
1
Reactions
0
Author
Participants
Timeline (top)
labeled ×1

Root Cause

skipped tool "web_search" from server "minimax" because the name already exists.

Fix Action

Fix / Workaround

Workaround

RAW_BUFFERClick to expand / collapse

Summary

Problem

When configuring multiple MCP servers that expose tools with identical names (e.g., multiple web_search tools), OpenClaw skips duplicate tools with the message:

skipped tool "web_search" from server "minimax" because the name already exists.

This prevents users from having multiple MCP providers active simultaneously, even when the tools serve the same purpose but come from different providers.

Problem to solve

Use Case

A user may want to:

• Use Tavily for general web search • Use MiniMax MCP for coding-specific search • Have both available simultaneously without name conflicts

Workaround

Currently, users must disable one MCP server to avoid conflicts, limiting functionality.

Proposed solution

Add support for tool aliasing/renaming in the MCP server configuration. For example:

{
"mcp": {
"servers": {
"minimax": {
"command": "uvx",
"args": ["minimax-coding-plan-mcp", "-y"],
"env": {
"MINIMAX_API_KEY": "...",
"MINIMAX_API_HOST": "https://api.minimax.io"
},
"toolAlias": {
"web_search": "minimax_web_search",
"understand_image": "minimax_understand_image"
}
}
}
}
}

Or alternatively, a simpler prefix approach:

{
"mcp": {
"servers": {
"minimax": {
"command": "uvx",
"args": ["minimax-coding-plan-mcp", "-y"],
"toolPrefix": "minimax_"
}
}
}
}



### Alternatives considered

_No response_

### Impact

limit the tools usage

### Evidence/examples

_No response_

### Additional information

_No response_

extent analysis

Fix Plan

To support tool aliasing/renaming in the MCP server configuration, follow these steps:

  • Update the MCP server configuration to include a toolAlias or toolPrefix property.
  • For the toolAlias approach:
    • Add a toolAlias object to the server configuration.
    • Specify the original tool name as the key and the desired alias as the value.
  • For the toolPrefix approach:
    • Add a toolPrefix property to the server configuration.
    • Specify the desired prefix for the tool names.

Example configuration using toolAlias:

{
  "mcp": {
    "servers": {
      "minimax": {
        "command": "uvx",
        "args": ["minimax-coding-plan-mcp", "-y"],
        "env": {
          "MINIMAX_API_KEY": "...",
          "MINIMAX_API_HOST": "https://api.minimax.io"
        },
        "toolAlias": {
          "web_search": "minimax_web_search",
          "understand_image": "minimax_understand_image"
        }
      }
    }
  }
}

Example configuration using toolPrefix:

{
  "mcp": {
    "servers": {
      "minimax": {
        "command": "uvx",
        "args": ["minimax-coding-plan-mcp", "-y"],
        "toolPrefix": "minimax_"
      }
    }
  }
}

Verification

To verify that the fix worked, check that:

  • The MCP server is able to register tools with the aliased or prefixed names.
  • The user is able to access the tools with the aliased or prefixed names without conflicts.

Extra Tips

  • Make sure to update the MCP server configuration correctly to avoid any syntax errors.
  • Test the configuration with different tool names and prefixes to ensure that the aliasing/renaming works as expected.

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

openclaw - 💡(How to fix) Fix [Feature]: Feature Request: Support tool alias/renaming for MCP servers to avoid name conflicts [1 participants]