aws / aws/amazon-q-developer-cli

Feature Request: Support toolAliases in mcp.json like agent

Open
#2,564 4 comments 1 reaction 0 assignees View on GitHub
Dominant language
Rust
Stars
2k
Forks
439
PR merge metrics
No merged PRs in 30d

Description

### Checks

- [x] I have searched [github.com/aws/amazon-q-developer-cli/issues](https://github.com/aws/amazon-q-developer-cli/issues?q=) and there are no duplicates of my issue
- [x] I have run `q doctor` in the affected terminal session
- [x] I have run `q restart` and replicated the issue again

### Operating system

macOS 14.3.1 (23D60)

### Expected behaviour

The mcp.json configuration file should support a `toolAliases` field that allows users to create custom aliases for MCP tools to resolve naming conflicts or provide more intuitive names. This would work similarly to how `toolAliases` is supported in agent configuration files.

### Actual behaviour

Currently, the mcp.json configuration file does not support `toolAliases`. Users cannot create custom aliases for MCP tools directly in the MCP configuration, which can lead to naming conflicts when multiple MCP servers provide tools with same names or when users want more intuitive tool names.

### Steps to reproduce

1. Create or edit an mcp.json file (either global at ~/.aws/amazonq/mcp.json or workspace-specific at .amazonq/mcp.json)
2. Try to add a `toolAliases` field to define custom aliases for MCP tools
3. Observe that this field is not recognized or supported in the MCP configuration

### Environment

```yaml
[q-details]
version = "1.13.2"
hash = "36e70d1cad4465a9ea479bb7f10d7973b717b4f7"
date = "2025-08-08T20:16:09.268082Z (3d ago)"

[system-info]
os = "macOS 14.3.1 (23D60)"
chip = "Intel(R) Core(TM) i7-1068NG7 CPU @ 2.30GHz"
total-cores = 4
memory = "16.00 GB"

[environment]
cwd = "/Users/USER"
cli-path = "/Users/USER"
install-method = "brew"

[env-vars]
PATH = "/Users/USER/.sdkman/candidates/java/current/bin:/Users/USER/.sdkman/candidates/groovy/current/bin:/Users/USER/.sdkman/candidates/gradle/current/bin:/usr/local/bin:/System/Cryptexes/App/usr/bin:/usr/bin:/bin:/usr/sbin:/sbin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/local/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/appleinternal/bin:/Users/USER/.cargo/bin:/Applications/iTerm.app/Contents/Resources/utilities:/Users/USER/.local/bin:/Users/USER/.orbstack/bin"
QTERM_SESSION_ID = "933f7a72395e438189d11a9f3b9ef807"
Q_SET_PARENT_CHECK = "1"
Q_TERM = "1.13.2"
SHELL = "/bin/zsh"
TERM = "xterm-256color"
__CFBundleIdentifier = "com.googlecode.iterm2"

[chat-settings]

[chat-trusted_tools]
fs_read=trusted
@github/search_issues=trusted

[chat-failed_request_ids]
none

[chat-context]
current_profile=default
profile_context=none

files=none
```

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.