Skip to content

Improve JSON Schema explanation and add reference link in "Tool definition structure" section #508

@rayshen92

Description

@rayshen92

Improve JSON Schema explanation and add reference link in "Tool definition structure" section

Description

In the official MCP documentation, under the section "Tool definition structure", the field inputSchema is described as:

inputSchema: {
  type: "object",
  properties: { ... } // Tool-specific parameters
}

However, the current description lacks clarity that this is expected to conform to the JSON Schema specification. This may lead to confusion for developers unfamiliar with the protocol.

Suggestion

Example update (suggested inline comment)

inputSchema: {
  type: "object",
  properties: { ... } // Tool-specific parameters (must conform to JSON Schema: https://json-schema.org/)
}

This improvement would make the documentation more developer-friendly and self-explanatory.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions