@McpServer(
    name = "my-server",
    icons = {
        "data:image/svg+xml;base64,...:image/svg+xml:64x64:light",
        "data:image/svg+xml;base64,...:image/svg+xml:64x64:dark"
    }
)
@McpTool(
    description = "My tool",
    icons = {"https://example.com/icon.png"}
)
public class MyServer { }

@McpResource(uri = "config://settings")
public String getSettings() {
    return "{\"theme\": \"dark\"}";
}

@McpPrompt(name = "code-review")
public String codeReviewPrompt(@McpParam(description = "Code to review") String code) {
    return "Review this code:\n" + code;
}

@McpTool(description = "Create task")
public String createTask(
    @McpParam(
        description = "Task name",
        examples = {"backup", "sync"},
        constraints = "Cannot be empty",
        defaultValue = "default",
        required = false
    ) String taskName
) { return "Created: " + taskName; }

@McpServer(name = "MyServer", version = "1.0")
public class MyServer {

    @McpTool(description = "Calculate")
    public int calculate(int x, int y) {
        return x + y;
    }

    // Run before ALL tools (*)
    @McpPreHook(toolName = "*", order = 1)
    void authenticate(Map<String, Object> args) {
        String token = (String) args.get("token");
        if (!isValid(token)) throw new SecurityException("Unauthorized");
    }

    // Run after specific tool only
    @McpPostHook(toolName = "calculate", order = 1)
    void logResult(Map<String, Object> args, Object result) {
        System.out.println("Result: " + result);
    }

    public static void main(String[] args) {
        FastMCP.server(MyServer.class).stdio().run();
    }
}

@McpServer(name = "MyServer", version = "1.0")
public class MyServer {

    @McpTool(description = "Get client info")
    public String getClientInfo(@McpContext Context context) {
        return "Client: " + context.getClientId();
    }

    @McpTool(description = "Get session ID")
    public String getSessionId(@McpContext Context context) {
        return "Session: " + context.getSessionId();
    }

    @McpTool(description = "Read file with context")
    public String readFile(@McpContext Context context, String path) {
        context.info("Reading file: " + path);

        // Access request headers (e.g., for auth)
        Map<String, String> headers = context.getRequestHeaders();
        String authHeader = headers.get("Authorization");

        // ... read file
        return "Content";
    }

    public static void main(String[] args) {
        FastMCP.server(MyServer.class).stdio().run();
    }
}

@McpServer(name = "MyServer", version = "1.0")
@McpBash(
    timeout = 30,                          // Command timeout in seconds
    visibleAfterBasePath = "/sandbox/*",   // Whitelist allowed directories
    notAllowedPaths = {"/etc", "/root"}    // Blacklist dangerous paths
)
public class MyServer { }

@McpServer(name = "MyServer", version = "1.0")
@McpTelemetry(
    enabled = true,
    exportConsole = true,              // Human-readable output
    exportOtlp = false,                // OpenTelemetry export
    sampleRate = 1.0,                  // 100% sampling
    includeArguments = false,          // Don't log sensitive args
    metricExportIntervalMs = 60_000
)
public class MyServer { }

@McpServer(
    name = "MyServer",
    version = "1.0",
    modules = {StringTools.class, MathTools.class}
)

@McpServer(
    name = "MyServer",
    version = "1.0",
    scanBasePackage = "com.example.tools"
)

<dependency>
    <groupId>io.github.terseprompts.fastmcp</groupId>
    <artifactId>fastmcp-java</artifactId>
    <version>0.3.1-beta</version>
</dependency>

dependencies {
    implementation 'io.github.terseprompts.fastmcp:fastmcp-java:0.3.1-beta'
}

@McpServer(name = "Assistant", version = "1.0")
public class MyAssistant {

    @McpTool(description = "Summarize text")
    public String summarize(@McpParam(description = "Text") String text) {
        return "Summary: " + text.substring(0, Math.min(100, text.length()));
    }

    public static void main(String[] args) {
        FastMCP.server(MyAssistant.class)
            .stdio()           // or .sse() or .streamable()
            .run();
    }
}

mvn exec:java -Dexec.mainClass="com.example.MyAssistant"

@McpTool(description = "Add two numbers")
public int add(int a, int b) {
    return a + b;
}

@McpTool(description = "Process data")
@McpAsync  // ← just add this
public Mono<String> process(@McpContext Context ctx, String input) {
    return Mono.fromCallable(() -> {
        ctx.reportProgress(50, "Processing...");
        return slowOperation(input);
    });
}

@McpServer(name = "MyServer", version = "1.0")
@McpMemory  // ← just add this
public class MyServer {
    // AI now remembers things across sessions
}

@McpServer(name = "MyServer", version = "1.0")
@McpMemory     // AI remembers
@McpTodo       // AI manages tasks
@McpPlanner    // AI breaks tasks into steps
@McpFileRead   // AI reads your files
@McpFileWrite  // AI writes files
public class MyServer {
    // All tools enabled, zero implementation needed
}

@McpServer(
    name = "MyServer",
    version = "1.0",
    modules = {StringTools.class, MathTools.class}  // Explicit modules
)
public class MyServer {
    // Tools from StringTools and MathTools are included
}

@McpServer(
    name = "MyServer",
    version = "1.0",
    scanBasePackage = "com.example.tools"  // Auto-discover all tools
)
public class MyServer {
    // All @McpTool classes in the package are included
}

@McpServer(name = "MyServer", version = "1.0")
@McpBash(timeout = 30)  // Shell command execution with security guardrails
public class MyServer {
    // Provides 'execute_command' tool with OS-aware shell selection
}

@McpServer(name = "MyServer", version = "1.0")
@McpTelemetry(enabled = true, exportConsole = true)  // Metrics & tracing
public class MyServer {
    // Automatic tool invocation tracking with console export
}

FastMCP.server(MyServer.class)
    .stdio()       // For CLI tools, local agents
    .sse()         // For web clients, long-lived connections
    .streamable()  // For bidirectional streaming (recommended)
    .run();

FastMCP.server(MyServer.class)
    .port(3000)                              // HTTP port
    .requestTimeout(Duration.ofMinutes(5))   // Request timeout
    .keepAliveSeconds(30)                     // Keep-alive interval
    .capabilities(c -> c
        .tools(true)
        .resources(true, true)
        .prompts(true))
    .run();