Skip to content

Fix: Correctly detect MCP tool errors#14937

Merged
scidomino merged 1 commit intomainfrom
kevin-ramdass/mcp
Dec 11, 2025
Merged

Fix: Correctly detect MCP tool errors#14937
scidomino merged 1 commit intomainfrom
kevin-ramdass/mcp

Conversation

@kevin-ramdass
Copy link
Copy Markdown
Contributor

@kevin-ramdass kevin-ramdass commented Dec 11, 2025

Summary

This PR fixes a bug where MCP tool errors were being interpreted as successes.

The disocveredMCPTool implementation was previously checking for a nested error.isError property (response.error.isError). However, the MCP specification places isError at the top level of the tool result object (response.isError). This mismatch caused valid error responses from MCP servers to be treated as successful executions.

Details

Related Issues

How to Validate

Tested with local MCP tool that was returning an error.

Pre-Merge Checklist

  • Updated relevant documentation and README (if needed)
  • Added/updated tests (if needed)
  • Noted breaking changes (if any)
  • Validated on required platforms/methods:
    • MacOS
      • npm run
      • npx
      • Docker
      • Podman
      • Seatbelt
    • Windows
      • npm run
      • npx
      • Docker
    • Linux
      • npm run
      • npx
      • Docker

@gemini-code-assist
Copy link
Copy Markdown
Contributor

Summary of Changes

Hello @kevin-ramdass, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request resolves a critical bug in the DiscoveredMCPTool that caused legitimate errors from MCP servers to be mistakenly processed as successful executions. The fix involves adjusting the error detection logic to prioritize the top-level isError property as defined by the MCP specification, while also preserving a legacy check for older implementations. This ensures accurate reporting of tool failures and improves the reliability of tool interactions.

Highlights

  • Bug Fix: Corrected a bug where MCP tool errors were being interpreted as successes due to an incorrect error detection mechanism.
  • Error Detection Logic Update: The DiscoveredMCPTool implementation was updated to correctly detect the isError property at the top level of the tool result object, aligning with the MCP specification.
  • Backward Compatibility: A legacy check for nested error.isError was retained to ensure compatibility with any older MCP tools that might still use this structure.
  • New Test Case: A new test case was added to validate the correct handling of spec-compliant top-level isError responses from MCP tools.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@github-actions
Copy link
Copy Markdown

Size Change: +144 B (0%)

Total Size: 21.6 MB

ℹ️ View Unchanged
Filename Size Change
./bundle/gemini.js 21.6 MB +144 B (0%)
./bundle/sandbox-macos-permissive-closed.sb 1.03 kB 0 B
./bundle/sandbox-macos-permissive-open.sb 890 B 0 B
./bundle/sandbox-macos-permissive-proxied.sb 1.31 kB 0 B
./bundle/sandbox-macos-restrictive-closed.sb 3.29 kB 0 B
./bundle/sandbox-macos-restrictive-open.sb 3.36 kB 0 B
./bundle/sandbox-macos-restrictive-proxied.sb 3.56 kB 0 B

compressed-size-action

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request correctly fixes a bug where MCP tool errors were not being detected. The change aligns with the MCP specification by checking for the isError property at the top level of the tool result object. A new test case has been added to verify this fix. I've suggested an improvement to the new test to make it more comprehensive by covering all cases handled by the implementation. Otherwise, the changes look good and improve the correctness of MCP tool error handling.

Comment on lines +226 to +262
it('should return a structured error if MCP tool reports a top-level isError (spec compliant)', async () => {
const tool = new DiscoveredMCPTool(
mockCallableToolInstance,
serverName,
serverToolName,
baseDescription,
inputSchema,
);
const params = { param: 'isErrorTopLevelCase' };
const functionCall = {
name: serverToolName,
args: params,
};

// Spec compliant error response: { isError: true } at the top level of content (or response object in this mapping)
const errorResponse = { isError: true };
const mockMcpToolResponseParts: Part[] = [
{
functionResponse: {
name: serverToolName,
response: errorResponse,
},
},
];
mockCallTool.mockResolvedValue(mockMcpToolResponseParts);
const expectedErrorMessage = `MCP tool '${serverToolName}' reported tool error for function call: ${safeJsonStringify(
functionCall,
)} with response: ${safeJsonStringify(mockMcpToolResponseParts)}`;
const invocation = tool.build(params);
const result = await invocation.execute(new AbortController().signal);

expect(result.error?.type).toBe(ToolErrorType.MCP_TOOL_ERROR);
expect(result.llmContent).toBe(expectedErrorMessage);
expect(result.returnDisplay).toContain(
`Error: MCP tool '${serverToolName}' reported an error.`,
);
});
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

high

The new test case for spec-compliant MCP errors only validates the case where isError is a boolean true. To ensure the fix is robust and prevent future regressions, it's important to also test the case where isError is the string 'true', as the implementation correctly handles both. I suggest converting this test to use it.each to cover both scenarios, similar to the existing test for legacy error formats.

    it.each([
      { isErrorValue: true, description: 'true (bool)' },
      { isErrorValue: 'true', description: '"true" (str)' },
    ])(
      'should return a structured error if MCP tool reports a top-level isError: $description (spec compliant)',
      async ({ isErrorValue }) => {
        const tool = new DiscoveredMCPTool(
          mockCallableToolInstance,
          serverName,
          serverToolName,
          baseDescription,
          inputSchema,
        );
        const params = { param: 'isErrorTopLevelCase' };
        const functionCall = {
          name: serverToolName,
          args: params,
        };

        // Spec compliant error response: { isError: true } at the top level of content (or response object in this mapping)
        const errorResponse = { isError: isErrorValue };
        const mockMcpToolResponseParts: Part[] = [
          {
            functionResponse: {
              name: serverToolName,
              response: errorResponse,
            },
          },
        ];
        mockCallTool.mockResolvedValue(mockMcpToolResponseParts);
        const expectedErrorMessage = `MCP tool '${serverToolName}' reported tool error for function call: ${safeJsonStringify(
          functionCall,
        )} with response: ${safeJsonStringify(mockMcpToolResponseParts)}`;
        const invocation = tool.build(params);
        const result = await invocation.execute(new AbortController().signal);

        expect(result.error?.type).toBe(ToolErrorType.MCP_TOOL_ERROR);
        expect(result.llmContent).toBe(expectedErrorMessage);
        expect(result.returnDisplay).toContain(
          `Error: MCP tool '${serverToolName}' reported an error.`,
        );
      },
    );

@kevin-ramdass kevin-ramdass marked this pull request as ready for review December 11, 2025 07:09
@kevin-ramdass kevin-ramdass requested a review from a team as a code owner December 11, 2025 07:09
@scidomino scidomino added this pull request to the merge queue Dec 11, 2025
Merged via the queue into main with commit 2d3db97 Dec 11, 2025
19 of 20 checks passed
@scidomino scidomino deleted the kevin-ramdass/mcp branch December 11, 2025 16:50
theerud pushed a commit to theerud/gemini-cli that referenced this pull request Dec 12, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants