mcp-toolkit.server — fi.metosin/mcp-toolkit 0.1.0-alpha

add-prompt clj/s

(add-prompt context prompt)

Adds a prompt to the server's prompt registry and notifies the client.

Args: context - The server session context prompt - Prompt map with :name key and other prompt configuration

Returns: nil

add-resource clj/s

(add-resource context resource)

Adds a resource to the server's resource registry and notifies the client.

Args: context - The server session context resource - Resource map with :uri key and other resource configuration

Returns: nil

add-tool clj/s

(add-tool context tool)

Adds a tool to the server's tool registry and notifies the client.

Args: context - The server session context tool - Tool map with :name key and other tool configuration

Returns: nil

create-session clj/s

(create-session {:keys [server-info server-instructions prompts resources tools
                        resource-templates resource-uri-complete-fn
                        logging-level on-initialized on-client-root-list-changed
                        on-client-root-list-updated]
                 :or {server-info {:name "mcp-toolkit" :version "0.1.0-alpha"}
                      logging-level "info"
                      on-initialized request-root-list
                      on-client-root-list-changed request-root-list}})

Returns the state of a newly created session.

notify-log clj/s

(notify-log context level logger data)

Sends a log message to the client if it meets the current logging level threshold. (see https://modelcontextprotocol.io/specification/2025-06-18/server/utilities/logging#log-message-notifications)

Args: context - The server session context level - Logging level, accepted values are "debug", "info", "notice", "warning", "error", "critical", "alert" and "emergency" logger - Logger name/identifier string data - Log message data (typically a string)

Returns: nil

notify-progress clj/s

(notify-progress context progress)

Notifies the client about progress during tool or prompt execution. Only sends if the current message contains a progress token. (see https://modelcontextprotocol.io/specification/2025-06-18/basic/utilities/progress#progress-flow)

Args: context - The server session context progress - Map with progress information (e.g., {:progress 50 :total 100})

Returns: nil

notify-prompt-list-changed clj/s

(notify-prompt-list-changed context)

Notifies the client that the server's prompt list has changed. (see https://modelcontextprotocol.io/specification/2025-06-18/server/prompts#list-changed-notification)

Args: context - The server session context

Returns: nil

notify-resource-list-changed clj/s

(notify-resource-list-changed context)

Notifies the client that the server's resource list has changed. (see https://modelcontextprotocol.io/specification/2025-06-18/server/resources#list-changed-notification)

Args: context - The server session context

Returns: nil

notify-resource-updated clj/s

(notify-resource-updated context resource)

Notifies subscribed clients about a specific resource update. Only sends notification if the client is subscribed to the resource URI. (see https://modelcontextprotocol.io/specification/2025-06-18/server/resources#subscriptions)

Args: context - The server session context resource - Resource map with :uri key

Returns: nil

notify-tool-list-changed clj/s

(notify-tool-list-changed context)

Notifies the client that the server's tool list has changed. (see https://modelcontextprotocol.io/specification/2025-06-18/server/tools#list-changed-notification)

Args: context - The server session context

Returns: nil

remove-prompt clj/s

(remove-prompt context prompt)

Removes a prompt from the server's prompt registry and notifies the client.

Args: context - The server session context prompt - Prompt map with :name key to identify which prompt to remove

Returns: nil

remove-resource clj/s

(remove-resource context resource)

Removes a resource from the server's resource registry and notifies the client.

Args: context - The server session context resource - Resource map with :uri key to identify which resource to remove

Returns: nil

remove-tool clj/s

(remove-tool context tool)

Removes a tool from the server's tool registry and notifies the client.

Args: context - The server session context tool - Tool map with :name key to identify which tool to remove

Returns: nil

request-root-list clj/s

(request-root-list context)

Requests the list of root directories from the MCP client. Updates the session's client-root-by-uri index and calls the on-client-root-list-updated callback. (see https://modelcontextprotocol.io/specification/2025-06-18/client/roots#listing-roots)

Args: context - The server session context

Returns: A promise that resolves when roots are fetched and stored.

request-sampling clj/s

(request-sampling context params)

Requests message sampling from the MCP client. Returns a promise, either resolved with the result or rejected with the error. (see https://modelcontextprotocol.io/specification/2025-06-18/client/sampling#creating-messages)

Args: context - The server session context params - Sampling parameters map

Returns: A promise that resolves to the sampling result from the client.

set-resource-templates clj/s

(set-resource-templates context resource-templates)

Sets the resource templates for the server session.

Args: context - The server session context resource-templates - Vector of resource template maps

Returns: nil

set-resource-uri-complete-fn clj/s

(set-resource-uri-complete-fn context resource-uri-complete-fn)

Sets the resource URI completion function for the server session.

Args: context - The server session context resource-uri-complete-fn - Function to handle resource URI completion requests

Returns: nil