Skip to content

Incorrect type for mcp_call Response output item #1568

Open
@Floriferous

Description

@Floriferous

Confirm this is a Node library issue and not an underlying OpenAI API issue

  • This is an issue with the Node library

Describe the bug

There's a type mistake in the mcp_call response output item. The type of item.error says it should be string | null, but I received an object with multiple properties. Not sure if the issue is the type definition, or if the error wasn't turned into a string somewhere else.

Here's the type definition of McpCall:

  export interface McpCall {
    /**
     * The unique ID of the tool call.
     */
    id: string;

    /**
     * A JSON string of the arguments passed to the tool.
     */
    arguments: string;

    /**
     * The name of the tool that was run.
     */
    name: string;

    /**
     * The label of the MCP server running the tool.
     */
    server_label: string;

    /**
     * The type of the item. Always `mcp_call`.
     */
    type: 'mcp_call';

    /**
     * The error from the tool call, if any.
     */
    error?: string | null;

    /**
     * The output from the tool call.
     */
    output?: string | null;
  }

And here's an mcp_call item I just got from the responses API:

const item = {
  id: 'mcp_68653a694bec8198a308e96e37ba509b09483f21bc1f2ea7',
  type: 'mcp_call',
  approval_request_id: null,
  arguments: '{"query":"latest tech gadgets"}',
  error: {
    type: 'mcp_protocol_error',
    code: 32600,
    message: 'Session terminated'
  },
  name: 'search',
  output: null,
  server_label: 'my-mcp-server'
}

To Reproduce

Use the responses API like this:

  const response = await openaiClient.responses.create({
    input: "Hello world, please call a tool",
    model: 'gpt-4o',
    tools: [
      {
        require_approval: 'never',
        server_label: 'my-mcp-server',
        server_url: mcpServerUrl,
        type: 'mcp',
      },
    ],
  });

Have a failing MCP server (not sure what the actual underlying Session terminated error is) that generated this kind of error.

Code snippets

OS

macOS

Node version

v20

Library version

openai v5.8.2

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingopenapi

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions