import { type UpsertMCPServerResult } from "./config-writer";
import type { MCPConfigFile, MCPServerConfig } from "./types";
export type MCPConfigScope = "user" | "project";
/** Resolved scope + path + parsed config (provenance for diagnostics). */
export interface ScopeMCPConfigSnapshot {
    scope: MCPConfigScope;
    path: string;
    config: MCPConfigFile;
}
/** Resolve the canonical file path for a native MCP config scope. */
export declare function resolveScopeMCPConfigPath(scope: MCPConfigScope, cwd?: string): string;
/** Read a native MCP config for a scope. Returns an empty config when absent. */
export declare function readScopeMCPConfig(scope: MCPConfigScope, cwd?: string): Promise<ScopeMCPConfigSnapshot>;
/** Add a server, or overwrite an existing one only when `force` is set. */
export declare function upsertScopeMCPServer(scope: MCPConfigScope, name: string, config: MCPServerConfig, options?: {
    force?: boolean;
}, cwd?: string): Promise<ScopeMCPConfigSnapshot & {
    result: UpsertMCPServerResult;
}>;
/** Remove a server from a scope (throws when the name does not exist). */
export declare function removeScopeMCPServer(scope: MCPConfigScope, name: string, cwd?: string): Promise<ScopeMCPConfigSnapshot>;
/** Get a specific server config from a scope. */
export declare function getScopeMCPServer(scope: MCPConfigScope, name: string, cwd?: string): Promise<{
    scope: MCPConfigScope;
    path: string;
    config: MCPServerConfig | undefined;
}>;
/** Read the disabled-servers denylist for a scope. */
export declare function readScopeDisabledServers(scope: MCPConfigScope, cwd?: string): Promise<string[]>;