Skip to content

[Bug]: Server instruction not present in JSON schema. #3282

@JerryNixon

Description

@JerryNixon

What?

The server description is defined in code:

/// <summary>
/// Description of the MCP server to be exposed in the initialize response
/// </summary>
[JsonPropertyName("description")]
public string? Description { get; init; }

But the server description is not defined in the JSON Schema:

"mcp": {
"type": "object",
"description": "Global MCP endpoint configuration",
"additionalProperties": false,
"properties": {
"path": {
"default": "/mcp",
"type": "string",
"description": "URL prefix path for MCP endpoints."
},
"enabled": {
"$ref": "#/$defs/boolean-or-string",
"description": "Allow enabling/disabling MCP requests for all entities.",
"default": true
},
"dml-tools": {
"description": "Configuration for MCP Data Manipulation Language (DML) tools. Set to true/false to enable/disable all tools, or use an object to configure individual tools.",
"oneOf": [
{
"$ref": "#/$defs/boolean-or-string",
"description": "Enable/disable all DML tools with default settings."
},
{
"type": "object",
"description": "Individual DML tools configuration",
"additionalProperties": false,
"properties": {
"describe-entities": {
"$ref": "#/$defs/boolean-or-string",
"description": "Enable/disable the describe-entities tool.",
"default": false
},
"create-record": {
"$ref": "#/$defs/boolean-or-string",
"description": "Enable/disable the create-record tool.",
"default": false
},
"read-records": {
"$ref": "#/$defs/boolean-or-string",
"description": "Enable/disable the read-records tool.",
"default": false
},
"update-record": {
"$ref": "#/$defs/boolean-or-string",
"description": "Enable/disable the update-record tool.",
"default": false
},
"delete-record": {
"$ref": "#/$defs/boolean-or-string",
"description": "Enable/disable the delete-record tool.",
"default": false
},
"execute-entity": {
"$ref": "#/$defs/boolean-or-string",
"description": "Enable/disable the execute-entity tool.",
"default": false
},
"aggregate-records": {
"description": "Enable/disable or configure the aggregate-records MCP tool.",
"oneOf": [
{
"$ref": "#/$defs/boolean-or-string",
"description": "Enable/disable the aggregate-records tool."
},
{
"type": "object",
"description": "Aggregate records tool configuration",
"additionalProperties": false,
"properties": {
"enabled": {
"$ref": "#/$defs/boolean-or-string",
"description": "Enable/disable the aggregate-records tool.",
"default": true
},
"query-timeout": {
"type": "integer",
"description": "Execution timeout in seconds for aggregate queries. Range: 1-600.",
"default": 30,
"minimum": 1,
"maximum": 600
}
}
}
],
"default": false
}
}
}
]
}
}

Fix

This is what is missing

"description": {
  "type": "string",
  "description": "Description of the MCP server, exposed as the 'instructions' field in the MCP initialize response to provide behavioral context to MCP clients and agents."
}

Metadata

Metadata

Assignees

Type

Projects

Status

Todo

Relationships

None yet

Development

No branches or pull requests

Issue actions