Default elicitation handler for MCP clients.

When a server sends an elicitation/create request, it's asking the client to collect user input (text, numbers, selections, etc.) based on a JSON Schema. This module provides the handler interface and a configurable default.

Usage

Implement ExMCP.Client.Handler.handle_elicitation_create/3 in your handler:

defmodule MyApp.MCPHandler do
  use ExMCP.Client.Handler

  @impl true
  def handle_elicitation_create(message, requested_schema, state) do
    # Present the elicitation to your UI
    case MyApp.UI.prompt_user(message, requested_schema) do
      {:ok, user_data} ->
        {:ok, %{"action" => "accept", "content" => user_data}, state}
      :cancelled ->
        {:ok, %{"action" => "cancel"}, state}
      :declined ->
        {:ok, %{"action" => "decline"}, state}
    end
  end
end

Actions

The response action field must be one of:

• "accept" — user provided data (include content with the values)
• "decline" — user chose not to provide data
• "cancel" — user cancelled the operation

Schema Defaults

When auto-accept is enabled (:elicitation_auto_accept config), the handler populates default values from the schema:

config :ex_mcp, elicitation_auto_accept: true

This is intended for automated testing only. In production, always present elicitations to the user.