import { type Server } from 'node:http';
import { WilliMakoClient } from '../index.js';
export interface McpServerOptions {
    /** Optional pre-configured Willi-Mako client (useful for testing). */
    client?: WilliMakoClient;
    /** Port for the MCP HTTP transport. Defaults to PORT env var or 7337. */
    port?: number;
    /** Override base URL when instantiating a new client. */
    baseUrl?: string;
    /** Override token when instantiating a new client. */
    token?: string | null;
    /** Optional logger for structured status updates. */
    logger?: (message: string) => void;
}
export interface McpServerInstance {
    /** Bound port. */
    port: number;
    /** HTTP server backing the MCP transport. */
    server: Server;
    /** Convenience URL to access the MCP endpoint. */
    url: string;
    /** Gracefully shuts the server down. */
    stop(): Promise<void>;
}
export declare function startMcpServer(options?: McpServerOptions): Promise<McpServerInstance>;