DSL for defining MCP tools in server handlers.

This module provides a declarative way to define tools with automatic schema generation and validation. It supports both simple and advanced APIs.

Simple API

For common cases, use the simple API with automatic schema generation:

defmodule MyServer do
  use ExMCP.Server.Handler
  use ExMCP.Server.Tools

  tool "echo", "Echo back the input" do
    param :message, :string, required: true

    handle fn %{message: message}, _state ->
      {:ok, text: message}
    end
  end
end

Advanced API

For full control over schemas and metadata:

tool "calculate" do
  description "Perform mathematical calculations"

  input_schema %{
    type: "object",
    properties: %{
      expression: %{type: "string", pattern: "^[0-9+\-*/().\s]+$"}
    }
  }

  annotations %{
    readOnlyHint: true
  }

  handle fn %{expression: expr}, state ->
    result = evaluate_expression(expr)
    {:ok, %{
      content: [{type: "text", text: "Result: #{result}"}],
      structuredContent: %{result: result, expression: expr}
    }, state}
  end
end