client
library
Extension Types
-
Annotated
-
Base type for objects that include optional annotations for the client.
-
Annotations
-
The annotations for an Annotated object.
-
AudioContent
-
Audio provided to or from an LLM.
-
BaseMetadata
-
Basic metadata required by multiple types.
-
BlobResourceContents
-
A ResourceContents that contains binary data encoded as base64.
-
BooleanSchema
-
A JSON Schema definition for a bool.
-
CacheableResult
-
A "mixin"-like extension type for any result type that contains caching
hints at the keys "ttlMs" and "cacheScope".
-
CallToolRequest
-
Used by the client to invoke a tool provided by the server.
-
CallToolResponse
-
A response to a
tools/call request, which is either a CallToolResult
or an InputRequiredResult.
-
CallToolResult
-
The server's completed response to a tool call.
-
CancelledNotification
-
This notification can be sent by either side to indicate that it is
cancelling a previously-issued request.
-
ClientCapabilities
-
Capabilities a client may support.
-
CompleteRequest
-
A request from the client to the server, to ask for completion options.
-
CompleteResult
-
The server's response to a completion/complete request
-
Completion
-
An individual completion from a CompleteResult.
-
CompletionArgument
-
An argument passed to a CompleteRequest.
-
CompletionContext
-
A context passed to a CompleteRequest.
-
Completions
-
Completions parameter for ServerCapabilities.
-
ConstSchema
-
A JSON Schema definition for a constant value.
-
Content
-
Could be either TextContent, ImageContent, AudioContent,
EmbeddedResource or ResourceLink.
-
CreateMessageRequest
-
A request from the server to sample an LLM via the client.
-
CreateMessageResult
-
The client's response to a sampling/create_message request from the
server.
-
Cursor
-
An opaque token used to represent a cursor for pagination.
-
DiscoverRequest
-
A request from the client asking the server to advertise its supported
protocol versions, capabilities, and other metadata.
-
DiscoverResult
-
The server's response to a DiscoverRequest from the client.
-
Elicitation
-
Elicitation parameter for ServerCapabilities.
-
ElicitationCapability
-
Whether the client supports elicitation.
-
ElicitationCompleteNotification
-
A notification from the server to the client that a URL elicitation has
completed.
-
ElicitRequest
-
The parameters for an
elicitation/create request.
-
ElicitResult
-
The client's response to an
elicitation/create request.
-
EmbeddedResource
-
The contents of a resource, embedded into a prompt or tool call result.
-
EmptyResult
-
A response that indicates success but carries no data.
-
EnumSchema
-
Union type for all enum schemas.
-
EnumValueWithTitle
-
A const value for an enum schema with an attached title.
-
GetPromptRequest
-
Used by the client to get a prompt provided by the server.
-
GetPromptResponse
-
A response to a
prompts/get request, which is either a GetPromptResult
or an InputRequiredResult.
-
GetPromptResult
-
The server's completed response to a prompts/get request from the client.
-
Icon
-
An optionally-sized icon that can be displayed in a user interface.
-
ImageContent
-
An image provided to or from an LLM.
-
Implementation
-
Describes the name and version of an MCP implementation.
-
InitializedNotification
-
This notification is sent from the client to the server after initialization
has finished.
-
InitializeRequest
-
This request is sent from the client to the server when it first connects,
asking it to begin initialization.
-
InitializeResult
-
After receiving an initialize request from the client, the server sends
this response.
-
InputRequest
-
A request an InputRequiredResult carries, written the way the schema
writes it: the method name next to the request it applies to.
-
InputRequiredResult
-
Sent by a server in place of the result a request asked for, when it needs
something from the client first.
-
IntegerSchema
-
A JSON Schema definition for an int.
-
ListPromptsRequest
-
Sent from the client to request a list of prompts and prompt templates the
server has.
-
ListPromptsResult
-
The server's response to a prompts/list request from the client.
-
ListResourcesRequest
-
Sent from the client to request a list of resources the server has.
-
ListResourcesResult
-
The server's response to a resources/list request from the client.
-
ListResourceTemplatesRequest
-
Sent from the client to request a list of resource templates the server
has.
-
ListResourceTemplatesResult
-
The server's response to a resources/templates/list request from the client.
-
ListRootsRequest
-
Sent from the server to request a list of root URIs from the client.
-
ListRootsResult
-
The client's response to a roots/list request from the server.
-
ListSchema
-
A JSON Schema definition for a List.
-
ListToolsRequest
-
Sent from the client to request a list of tools the server has.
-
ListToolsResult
-
The server's response to a tools/list request from the client.
-
Logging
-
Extension type for the
logging capability.
-
LoggingMessageNotification
-
Notification of a log message passed from server to client.
-
Meta
-
Generic metadata passed with most requests.
-
MetaWithProgressToken
-
A Meta object with a known progress token key.
-
MetaWithRequestEnvelope
-
A Meta object carrying the envelope keys a request on the 2026-07-28
revision sends.
-
MetaWithSubscriptionId
-
A Meta object carrying the subscriptionId every message on a
subscriptions/listen stream needs.
-
ModelHint
-
Hints to use for model selection.
-
ModelPreferences
-
The server's preferences for model selection, requested of the client
during sampling.
-
MultiSelectEnumSchema
-
Common properties for multi-select enum schemas.
-
Notification
-
Base interface for all notifications.
-
NullSchema
-
A JSON Schema definition for
null.
-
NumberSchema
-
A JSON Schema definition for a num.
-
ObjectSchema
-
A JSON Schema definition for an object with properties.
-
PaginatedRequest
-
A "mixin"-like extension type for any request that contains a Cursor at
the key "cursor".
-
PaginatedResult
-
A "mixin"-like extension type for any result type that contains a Cursor
at the key "cursor".
-
PingRequest
-
A ping, issued by either the server or the client, to check that the other
party is still alive.
-
ProgressNotification
-
An out-of-band notification used to inform the receiver of a progress
update for a long-running request.
-
ProgressToken
-
A progress token, used to associate progress notifications with the original
request.
-
Prompt
-
A prompt or prompt template that the server offers.
-
PromptArgument
-
Describes an argument that a prompt can accept.
-
PromptListChangedNotification
-
An optional notification from the server to the client, informing it that
the list of prompts it offers has changed.
-
PromptMessage
-
Describes a message returned as part of a prompt.
-
PromptReference
-
Identifies a prompt.
-
Prompts
-
Prompts parameter for ServerCapabilities.
-
ReadResourceRequest
-
Sent from the client to the server, to read a specific resource URI.
-
ReadResourceResponse
-
A response to a
resources/read request, which is either a
ReadResourceResult or an InputRequiredResult.
-
ReadResourceResult
-
The server's completed response to a resources/read request from the client.
-
Reference
-
Union type for references, see PromptReference and
ResourceTemplateReference.
-
Request
-
Base interface for all request types.
-
RequestId
-
An opaque request ID.
-
Resource
-
A known resource that the server is capable of reading.
-
ResourceContents
-
Base class for the contents of a specific resource or sub-resource.
-
ResourceLink
-
A resource link returned from a tool.
-
ResourceListChangedNotification
-
An optional notification from the server to the client, informing it that
the list of resources it can read from has changed.
-
Resources
-
Resources parameter for ServerCapabilities.
-
ResourceTemplate
-
A template description for resources available on the server.
-
ResourceTemplateReference
-
A reference to a resource or resource template definition.
-
ResourceUpdatedNotification
-
A notification from the server to the client, informing it that a resource
has changed and may need to be read again.
-
Result
-
Base interface for all responses to requests.
-
Root
-
Represents a root directory or file that the server can operate on.
-
RootsCapabilities
-
Whether the client supports notifications for changes to the roots list.
-
RootsListChangedNotification
-
A notification from the client to the server, informing it that the list
of roots has changed.
-
SamplingMessage
-
Describes a message issued to or received from an LLM API.
-
SamplingMessageContentBlock
-
One block of a SamplingMessage's content, sent to or received from an
LLM.
-
Schema
-
A JSON Schema object defining the any kind of property.
-
ServerCapabilities
-
Capabilities that a server may support.
-
SetLevelRequest
-
A request from the client to the server, to enable or adjust logging.
-
SingleSelectEnumSchema
-
Common properties for single-select enum schemas.
-
StringSchema
-
A JSON Schema definition for a String.
-
SubscribeRequest
-
Sent from the client to request resources/updated notifications from the
server whenever a particular resource changes.
-
SubscriptionFilter
-
A filter over the notifications a subscription carries.
-
SubscriptionsAcknowledgedNotification
-
Sent by the server to acknowledge a SubscriptionsListenRequest and report
the notification types it agreed to send.
-
SubscriptionsListenRequest
-
Sent from the client to open a long-lived stream for the notifications
which do not belong to a specific request.
-
SubscriptionsListenResult
-
The response to a SubscriptionsListenRequest, sent when the server ends
the subscription gracefully, for example while shutting down.
-
TextContent
-
Text provided to or from an LLM.
-
TextResourceContents
-
A ResourceContents that contains text.
-
TitledMultiSelectEnumSchema
-
Schema for multiple-selection enumeration with display titles.
-
TitledSingleSelectEnumSchema
-
Schema for single-selection enumeration with display titles for each option.
-
Tool
-
Definition for a tool the client can call.
-
ToolAnnotations
-
Additional properties describing a Tool to clients.
-
ToolChoice
-
Controls tool selection behavior for sampling requests.
-
ToolListChangedNotification
-
An optional notification from the server to the client, informing it that
the list of tools it offers has changed.
-
ToolResultContent
-
The result of a tool use, provided by the user back to the assistant.
-
Tools
-
Tools parameter for ServerCapabilities.
-
ToolUseContent
-
A request from the assistant to call a tool.
-
UnsubscribeRequest
-
Sent from the client to request cancellation of resources/updated
notifications from the server.
-
UntitledMultiSelectEnumSchema
-
Schema for multiple-selection enumeration without display titles.
-
UntitledSingleSelectEnumSchema
-
Schema for single-selection enumeration without display titles for options.
-
ValidationError
-
A validation error with detailed information about the location of the
error.
-
WithInputResponses
-
A "mixin"-like extension type for any request that contains input responses
at the keys "inputResponses" and "requestState".
-
WithMetadata
-
Base interface for all types that can have arbitrary metadata attached.
-
WithProgressToken
-
A "mixin"-like extension type for any extension type that might contain a
ProgressToken at the key "progressToken".
-
WithSubscriptionId
-
A "mixin"-like extension type for any message on a
subscriptions/listen
stream that carries a MetaWithSubscriptionId at the key "_meta".