@kya-os/contracts 1.6.19 → 1.7.0

package/dist/well-known/index.d.ts

@@ -71,14 +71,193 @@ export interface MCPIdentity {
     /** Optional additional metadata */
     metadata?: Record<string, unknown>;
 }
+/**
+ * MCP Server Card (SEP-1649)
+ * Returned from /.well-known/mcp.json
+ *
+ * This enables MCP clients to automatically discover server capabilities,
+ * available transports, authentication requirements, and protocol versions
+ * before establishing a connection.
+ *
+ * @see https://github.com/modelcontextprotocol/modelcontextprotocol/issues/1649
+ */
+export interface MCPServerCard {
+    /** URL to the JSON schema definition */
+    $schema?: string;
+    /** Schema version for the server card document (e.g., "1.0") */
+    version: string;
+    /** The MCP protocol version the server supports (e.g., "2025-06-18") */
+    protocolVersion: string;
+    /** Server identification */
+    serverInfo: {
+        /** Server identifier for programmatic use */
+        name: string;
+        /** Human-readable server display name */
+        title?: string;
+        /** Server software version */
+        version: string;
+    };
+    /** Human-readable description of the server */
+    description?: string;
+    /** URL to an icon representing the server */
+    iconUrl?: string;
+    /** URL to the server's documentation */
+    documentationUrl?: string;
+    /** Transport configuration */
+    transport: {
+        /** Transport type (streamable-http, sse, stdio) */
+        type: 'streamable-http' | 'sse' | 'stdio';
+        /** Transport endpoint path (e.g., "/mcp") */
+        endpoint: string;
+    };
+    /** Server capabilities */
+    capabilities?: {
+        tools?: {
+            listChanged?: boolean;
+        };
+        prompts?: {
+            listChanged?: boolean;
+        };
+        resources?: {
+            subscribe?: boolean;
+            listChanged?: boolean;
+        };
+        logging?: Record<string, unknown>;
+        completions?: Record<string, unknown>;
+        experimental?: Record<string, unknown>;
+    };
+    /** Required client capabilities */
+    requires?: {
+        sampling?: Record<string, unknown>;
+        roots?: Record<string, unknown>;
+        elicitation?: Record<string, unknown>;
+        experimental?: Record<string, unknown>;
+    };
+    /** Authentication requirements */
+    authentication?: {
+        /** Whether authentication is mandatory */
+        required: boolean;
+        /** Supported authentication schemes */
+        schemes: Array<'bearer' | 'oauth2' | 'basic' | string>;
+    };
+    /** Usage instructions for the server */
+    instructions?: string;
+    /** Resource definitions - "dynamic" or array of resources */
+    resources?: 'dynamic' | Array<{
+        name: string;
+        title?: string;
+        uri: string;
+        description?: string;
+        mimeType?: string;
+    }>;
+    /** Tool definitions - "dynamic" or array of tools */
+    tools?: 'dynamic' | Array<{
+        name: string;
+        title?: string;
+        description?: string;
+        inputSchema?: Record<string, unknown>;
+    }>;
+    /** Prompt definitions - "dynamic" or array of prompts */
+    prompts?: 'dynamic' | Array<{
+        name: string;
+        title?: string;
+        description?: string;
+        arguments?: Array<{
+            name: string;
+            description?: string;
+            required?: boolean;
+        }>;
+    }>;
+    /** Additional metadata */
+    _meta?: Record<string, unknown>;
+}
+/**
+ * MCP Server Configuration (Legacy/Simplified format)
+ * @deprecated Use MCPServerCard for SEP-1649 compliance
+ */
+export interface MCPServerConfig {
+    /** Server name for display in client UI */
+    name: string;
+    /** Server description */
+    description?: string;
+    /** MCP protocol endpoint URL (typically /mcp) */
+    url: string;
+    /** Transport type - "sse" for Server-Sent Events (Streamable HTTP) */
+    transport: 'sse' | 'stdio' | 'http';
+    /** MCP-I protocol version */
+    version?: string;
+    /** Agent's DID for identity verification */
+    agentDid?: string;
+    /** Supported capabilities */
+    capabilities?: string[];
+    /** Whether this server requires authentication */
+    requiresAuth?: boolean;
+    /** OAuth provider for authentication (if requiresAuth is true) */
+    authProvider?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Client Configuration for Cursor/Claude Desktop
+ * Returned from /.well-known/mcp-client-config.json
+ *
+ * Returns ready-to-use configuration that can be copy-pasted into
+ * client configuration files.
+ */
+export interface MCPClientConfig {
+    /** Configuration for Claude Desktop (claude_desktop_config.json) */
+    claudeDesktop: {
+        mcpServers: Record<string, {
+            url: string;
+            transport?: 'sse';
+        }>;
+    };
+    /** Configuration for Cursor (.cursor/mcp.json) */
+    cursor: {
+        mcpServers: Record<string, {
+            url: string;
+            transport?: 'sse';
+        }>;
+    };
+    /** Deep link for one-click Cursor installation */
+    cursorDeepLink?: string;
+    /** Additional metadata (server info, agent DID, etc.) */
+    _meta?: {
+        serverName?: string;
+        serverUrl?: string;
+        mcpEndpoint?: string;
+        agentDid?: string;
+        generatedAt?: number;
+        instructions?: string;
+        [key: string]: unknown;
+    };
+}
 /**
  * Well-known endpoint handler configuration
  */
 export interface WellKnownConfig {
-    /** Service name to advertise */
+    /** Service name to advertise (programmatic identifier) */
     serviceName?: string;
-    /** Service endpoint URL */
+    /** Human-readable display title */
+    serviceTitle?: string;
+    /** Service endpoint URL (base URL, e.g., https://example.com) */
     serviceEndpoint?: string;
+    /** Server description */
+    description?: string;
+    /** Server software version */
+    serverVersion?: string;
+    /** MCP protocol version (e.g., "2025-06-18") */
+    protocolVersion?: string;
+    /** URL to server icon */
+    iconUrl?: string;
+    /** URL to documentation */
+    documentationUrl?: string;
+    /** Whether authentication is required */
+    requiresAuth?: boolean;
+    /** Supported authentication schemes */
+    authSchemes?: Array<'bearer' | 'oauth2' | 'basic' | string>;
+    /** Usage instructions */
+    instructions?: string;
     /** Additional metadata to include */
     metadata?: Record<string, unknown>;
 }
@@ -97,7 +276,13 @@ export declare enum WellKnownPath {
     DID_DOCUMENT = "/.well-known/did.json",
     AGENT_DOCUMENT = "/.well-known/agent.json",
     MCP_IDENTITY = "/.well-known/mcp-identity",
-    TOOL_PROTECTIONS = "/.well-known/tool-protections.json"
+    TOOL_PROTECTIONS = "/.well-known/tool-protections.json",
+    /** SEP-1649 MCP Server Card (current usage by Cursor/Claude Desktop) */
+    MCP_SERVER_CONFIG = "/.well-known/mcp.json",
+    /** SEP-1649 MCP Server Card (proposed spec path) */
+    MCP_SERVER_CARD = "/.well-known/mcp/server-card.json",
+    /** Client configuration helper (Cursor/Claude Desktop ready-to-use config) */
+    MCP_CLIENT_CONFIG = "/.well-known/mcp-client-config.json"
 }
 /**
  * Zod Schemas for Validation
@@ -198,15 +383,15 @@ export declare const AgentDocumentSchema: z.ZodObject<{
         version: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        version?: string | undefined;
         name?: string | undefined;
-        serviceEndpoint?: string | undefined;
+        version?: string | undefined;
         description?: string | undefined;
+        serviceEndpoint?: string | undefined;
     }, {
-        version?: string | undefined;
         name?: string | undefined;
-        serviceEndpoint?: string | undefined;
+        version?: string | undefined;
         description?: string | undefined;
+        serviceEndpoint?: string | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     capabilities: {
@@ -216,10 +401,10 @@ export declare const AgentDocumentSchema: z.ZodObject<{
     };
     id: string;
     metadata?: {
-        version?: string | undefined;
         name?: string | undefined;
-        serviceEndpoint?: string | undefined;
+        version?: string | undefined;
         description?: string | undefined;
+        serviceEndpoint?: string | undefined;
     } | undefined;
 }, {
     capabilities: {
@@ -229,10 +414,10 @@ export declare const AgentDocumentSchema: z.ZodObject<{
     };
     id: string;
     metadata?: {
-        version?: string | undefined;
         name?: string | undefined;
-        serviceEndpoint?: string | undefined;
+        version?: string | undefined;
         description?: string | undefined;
+        serviceEndpoint?: string | undefined;
     } | undefined;
 }>;
 export declare const MCPIdentitySchema: z.ZodObject<{
@@ -257,18 +442,514 @@ export declare const MCPIdentitySchema: z.ZodObject<{
     serviceName: string;
     metadata?: Record<string, unknown> | undefined;
 }>;
+/** SEP-1649 MCP Server Card Schema */
+export declare const MCPServerCardSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    version: z.ZodString;
+    protocolVersion: z.ZodString;
+    serverInfo: z.ZodObject<{
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        version: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        version: string;
+        title?: string | undefined;
+    }, {
+        name: string;
+        version: string;
+        title?: string | undefined;
+    }>;
+    description: z.ZodOptional<z.ZodString>;
+    iconUrl: z.ZodOptional<z.ZodString>;
+    documentationUrl: z.ZodOptional<z.ZodString>;
+    transport: z.ZodObject<{
+        type: z.ZodEnum<["streamable-http", "sse", "stdio"]>;
+        endpoint: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "streamable-http" | "sse" | "stdio";
+        endpoint: string;
+    }, {
+        type: "streamable-http" | "sse" | "stdio";
+        endpoint: string;
+    }>;
+    capabilities: z.ZodOptional<z.ZodObject<{
+        tools: z.ZodOptional<z.ZodObject<{
+            listChanged: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            listChanged?: boolean | undefined;
+        }, {
+            listChanged?: boolean | undefined;
+        }>>;
+        prompts: z.ZodOptional<z.ZodObject<{
+            listChanged: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            listChanged?: boolean | undefined;
+        }, {
+            listChanged?: boolean | undefined;
+        }>>;
+        resources: z.ZodOptional<z.ZodObject<{
+            subscribe: z.ZodOptional<z.ZodBoolean>;
+            listChanged: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            listChanged?: boolean | undefined;
+            subscribe?: boolean | undefined;
+        }, {
+            listChanged?: boolean | undefined;
+            subscribe?: boolean | undefined;
+        }>>;
+        logging: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        completions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        experimental: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        tools?: {
+            listChanged?: boolean | undefined;
+        } | undefined;
+        prompts?: {
+            listChanged?: boolean | undefined;
+        } | undefined;
+        resources?: {
+            listChanged?: boolean | undefined;
+            subscribe?: boolean | undefined;
+        } | undefined;
+        logging?: Record<string, unknown> | undefined;
+        completions?: Record<string, unknown> | undefined;
+        experimental?: Record<string, unknown> | undefined;
+    }, {
+        tools?: {
+            listChanged?: boolean | undefined;
+        } | undefined;
+        prompts?: {
+            listChanged?: boolean | undefined;
+        } | undefined;
+        resources?: {
+            listChanged?: boolean | undefined;
+            subscribe?: boolean | undefined;
+        } | undefined;
+        logging?: Record<string, unknown> | undefined;
+        completions?: Record<string, unknown> | undefined;
+        experimental?: Record<string, unknown> | undefined;
+    }>>;
+    requires: z.ZodOptional<z.ZodObject<{
+        sampling: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        roots: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        elicitation: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        experimental: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        experimental?: Record<string, unknown> | undefined;
+        sampling?: Record<string, unknown> | undefined;
+        roots?: Record<string, unknown> | undefined;
+        elicitation?: Record<string, unknown> | undefined;
+    }, {
+        experimental?: Record<string, unknown> | undefined;
+        sampling?: Record<string, unknown> | undefined;
+        roots?: Record<string, unknown> | undefined;
+        elicitation?: Record<string, unknown> | undefined;
+    }>>;
+    authentication: z.ZodOptional<z.ZodObject<{
+        required: z.ZodBoolean;
+        schemes: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        required: boolean;
+        schemes: string[];
+    }, {
+        required: boolean;
+        schemes: string[];
+    }>>;
+    instructions: z.ZodOptional<z.ZodString>;
+    resources: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"dynamic">, z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        uri: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        uri: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        mimeType?: string | undefined;
+    }, {
+        name: string;
+        uri: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        mimeType?: string | undefined;
+    }>, "many">]>>;
+    tools: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"dynamic">, z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        inputSchema?: Record<string, unknown> | undefined;
+    }, {
+        name: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        inputSchema?: Record<string, unknown> | undefined;
+    }>, "many">]>>;
+    prompts: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"dynamic">, z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        arguments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            required?: boolean | undefined;
+            description?: string | undefined;
+        }, {
+            name: string;
+            required?: boolean | undefined;
+            description?: string | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        arguments?: {
+            name: string;
+            required?: boolean | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+    }, {
+        name: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        arguments?: {
+            name: string;
+            required?: boolean | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+    }>, "many">]>>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    protocolVersion: string;
+    serverInfo: {
+        name: string;
+        version: string;
+        title?: string | undefined;
+    };
+    transport: {
+        type: "streamable-http" | "sse" | "stdio";
+        endpoint: string;
+    };
+    capabilities?: {
+        tools?: {
+            listChanged?: boolean | undefined;
+        } | undefined;
+        prompts?: {
+            listChanged?: boolean | undefined;
+        } | undefined;
+        resources?: {
+            listChanged?: boolean | undefined;
+            subscribe?: boolean | undefined;
+        } | undefined;
+        logging?: Record<string, unknown> | undefined;
+        completions?: Record<string, unknown> | undefined;
+        experimental?: Record<string, unknown> | undefined;
+    } | undefined;
+    $schema?: string | undefined;
+    tools?: "dynamic" | {
+        name: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        inputSchema?: Record<string, unknown> | undefined;
+    }[] | undefined;
+    description?: string | undefined;
+    authentication?: {
+        required: boolean;
+        schemes: string[];
+    } | undefined;
+    instructions?: string | undefined;
+    iconUrl?: string | undefined;
+    documentationUrl?: string | undefined;
+    prompts?: "dynamic" | {
+        name: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        arguments?: {
+            name: string;
+            required?: boolean | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+    }[] | undefined;
+    resources?: "dynamic" | {
+        name: string;
+        uri: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        mimeType?: string | undefined;
+    }[] | undefined;
+    requires?: {
+        experimental?: Record<string, unknown> | undefined;
+        sampling?: Record<string, unknown> | undefined;
+        roots?: Record<string, unknown> | undefined;
+        elicitation?: Record<string, unknown> | undefined;
+    } | undefined;
+    _meta?: Record<string, unknown> | undefined;
+}, {
+    version: string;
+    protocolVersion: string;
+    serverInfo: {
+        name: string;
+        version: string;
+        title?: string | undefined;
+    };
+    transport: {
+        type: "streamable-http" | "sse" | "stdio";
+        endpoint: string;
+    };
+    capabilities?: {
+        tools?: {
+            listChanged?: boolean | undefined;
+        } | undefined;
+        prompts?: {
+            listChanged?: boolean | undefined;
+        } | undefined;
+        resources?: {
+            listChanged?: boolean | undefined;
+            subscribe?: boolean | undefined;
+        } | undefined;
+        logging?: Record<string, unknown> | undefined;
+        completions?: Record<string, unknown> | undefined;
+        experimental?: Record<string, unknown> | undefined;
+    } | undefined;
+    $schema?: string | undefined;
+    tools?: "dynamic" | {
+        name: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        inputSchema?: Record<string, unknown> | undefined;
+    }[] | undefined;
+    description?: string | undefined;
+    authentication?: {
+        required: boolean;
+        schemes: string[];
+    } | undefined;
+    instructions?: string | undefined;
+    iconUrl?: string | undefined;
+    documentationUrl?: string | undefined;
+    prompts?: "dynamic" | {
+        name: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        arguments?: {
+            name: string;
+            required?: boolean | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+    }[] | undefined;
+    resources?: "dynamic" | {
+        name: string;
+        uri: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        mimeType?: string | undefined;
+    }[] | undefined;
+    requires?: {
+        experimental?: Record<string, unknown> | undefined;
+        sampling?: Record<string, unknown> | undefined;
+        roots?: Record<string, unknown> | undefined;
+        elicitation?: Record<string, unknown> | undefined;
+    } | undefined;
+    _meta?: Record<string, unknown> | undefined;
+}>;
+/** Legacy MCP Server Config Schema */
+export declare const MCPServerConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    url: z.ZodString;
+    transport: z.ZodEnum<["sse", "stdio", "http"]>;
+    version: z.ZodOptional<z.ZodString>;
+    agentDid: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    requiresAuth: z.ZodOptional<z.ZodBoolean>;
+    authProvider: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    url: string;
+    transport: "sse" | "stdio" | "http";
+    version?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    capabilities?: string[] | undefined;
+    agentDid?: string | undefined;
+    description?: string | undefined;
+    requiresAuth?: boolean | undefined;
+    authProvider?: string | undefined;
+}, {
+    name: string;
+    url: string;
+    transport: "sse" | "stdio" | "http";
+    version?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    capabilities?: string[] | undefined;
+    agentDid?: string | undefined;
+    description?: string | undefined;
+    requiresAuth?: boolean | undefined;
+    authProvider?: string | undefined;
+}>;
+/** MCP Client Config Schema */
+export declare const MCPClientConfigSchema: z.ZodObject<{
+    claudeDesktop: z.ZodObject<{
+        mcpServers: z.ZodRecord<z.ZodString, z.ZodObject<{
+            url: z.ZodString;
+            transport: z.ZodOptional<z.ZodLiteral<"sse">>;
+        }, "strip", z.ZodTypeAny, {
+            url: string;
+            transport?: "sse" | undefined;
+        }, {
+            url: string;
+            transport?: "sse" | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        mcpServers: Record<string, {
+            url: string;
+            transport?: "sse" | undefined;
+        }>;
+    }, {
+        mcpServers: Record<string, {
+            url: string;
+            transport?: "sse" | undefined;
+        }>;
+    }>;
+    cursor: z.ZodObject<{
+        mcpServers: z.ZodRecord<z.ZodString, z.ZodObject<{
+            url: z.ZodString;
+            transport: z.ZodOptional<z.ZodLiteral<"sse">>;
+        }, "strip", z.ZodTypeAny, {
+            url: string;
+            transport?: "sse" | undefined;
+        }, {
+            url: string;
+            transport?: "sse" | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        mcpServers: Record<string, {
+            url: string;
+            transport?: "sse" | undefined;
+        }>;
+    }, {
+        mcpServers: Record<string, {
+            url: string;
+            transport?: "sse" | undefined;
+        }>;
+    }>;
+    cursorDeepLink: z.ZodOptional<z.ZodString>;
+    _meta: z.ZodOptional<z.ZodObject<{
+        serverName: z.ZodOptional<z.ZodString>;
+        serverUrl: z.ZodOptional<z.ZodString>;
+        mcpEndpoint: z.ZodOptional<z.ZodString>;
+        agentDid: z.ZodOptional<z.ZodString>;
+        generatedAt: z.ZodOptional<z.ZodNumber>;
+        instructions: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodUnknown, z.objectOutputType<{
+        serverName: z.ZodOptional<z.ZodString>;
+        serverUrl: z.ZodOptional<z.ZodString>;
+        mcpEndpoint: z.ZodOptional<z.ZodString>;
+        agentDid: z.ZodOptional<z.ZodString>;
+        generatedAt: z.ZodOptional<z.ZodNumber>;
+        instructions: z.ZodOptional<z.ZodString>;
+    }, z.ZodUnknown, "strip">, z.objectInputType<{
+        serverName: z.ZodOptional<z.ZodString>;
+        serverUrl: z.ZodOptional<z.ZodString>;
+        mcpEndpoint: z.ZodOptional<z.ZodString>;
+        agentDid: z.ZodOptional<z.ZodString>;
+        generatedAt: z.ZodOptional<z.ZodNumber>;
+        instructions: z.ZodOptional<z.ZodString>;
+    }, z.ZodUnknown, "strip">>>;
+}, "strip", z.ZodTypeAny, {
+    claudeDesktop: {
+        mcpServers: Record<string, {
+            url: string;
+            transport?: "sse" | undefined;
+        }>;
+    };
+    cursor: {
+        mcpServers: Record<string, {
+            url: string;
+            transport?: "sse" | undefined;
+        }>;
+    };
+    _meta?: z.objectOutputType<{
+        serverName: z.ZodOptional<z.ZodString>;
+        serverUrl: z.ZodOptional<z.ZodString>;
+        mcpEndpoint: z.ZodOptional<z.ZodString>;
+        agentDid: z.ZodOptional<z.ZodString>;
+        generatedAt: z.ZodOptional<z.ZodNumber>;
+        instructions: z.ZodOptional<z.ZodString>;
+    }, z.ZodUnknown, "strip"> | undefined;
+    cursorDeepLink?: string | undefined;
+}, {
+    claudeDesktop: {
+        mcpServers: Record<string, {
+            url: string;
+            transport?: "sse" | undefined;
+        }>;
+    };
+    cursor: {
+        mcpServers: Record<string, {
+            url: string;
+            transport?: "sse" | undefined;
+        }>;
+    };
+    _meta?: z.objectInputType<{
+        serverName: z.ZodOptional<z.ZodString>;
+        serverUrl: z.ZodOptional<z.ZodString>;
+        mcpEndpoint: z.ZodOptional<z.ZodString>;
+        agentDid: z.ZodOptional<z.ZodString>;
+        generatedAt: z.ZodOptional<z.ZodNumber>;
+        instructions: z.ZodOptional<z.ZodString>;
+    }, z.ZodUnknown, "strip"> | undefined;
+    cursorDeepLink?: string | undefined;
+}>;
 export declare const WellKnownConfigSchema: z.ZodObject<{
     serviceName: z.ZodOptional<z.ZodString>;
+    serviceTitle: z.ZodOptional<z.ZodString>;
     serviceEndpoint: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    serverVersion: z.ZodOptional<z.ZodString>;
+    protocolVersion: z.ZodOptional<z.ZodString>;
+    iconUrl: z.ZodOptional<z.ZodString>;
+    documentationUrl: z.ZodOptional<z.ZodString>;
+    requiresAuth: z.ZodOptional<z.ZodBoolean>;
+    authSchemes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    instructions: z.ZodOptional<z.ZodString>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     metadata?: Record<string, unknown> | undefined;
+    protocolVersion?: string | undefined;
+    description?: string | undefined;
     serviceEndpoint?: string | undefined;
+    instructions?: string | undefined;
     serviceName?: string | undefined;
+    iconUrl?: string | undefined;
+    documentationUrl?: string | undefined;
+    requiresAuth?: boolean | undefined;
+    serviceTitle?: string | undefined;
+    serverVersion?: string | undefined;
+    authSchemes?: string[] | undefined;
 }, {
     metadata?: Record<string, unknown> | undefined;
+    protocolVersion?: string | undefined;
+    description?: string | undefined;
     serviceEndpoint?: string | undefined;
+    instructions?: string | undefined;
     serviceName?: string | undefined;
+    iconUrl?: string | undefined;
+    documentationUrl?: string | undefined;
+    requiresAuth?: boolean | undefined;
+    serviceTitle?: string | undefined;
+    serverVersion?: string | undefined;
+    authSchemes?: string[] | undefined;
 }>;
 export declare const WellKnownResponseSchema: z.ZodObject<{
     status: z.ZodNumber;
@@ -306,3 +987,27 @@ export declare function isWellKnownPath(path: string): boolean;
  * Get the content type for a well-known endpoint
  */
 export declare function getWellKnownContentType(path: WellKnownPath | string): string;
+/**
+ * Type guard for MCPServerCard (SEP-1649)
+ */
+export declare function isMCPServerCard(obj: any): obj is MCPServerCard;
+/**
+ * Validation function for MCPServerCard (SEP-1649)
+ */
+export declare function validateMCPServerCard(obj: any): MCPServerCard;
+/**
+ * Type guard for MCPServerConfig (legacy)
+ */
+export declare function isMCPServerConfig(obj: any): obj is MCPServerConfig;
+/**
+ * Validation function for MCPServerConfig (legacy)
+ */
+export declare function validateMCPServerConfig(obj: any): MCPServerConfig;
+/**
+ * Type guard for MCPClientConfig
+ */
+export declare function isMCPClientConfig(obj: any): obj is MCPClientConfig;
+/**
+ * Validation function for MCPClientConfig
+ */
+export declare function validateMCPClientConfig(obj: any): MCPClientConfig;