aws / aws/aws-toolkit-vscode

Amazon Q MCP Client sends unsupported 'explanation' parameter to MCP Server

Open
#7,540 0 comments 0 reactions 0 assignees View on GitHub
bug
Dominant language
TypeScript
Stars
2k
Forks
807
Avg merge
10h 12m
Merged PRs (30d)
7

Description

## Problem
Amazon Q MCP Client adds an 'explanation' parameter when calling MCP tools, which causes FastMCP servers with strict parameter validation to reject requests with 'unexpected_keyword_argument' errors.
https://github.com/sooperset/mcp-atlassian/issues/480

![Error Screenshot](https://github.com/user-attachments/assets/5b09b7b8-c937-45cc-9257-6561ffa62b82)

## Steps to Reproduce
- **MCP Client**: Amazon Q plugin for IDE
- **MCP Transport/Bridge**: npm remote-mcp
- **MCP Server**: SSE exposed Jira endpoints

https://github.com/geelen/mcp-remote
https://github.com/sooperset/mcp-atlassian

## Expected Behavior
Amazon Q should respect MCP tool schemas and only send defined parameters, or provide a configuration option to disable automatic parameter injection.

## Current Workaround
Explicitly instruct Amazon Q in prompt not to use explanation: "Connect to Jira and get issue with Id PRO-1234 but do not use explanation."

## System Details
- **OS**: Windows_NT x64 10.0.22631
- **Visual Studio Code**: 1.100.0
- **Amazon Q version**: 1.77.0
- **MCP Transport**: npm remote-mcp

Contributor guide

Open the contributing guide

Research direction

Reproduce with Amazon Q 1.77.0 in VS Code 1.100.0 using the npm remote-mcp bridge and an SSE Jira endpoint; confirm that the strict FastMCP server rejects the injected explanation parameter. Trace the MCP tool-call handling and verify completion when only schema-defined parameters are sent, or when parameter injection can be disabled.

Written by the indexing model from the issue text.

Assessment

Tech stack
vscode
Domain
ai, devtools
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.