@smithery/api 0.23.0 → 0.25.0

package/resources/tokens.d.ts

@@ -9,57 +9,83 @@ export declare class Tokens extends APIResource {
      * @example
      * ```ts
      * const createTokenResponse = await client.tokens.create({
-     *   permissions: {
-     *     connections: { can: ['read', 'write'] },
-     *     'connections.rpc': { can: ['write'] },
-     *   },
+     *   allow: {},
      *   ttlSeconds: 3600,
      * });
      * ```
      */
     create(body: TokenCreateParams, options?: RequestOptions): APIPromise<CreateTokenResponse>;
 }
-export interface CreateTokenRequest {
+/**
+ * Permission action. 'read' allows reading/listing. 'write' allows
+ * create/modify/delete.
+ */
+export type Action = 'read' | 'write';
+/**
+ * Permission grants with per-resource scoping. Each resource defines its own
+ * namespaces and constraints.
+ */
+export interface Allow {
+    /**
+     * Scope for managing MCP connections.
+     */
+    connections?: ConnectionScope;
+    /**
+     * Scope for deployment operations.
+     */
+    deployments?: ResourceScope;
+    /**
+     * Scope for namespace management.
+     */
+    namespaces?: ResourceScope;
+    /**
+     * Scope for making RPC calls on connections.
+     */
+    rpc?: RpcScope;
+    /**
+     * Scope for server metadata and configuration.
+     */
+    servers?: ResourceScope;
     /**
-     * Permissions to grant. Format: { [subject]: { can: [actions] } }
+     * Scope for token creation.
      */
-    permissions: {
-        [key: string]: CreateTokenRequest.Permissions;
+    tokens?: ResourceScope;
+}
+/**
+ * Scope for connection operations.
+ */
+export interface ConnectionScope {
+    /**
+     * Actions allowed on connections.
+     */
+    actions: Array<Action>;
+    /**
+     * Namespaces this scope applies to. Use '\*' for all namespaces.
+     */
+    namespaces: Array<string>;
+    /**
+     * Filter access to connections with matching metadata. All keys must match (AND
+     * semantics).
+     */
+    metadata?: {
+        [key: string]: string;
     };
+}
+export interface CreateTokenRequest {
     /**
-     * Token TTL in seconds. Required. Max 86400 (24 hours).
+     * Per-resource permission grants. Format: { [resource]: { actions: [...],
+     * namespaces: [...], metadata?: {...} } }
      */
-    ttlSeconds: number;
+    allow: Allow;
     /**
-     * Optional constraints to limit token access.
+     * Token TTL in seconds. Required. Max 86400 (24 hours).
      */
-    constraints?: CreateTokenRequest.Constraints;
+    ttlSeconds: number;
     /**
      * Profile to scope the token to. If not provided, uses the default profile.
      */
     profileSlug?: string;
 }
-export declare namespace CreateTokenRequest {
-    interface Permissions {
-        /**
-         * Actions granted on this subject.
-         */
-        can: Array<'read' | 'write'>;
-    }
-    /**
-     * Optional constraints to limit token access.
-     */
-    interface Constraints {
-        /**
-         * Limit access to specific namespace IDs.
-         */
-        namespaceIds?: Array<string>;
-        /**
-         * Limit access to specific server qualified names.
-         */
-        serverQualifiedNames?: Array<string>;
-    }
-}
 export interface CreateTokenResponse {
     /**
      * The signed service token (PASETO v4).
@@ -70,48 +96,55 @@ export interface CreateTokenResponse {
      */
     expiresAt: string;
 }
-export interface TokenCreateParams {
+/**
+ * Scope for resource operations.
+ */
+export interface ResourceScope {
     /**
-     * Permissions to grant. Format: { [subject]: { can: [actions] } }
+     * Actions allowed on this resource.
      */
-    permissions: {
-        [key: string]: TokenCreateParams.Permissions;
+    actions: Array<Action>;
+    /**
+     * Namespaces this scope applies to. Use '\*' for all namespaces.
+     */
+    namespaces: Array<string>;
+}
+/**
+ * Scope for RPC operations on connections.
+ */
+export interface RpcScope {
+    /**
+     * Actions allowed for RPC calls.
+     */
+    actions: Array<Action>;
+    /**
+     * Namespaces this scope applies to. Use '\*' for all namespaces.
+     */
+    namespaces: Array<string>;
+    /**
+     * Filter access to connections with matching metadata. All keys must match (AND
+     * semantics).
+     */
+    metadata?: {
+        [key: string]: string;
     };
+}
+export interface TokenCreateParams {
     /**
-     * Token TTL in seconds. Required. Max 86400 (24 hours).
+     * Per-resource permission grants. Format: { [resource]: { actions: [...],
+     * namespaces: [...], metadata?: {...} } }
      */
-    ttlSeconds: number;
+    allow: Allow;
     /**
-     * Optional constraints to limit token access.
+     * Token TTL in seconds. Required. Max 86400 (24 hours).
      */
-    constraints?: TokenCreateParams.Constraints;
+    ttlSeconds: number;
     /**
      * Profile to scope the token to. If not provided, uses the default profile.
      */
     profileSlug?: string;
 }
-export declare namespace TokenCreateParams {
-    interface Permissions {
-        /**
-         * Actions granted on this subject.
-         */
-        can: Array<'read' | 'write'>;
-    }
-    /**
-     * Optional constraints to limit token access.
-     */
-    interface Constraints {
-        /**
-         * Limit access to specific namespace IDs.
-         */
-        namespaceIds?: Array<string>;
-        /**
-         * Limit access to specific server qualified names.
-         */
-        serverQualifiedNames?: Array<string>;
-    }
-}
 export declare namespace Tokens {
-    export { type CreateTokenRequest as CreateTokenRequest, type CreateTokenResponse as CreateTokenResponse, type TokenCreateParams as TokenCreateParams, };
+    export { type Action as Action, type Allow as Allow, type ConnectionScope as ConnectionScope, type CreateTokenRequest as CreateTokenRequest, type CreateTokenResponse as CreateTokenResponse, type ResourceScope as ResourceScope, type RpcScope as RpcScope, type TokenCreateParams as TokenCreateParams, };
 }
 //# sourceMappingURL=tokens.d.ts.map

package/resources/tokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/resources/tokens.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,mBAAmB,CAAC;CAG3F;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,WAAW,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAAC,WAAW,CAAA;KAAE,CAAC;IAE/D;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC;IAE7C;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,yBAAiB,kBAAkB,CAAC;IAClC,UAAiB,WAAW;QAC1B;;WAEG;QACH,GAAG,EAAE,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC;KAC9B;IAED;;OAEG;IACH,UAAiB,WAAW;QAC1B;;WAEG;QACH,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAE7B;;WAEG;QACH,oBAAoB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;KACtC;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,WAAW,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAAC,WAAW,CAAA;KAAE,CAAC;IAE9D;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC,WAAW,CAAC;IAE5C;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,yBAAiB,iBAAiB,CAAC;IACjC,UAAiB,WAAW;QAC1B;;WAEG;QACH,GAAG,EAAE,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC;KAC9B;IAED;;OAEG;IACH,UAAiB,WAAW;QAC1B;;WAEG;QACH,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAE7B;;WAEG;QACH,oBAAoB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;KACtC;CACF;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,iBAAiB,IAAI,iBAAiB,GAC5C,CAAC;CACH"}
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/resources/tokens.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,mBAAmB,CAAC;CAG3F;AAED;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtC;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;IAE9B;;OAEG;IACH,WAAW,CAAC,EAAE,aAAa,CAAC;IAE5B;;OAEG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC;IAE3B;;OAEG;IACH,GAAG,CAAC,EAAE,QAAQ,CAAC;IAEf;;OAEG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IAExB;;OAEG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEvB;;OAEG;IACH,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,KAAK,EAAE,KAAK,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEvB;;OAEG;IACH,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEvB;;OAEG;IACH,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,KAAK,EAAE,KAAK,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,KAAK,MAAM,IAAI,MAAM,EACrB,KAAK,KAAK,IAAI,KAAK,EACnB,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,aAAa,IAAI,aAAa,EACnC,KAAK,QAAQ,IAAI,QAAQ,EACzB,KAAK,iBAAiB,IAAI,iBAAiB,GAC5C,CAAC;CACH"}

package/resources/tokens.js

@@ -11,10 +11,7 @@ class Tokens extends resource_1.APIResource {
      * @example
      * ```ts
      * const createTokenResponse = await client.tokens.create({
-     *   permissions: {
-     *     connections: { can: ['read', 'write'] },
-     *     'connections.rpc': { can: ['write'] },
-     *   },
+     *   allow: {},
      *   ttlSeconds: 3600,
      * });
      * ```

package/resources/tokens.js.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/resources/tokens.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,MAAa,MAAO,SAAQ,sBAAW;IACrC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,IAAuB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;CACF;AAnBD,wBAmBC"}
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/resources/tokens.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,MAAa,MAAO,SAAQ,sBAAW;IACrC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAuB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;CACF;AAhBD,wBAgBC"}

package/resources/tokens.mjs

@@ -8,10 +8,7 @@ export class Tokens extends APIResource {
      * @example
      * ```ts
      * const createTokenResponse = await client.tokens.create({
-     *   permissions: {
-     *     connections: { can: ['read', 'write'] },
-     *     'connections.rpc': { can: ['write'] },
-     *   },
+     *   allow: {},
      *   ttlSeconds: 3600,
      * });
      * ```

package/resources/tokens.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.mjs","sourceRoot":"","sources":["../src/resources/tokens.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAItB,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,IAAuB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;CACF"}
+{"version":3,"file":"tokens.mjs","sourceRoot":"","sources":["../src/resources/tokens.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAItB,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAuB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/src/client.ts

@@ -29,13 +29,23 @@ import * as API from './resources/index';
 import { APIPromise } from './core/api-promise';
 import { Health, HealthCheckResponse } from './resources/health';
 import {
-  NamespaceCreateParams,
   NamespaceCreateResponse,
   NamespaceListResponse,
+  NamespaceSetResponse,
   Namespaces,
 } from './resources/namespaces';
 import { SkillListParams, SkillListResponse, SkillListResponsesSkillsPage, Skills } from './resources/skills';
-import { CreateTokenRequest, CreateTokenResponse, TokenCreateParams, Tokens } from './resources/tokens';
+import {
+  Action,
+  Allow,
+  ConnectionScope,
+  CreateTokenRequest,
+  CreateTokenResponse,
+  ResourceScope,
+  RpcScope,
+  TokenCreateParams,
+  Tokens,
+} from './resources/tokens';
 import { Uplink, UplinkCreateTokenResponse } from './resources/uplink';
 import { Beta } from './resources/beta/beta';
 import {
@@ -43,10 +53,10 @@ import {
   DeploymentTarget,
   ProjectConfig,
   ServerDeleteResponse,
+  ServerGetResponse,
   ServerListParams,
   ServerListResponse,
   ServerListResponsesSmitheryPage,
-  ServerRetrieveResponse,
   Servers,
 } from './resources/servers/servers';
 import { type Fetch } from './internal/builtin-types';
@@ -785,9 +795,9 @@ export declare namespace Smithery {
     type BuildConfig as BuildConfig,
     type DeploymentTarget as DeploymentTarget,
     type ProjectConfig as ProjectConfig,
-    type ServerRetrieveResponse as ServerRetrieveResponse,
     type ServerListResponse as ServerListResponse,
     type ServerDeleteResponse as ServerDeleteResponse,
+    type ServerGetResponse as ServerGetResponse,
     type ServerListResponsesSmitheryPage as ServerListResponsesSmitheryPage,
     type ServerListParams as ServerListParams,
   };
@@ -805,13 +815,18 @@ export declare namespace Smithery {
     Namespaces as Namespaces,
     type NamespaceCreateResponse as NamespaceCreateResponse,
     type NamespaceListResponse as NamespaceListResponse,
-    type NamespaceCreateParams as NamespaceCreateParams,
+    type NamespaceSetResponse as NamespaceSetResponse,
   };
 
   export {
     Tokens as Tokens,
+    type Action as Action,
+    type Allow as Allow,
+    type ConnectionScope as ConnectionScope,
     type CreateTokenRequest as CreateTokenRequest,
     type CreateTokenResponse as CreateTokenResponse,
+    type ResourceScope as ResourceScope,
+    type RpcScope as RpcScope,
     type TokenCreateParams as TokenCreateParams,
   };
 

package/src/lib/mcp-transport.ts

@@ -0,0 +1,300 @@
+/**
+ * SmitheryTransport - An MCP Transport that routes JSON-RPC messages through Smithery Connect.
+ *
+ * This allows you to use the official MCP SDK's Client class with Smithery Connect as the transport layer.
+ *
+ * **Important:** Smithery Connect handles MCP initialization server-side when a connection is created.
+ * This transport lazily fetches/creates the connection on first message and uses its server info
+ * to satisfy the MCP SDK's initialization flow without re-initializing the already-established connection.
+ *
+ * @example
+ * ```typescript
+ * import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+ * import Smithery from '@smithery/api';
+ * import { SmitheryTransport } from '@smithery/api/mcp';
+ *
+ * const smithery = new Smithery({ apiKey: process.env.SMITHERY_API_KEY });
+ * // Option 1: Let Smithery generate a connection ID and use default namespace
+ * const transport = new SmitheryTransport({
+ *   client: smithery,
+ *   mcpUrl: 'https://mcp.example.com/sse',
+ * });
+ *
+ * // Option 2: Use a specific namespace and connection ID
+ * const transport2 = new SmitheryTransport({
+ *   client: smithery,
+ *   namespace: 'my-namespace',
+ *   connectionId: 'my-connection',
+ *   mcpUrl: 'https://mcp.example.com/sse',
+ * });
+ *
+ * const mcpClient = new Client({ name: 'my-app', version: '1.0.0' }, { capabilities: {} });
+ * await mcpClient.connect(transport);
+ *
+ * // Now use the MCP SDK's ergonomic API
+ * const { tools } = await mcpClient.listTools();
+ * const result = await mcpClient.callTool({ name: 'my-tool', arguments: {} });
+ * ```
+ */
+
+import type { Transport, TransportSendOptions } from '@modelcontextprotocol/sdk/shared/transport.js';
+import type { JSONRPCMessage, JSONRPCResponse, ServerCapabilities } from '@modelcontextprotocol/sdk/types.js';
+import type { Smithery } from '../client';
+import type { Connection } from '../resources/beta/connect/connections';
+
+export interface SmitheryTransportOptions {
+  /**
+   * The Smithery client instance to use for making RPC calls.
+   */
+  client: Smithery;
+
+  /**
+   * The namespace for the Smithery Connect connection.
+   * If not provided, uses the first existing namespace or creates a new one.
+   */
+  namespace?: string;
+
+  /**
+   * The connection ID for the Smithery Connect connection.
+   * If not provided, a new connection will be created with an auto-generated ID.
+   */
+  connectionId?: string;
+
+  /**
+   * The MCP server URL. Required when creating a new connection.
+   * If connectionId is provided, this is used to create the connection if it doesn't exist.
+   * If connectionId is not provided, this is required and a new connection will be created.
+   */
+  mcpUrl?: string;
+
+  /**
+   * Optional server capabilities for the initialize response.
+   * If not provided, defaults to advertising tools, resources, and prompts support.
+   */
+  capabilities?: ServerCapabilities;
+}
+
+// MCP protocol version
+const LATEST_PROTOCOL_VERSION = '2024-11-05';
+
+export class SmitheryTransport implements Transport {
+  private _client: Smithery;
+  private _namespace: string | undefined;
+  private _connectionId: string | undefined;
+  private _mcpUrl: string | undefined;
+  private _started = false;
+  private _closed = false;
+  private _capabilities: ServerCapabilities;
+  private _connection: Connection | null = null;
+
+  onmessage?: (message: JSONRPCMessage) => void;
+  onerror?: (error: Error) => void;
+  onclose?: () => void;
+
+  sessionId?: string;
+
+  /**
+   * Returns the connection ID. If no connectionId was provided in options,
+   * this returns the auto-generated ID after the first message is sent.
+   */
+  get connectionId(): string | undefined {
+    return this._connectionId;
+  }
+
+  constructor(options: SmitheryTransportOptions) {
+    this._client = options.client;
+    this._namespace = options.namespace;
+    this._connectionId = options.connectionId;
+    this._mcpUrl = options.mcpUrl;
+
+    // Validate: mcpUrl is required if connectionId is not provided
+    if (!this._connectionId && !this._mcpUrl) {
+      throw new Error('mcpUrl is required when connectionId is not provided');
+    }
+
+    this._capabilities = options.capabilities ?? {
+      // Default to advertising common capabilities
+      // The actual MCP server behind Smithery Connect will handle the real capabilities
+      tools: {},
+      resources: {},
+      prompts: {},
+    };
+  }
+
+  async start(): Promise<void> {
+    if (this._started) {
+      throw new Error(
+        'SmitheryTransport already started! If using Client class, note that connect() calls start() automatically.',
+      );
+    }
+    if (this._closed) {
+      throw new Error('Transport has been closed');
+    }
+
+    this._started = true;
+  }
+
+  /**
+   * Lazily ensures a namespace is available.
+   * If no namespace was provided, uses the first existing namespace or creates a new one.
+   */
+  private async _ensureNamespace(): Promise<string> {
+    if (this._namespace) {
+      return this._namespace;
+    }
+
+    const { namespaces } = await this._client.namespaces.list();
+    if (namespaces.length > 0) {
+      this._namespace = namespaces[0]!.name;
+    } else {
+      // Create a new namespace with server-generated name
+      const { name } = await this._client.namespaces.create();
+      this._namespace = name;
+    }
+    return this._namespace;
+  }
+
+  /**
+   * Lazily ensures the Smithery Connect connection exists.
+   * Called on first message to defer network IO until actually needed.
+   */
+  private async _ensureConnection(): Promise<void> {
+    if (this._connection) {
+      return;
+    }
+
+    const namespace = await this._ensureNamespace();
+
+    if (this._connectionId) {
+      // Connection ID provided: try to get, or create if mcpUrl is provided
+      try {
+        this._connection = await this._client.beta.connect.connections.get(this._connectionId, {
+          namespace,
+        });
+      } catch (error) {
+        // If connection doesn't exist and we have mcpUrl, create it with the specified ID
+        if (this._mcpUrl) {
+          this._connection = await this._client.beta.connect.connections.set(this._connectionId, {
+            namespace,
+            mcpUrl: this._mcpUrl,
+          });
+        } else {
+          throw error;
+        }
+      }
+    } else {
+      // No connection ID: create a new connection with auto-generated ID
+      // mcpUrl is guaranteed to be present (validated in constructor)
+      this._connection = await this._client.beta.connect.connections.create(namespace, {
+        mcpUrl: this._mcpUrl!,
+      });
+      // Store the generated connection ID for subsequent RPC calls
+      this._connectionId = this._connection.connectionId;
+    }
+  }
+
+  async send(message: JSONRPCMessage, _options?: TransportSendOptions): Promise<void> {
+    if (!this._started) {
+      throw new Error('Transport not started');
+    }
+    if (this._closed) {
+      throw new Error('Transport has been closed');
+    }
+
+    // Only handle outgoing requests and notifications (messages with a method)
+    if (!('method' in message)) {
+      return;
+    }
+
+    // Lazily ensure connection exists before processing any message
+    await this._ensureConnection();
+
+    // Intercept 'initialize' request - Smithery Connect handles initialization server-side
+    // Return the real serverInfo from the connection
+    if (message.method === 'initialize' && 'id' in message && message.id !== undefined) {
+      if (this.onmessage) {
+        const serverInfo = this._connection?.serverInfo ?? {
+          name: 'smithery-connect',
+          version: '1.0.0',
+        };
+
+        const initializeResponse: JSONRPCResponse = {
+          jsonrpc: '2.0',
+          id: message.id,
+          result: {
+            protocolVersion: LATEST_PROTOCOL_VERSION,
+            serverInfo: {
+              name: serverInfo.name,
+              version: serverInfo.version,
+            },
+            capabilities: this._capabilities,
+          } as Record<string, unknown>,
+        };
+        // Use setTimeout to make this async and match real transport behavior
+        setTimeout(() => this.onmessage!(initializeResponse), 0);
+      }
+      return;
+    }
+
+    // Intercept 'notifications/initialized' - no response needed, just acknowledge
+    if (message.method === 'notifications/initialized') {
+      return;
+    }
+
+    try {
+      // Build the RPC call params, only including id if it's defined
+      // _namespace is guaranteed to be set after _ensureConnection
+      const rpcParams: Parameters<typeof this._client.beta.connect.rpc.call>[1] = {
+        namespace: this._namespace!,
+        jsonrpc: '2.0',
+        method: message.method,
+      };
+
+      // Only add id if present (for requests, not notifications)
+      if ('id' in message && message.id !== undefined) {
+        rpcParams.id = message.id;
+      }
+
+      // Only add params if present
+      if ('params' in message && message.params !== undefined) {
+        rpcParams.params = message.params as Record<string, unknown>;
+      }
+
+      const response = await this._client.beta.connect.rpc.call(this._connectionId!, rpcParams);
+
+      // Route the response back via onmessage callback for requests (messages with an id)
+      if ('id' in message && message.id !== undefined && this.onmessage) {
+        const jsonRpcResponse: JSONRPCResponse = {
+          jsonrpc: '2.0',
+          id: response.id!,
+          result: response.result as Record<string, unknown>,
+        };
+        this.onmessage(jsonRpcResponse);
+      }
+    } catch (error) {
+      const normalizedError = error instanceof Error ? error : new Error(String(error));
+
+      // For requests, send an error response via onmessage
+      if ('id' in message && message.id !== undefined && this.onmessage) {
+        const errorResponse: JSONRPCResponse = {
+          jsonrpc: '2.0',
+          id: message.id,
+          error: {
+            code: -32603, // Internal error
+            message: normalizedError.message,
+          },
+        };
+        this.onmessage(errorResponse);
+      }
+
+      // Also report via onerror callback
+      this.onerror?.(normalizedError);
+    }
+  }
+
+  async close(): Promise<void> {
+    this._closed = true;
+    this._started = false;
+    this.onclose?.();
+  }
+}

package/src/resources/beta/connect/connect.ts

@@ -7,7 +7,8 @@ import {
   ConnectionCreateParams,
   ConnectionDeleteParams,
   ConnectionDeleteResponse,
-  ConnectionRetrieveParams,
+  ConnectionGetParams,
+  ConnectionListParams,
   ConnectionSetParams,
   Connections,
   ConnectionsListResponse,
@@ -32,8 +33,9 @@ export declare namespace Connect {
     type CreateConnectionRequest as CreateConnectionRequest,
     type ConnectionDeleteResponse as ConnectionDeleteResponse,
     type ConnectionCreateParams as ConnectionCreateParams,
-    type ConnectionRetrieveParams as ConnectionRetrieveParams,
+    type ConnectionListParams as ConnectionListParams,
     type ConnectionDeleteParams as ConnectionDeleteParams,
+    type ConnectionGetParams as ConnectionGetParams,
     type ConnectionSetParams as ConnectionSetParams,
   };