bug: MCP - Invalid JSON Schema when using Docker MCP Gateway #468

Open
opened 2026-02-16 17:26:58 -05:00 by yindo · 3 comments
Owner

Originally created by @coeur-de-loup on GitHub (Jul 3, 2025).

Originally assigned to: @thdxr on GitHub.

Description

When attempting to run the Docker MCP gateway, an ⁠AI_APICallError is thrown.

Error

AI_APICallError: Invalid JSON Schema when using Docker MCP Gateway

To Reproduce

opencode.json

{
    "$schema": "https://opencode.ai/config.json",
    "mcp": {
        "MCP_DOCKER": {
            "type": "local",
            "command": ["docker","mcp","gateway","run"],
            "enabled": true
        }
    }
}
Originally created by @coeur-de-loup on GitHub (Jul 3, 2025). Originally assigned to: @thdxr on GitHub. ## Description When attempting to run the Docker MCP gateway, an ⁠AI_APICallError is thrown. ## Error `AI_APICallError: Invalid JSON Schema when using Docker MCP Gateway` ## To Reproduce ### opencode.json ```json { "$schema": "https://opencode.ai/config.json", "mcp": { "MCP_DOCKER": { "type": "local", "command": ["docker","mcp","gateway","run"], "enabled": true } } } ```
Author
Owner

@Kirow commented on GitHub (Nov 21, 2025):

After recent updates (1.0.62 worked few days ago) I start receiving error on any request when Docker MCP Toolkit is enabled. Not sure if it is related to docker update or opencode.

Invalid schema for function 'MCP_DOCKER_mcp-config-set': In context=('properties', 'value', 'type', '4'), array schema missing items.

                {
                    "type": "function",
                    "function": {
                        "name": "MCP_DOCKER_mcp-config-set",
                        "description": "Set configuration values for MCP servers. Creates or updates server configuration with the specified key-value pairs. Supports strings, numbers, booleans, objects, and arrays.",
                        "parameters": {
                            "type": "object",
                            "properties": {
                                "key": {
                                    "type": "string",
                                    "description": "Configuration key to set. This is not to be prefixed by the server name."
                                },
                                "server": {
                                    "type": "string",
                                    "description": "Name of the MCP server to configure"
                                },
                                "value": {
                                    "type": [
                                        "string",
                                        "number",
                                        "boolean",
                                        "object",
                                        "array"
                                    ],
                                    "description": "Configuration value to set (can be string, number, boolean, object, or array)"
                                }
                            },
                            "required": [
                                "server",
                                "key",
                                "value"
                            ],
                            "additionalProperties": false
                        }
                    }
                },
@Kirow commented on GitHub (Nov 21, 2025): After recent updates (1.0.62 worked few days ago) I start receiving error on any request when Docker MCP Toolkit is enabled. Not sure if it is related to **docker** update or **opencode**. > Invalid schema for function 'MCP_DOCKER_mcp-config-set': In context=('properties', 'value', 'type', '4'), array schema missing items. ``` { "type": "function", "function": { "name": "MCP_DOCKER_mcp-config-set", "description": "Set configuration values for MCP servers. Creates or updates server configuration with the specified key-value pairs. Supports strings, numbers, booleans, objects, and arrays.", "parameters": { "type": "object", "properties": { "key": { "type": "string", "description": "Configuration key to set. This is not to be prefixed by the server name." }, "server": { "type": "string", "description": "Name of the MCP server to configure" }, "value": { "type": [ "string", "number", "boolean", "object", "array" ], "description": "Configuration value to set (can be string, number, boolean, object, or array)" } }, "required": [ "server", "key", "value" ], "additionalProperties": false } } }, ```
Author
Owner

@rekram1-node commented on GitHub (Nov 23, 2025):

Hm im not really sure, probably the docker mcp I don't think we have updated mcp stuff lately

@rekram1-node commented on GitHub (Nov 23, 2025): Hm im not really sure, probably the docker mcp I don't think we have updated mcp stuff lately
Author
Owner

@fiuzagr commented on GitHub (Dec 14, 2025):

Maybe related to https://github.com/docker/mcp-gateway/issues/275

@fiuzagr commented on GitHub (Dec 14, 2025): Maybe related to https://github.com/docker/mcp-gateway/issues/275
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#468