Latest MCP Protocol 2025_11_25
This notification can be sent by either side to indicate that it is cancelling a previously-issued request.
The request SHOULD still be in-flight, but due to communication latency, it is always possible that this notification MAY arrive after the request has already finished.
This notification indicates that the result will be unused, so any associated processing SHOULD cease.
A client MUST NOT attempt to cancel its initialize request.
For task cancellation, use the tasks/cancel request instead of this notification.
Latest MCP Protocol 2025_11_25
Capabilities a client may support. Known capabilities are defined here, in this schema, but this is not a closed set: any client can define its own, additional capabilities.
Latest MCP Protocol 2025_11_25
A request from the server to sample an LLM via the client. The client has full discretion over which model to select. The client should also inform the user before beginning sampling, to allow them to inspect the request (human in the loop) and decide whether to approve it.
Latest MCP Protocol 2025_11_25
The client’s response to a sampling/createMessage request from the server.
The client should inform the user before returning the sampled message, to allow them
to inspect the response (human in the loop) and decide whether to allow the server to see it.
Latest MCP Protocol 2025_11_25
An optional notification from the server to the client, informing it of a completion of a out-of-band elicitation request.
Latest MCP Protocol 2025_11_25
The contents of a resource, embedded into a prompt or tool call result.
It is up to the client how best to render embedded resources for the benefit
of the LLM and/or the user.
Latest MCP Protocol 2025_11_25
The response to a tasks/result request.
The structure matches the result type of the original request.
For example, a tools/call task would return the CallToolResult structure.
Latest MCP Protocol 2025_11_25
Sent from the server to request a list of root URIs from the client. Roots allow
servers to ask for specific directories or files to operate on. A common example
for roots is providing a set of repositories or directories a server should operate
on.
This request is typically used when the server needs to understand the file system
structure or access specific locations that the client has permission to read from.
Latest MCP Protocol 2025_11_25
The client’s response to a roots/list request from the server.
This result contains an array of Root objects, each representing a root directory
or file that the server can operate on.
Latest MCP Protocol 2025_11_25
JSONRPCNotification of a log message passed from server to client. If no logging/setLevel request has been sent from the client, the server MAY decide which messages to send automatically.
Latest MCP Protocol 2025_11_25
Hints to use for model selection.
Keys not declared here are currently left unspecified by the spec and are up
to the client to interpret.
Latest MCP Protocol 2025_11_25
The server’s preferences for model selection, requested of the client during sampling.
Because LLMs can vary along multiple dimensions, choosing the “best” model is
rarely straightforward. Different models excel in different areas—some are
faster but less capable, others are more capable but more expensive, and so
on. This interface allows servers to express their priorities across multiple
dimensions to help clients make an appropriate selection for their use case.
These preferences are always advisory. The client MAY ignore them. It is also
up to the client to decide how to interpret these preferences and how to
balance them against other considerations.
Latest MCP Protocol 2025_11_25
A ping, issued by either the server or the client, to check that the other party is still alive. The receiver must promptly respond, or else may be disconnected.
Latest MCP Protocol 2025_11_25
An optional notification from the server to the client, informing it that the list of prompts it offers has changed. This may be issued by servers without any previous subscription from the client.
Latest MCP Protocol 2025_11_25
Describes a message returned as part of a prompt.
This is similar to SamplingMessage, but also supports the embedding of
resources from the MCP server.
Latest MCP Protocol 2025_11_25
Metadata for associating messages with a task.
Include this in the _meta field under the key io.modelcontextprotocol/related-task.
Latest MCP Protocol 2025_11_25
A resource that the server is capable of reading, included in a prompt or tool call result.
Note: resource links returned by tools are not guaranteed to appear in the results of resources/list requests.
Latest MCP Protocol 2025_11_25
An optional notification from the server to the client, informing it that the list of resources it can read from has changed. This may be issued by servers without any previous subscription from the client.
Latest MCP Protocol 2025_11_25
A notification from the server to the client, informing it that a resource has changed and may need to be read again. This should only be sent if the client previously sent a resources/subscribe request.
Latest MCP Protocol 2025_11_25
A notification from the client to the server, informing it that the list of roots has changed.
This notification should be sent whenever the client adds, removes, or modifies any root.
The server should then request an updated list of roots using the ListRootsRequest.
Latest MCP Protocol 2025_11_25
Capabilities that a server may support. Known capabilities are defined here, in this schema, but this is not a closed set: any server can define its own, additional capabilities.
Latest MCP Protocol 2025_11_25
An optional notification from the receiver to the requestor, informing them that a task’s status has changed. Receivers are not required to send these notifications.
Latest MCP Protocol 2025_11_25
Additional properties describing a Tool to clients.
NOTE: all properties in ToolAnnotations are hints.
They are not guaranteed to provide a faithful description of
tool behavior (including descriptive properties like title).
Clients should never make tool use decisions based on ToolAnnotations
received from untrusted servers.
Latest MCP Protocol 2025_11_25
An optional notification from the server to the client, informing it that the list of tools it offers has changed. This may be issued by servers without any previous subscription from the client.
Latest MCP Protocol 2025_11_25
An optional JSON Schema object defining the structure of the tool’s output returned in
the structuredContent field of a CallToolResult.
Defaults to JSON Schema 2020-12 when no explicit $schema is provided.
Currently restricted to type: “object” at the root level.
Latest MCP Protocol 2025_11_25
Sent from the client to request cancellation of resources/updated notifications from the server. This should follow a previous resources/subscribe request.
Latest MCP Protocol 2025_11_25
An error response that indicates that the server requires the client to provide additional information via an elicitation request.
Latest MCP Protocol 2025_11_25
Optional specifier for the theme this icon is designed for. light indicates
the icon is designed to be used with a light background, and dark indicates
the icon is designed to be used with a dark background.
If not provided, the client should assume the icon can be used with any theme.
Latest MCP Protocol 2025_11_25
A request to include context from one or more MCP servers (including the caller), to be attached to the prompt.
The client MAY ignore this request.
Default is “none”. Values “thisServer” and “allServers” are soft-deprecated. Servers SHOULD only use these values if the client
declares ClientCapabilities.sampling.context. These values may be removed in future spec releases.
Latest MCP Protocol 2025_11_25
Indicates whether this tool supports task-augmented execution.
This allows clients to handle long-running operations through polling
the task system.
Latest MCP Protocol 2025_11_25
Deprecating the old auto-generated verbose names.
These were renamed to clearer, shorter names in v0.8.0.
The old names are deprecated but kept for backward-compatibility for a smooth migration period.