import type { ActionRunContext } from "../action.js";
export interface AppMcpTool {
    serverId: string;
    name: string;
    title?: string;
    description: string;
    inputSchema: Record<string, unknown>;
    outputSchema?: Record<string, unknown>;
    annotations?: Record<string, unknown>;
    _meta?: Record<string, unknown>;
}
export interface ListVisibleMcpToolsOptions {
    serverId?: string;
    /**
     * Keep only tools served from this provider's MCP endpoint, matched on the
     * server URL. A server id is a name the user chose, so it cannot prove which
     * provider answers the call.
     */
    providerId?: string;
}
export interface CallMcpToolOptions {
    /** Refuse the call unless the server's URL belongs to this provider. */
    providerId?: string;
    /** Caller identity and invocation source forwarded to MCP authorization. */
    context?: ActionRunContext;
}
export declare class McpAppApiError extends Error {
    readonly statusCode: 401 | 403 | 503;
    constructor(message: string, statusCode: 401 | 403 | 503);
}
export declare function listVisibleMcpTools(options?: ListVisibleMcpToolsOptions): Promise<AppMcpTool[]>;
export declare function callMcpTool(serverId: string, originalToolName: string, args?: Record<string, unknown>, options?: CallMcpToolOptions): Promise<unknown>;