@smithery/api 0.65.1 → 0.66.0

package/src/client.ts

@@ -89,6 +89,8 @@ import {
   ServerListParams,
   ServerListResponse,
   ServerListResponsesSmitheryPage,
+  ServerTransferParams,
+  ServerTransferResponse,
   ServerUpdateParams,
   ServerUpdateResponse,
   Servers,
@@ -112,6 +114,11 @@ export interface ClientOptions {
    */
   apiKey?: string | undefined;
 
+  /**
+   * Base URL for Smithery Connect REST methods.
+   */
+  connectBaseURL?: string | null | undefined;
+
   /**
    * Override the default base URL for the API, e.g., "https://api.example.com/v2/"
    *
@@ -186,6 +193,7 @@ export interface ClientOptions {
  */
 export class Smithery {
   apiKey: string;
+  connectBaseURL: string | null;
 
   baseURL: string;
   maxRetries: number;
@@ -203,6 +211,7 @@ export class Smithery {
    * API Client for interfacing with the Smithery API.
    *
    * @param {string | undefined} [opts.apiKey=process.env['SMITHERY_API_KEY'] ?? undefined]
+   * @param {string | null | undefined} [opts.connectBaseURL=process.env['SMITHERY_CONNECT_BASE_URL'] ?? https://smithery.run]
    * @param {string} [opts.baseURL=process.env['SMITHERY_BASE_URL'] ?? https://api.smithery.ai] - Override the default base URL for the API.
    * @param {number} [opts.timeout=1 minute] - The maximum amount of time (in milliseconds) the client will wait for a response before timing out.
    * @param {MergedRequestInit} [opts.fetchOptions] - Additional `RequestInit` options to be passed to `fetch` calls.
@@ -214,6 +223,7 @@ export class Smithery {
   constructor({
     baseURL = readEnv('SMITHERY_BASE_URL'),
     apiKey = readEnv('SMITHERY_API_KEY'),
+    connectBaseURL = readEnv('SMITHERY_CONNECT_BASE_URL') ?? 'https://smithery.run',
     ...opts
   }: ClientOptions = {}) {
     if (apiKey === undefined) {
@@ -224,6 +234,7 @@ export class Smithery {
 
     const options: ClientOptions = {
       apiKey,
+      connectBaseURL,
       ...opts,
       baseURL: baseURL || `https://api.smithery.ai`,
     };
@@ -258,6 +269,7 @@ export class Smithery {
     this._options = options;
 
     this.apiKey = apiKey;
+    this.connectBaseURL = connectBaseURL;
   }
 
   /**
@@ -274,6 +286,7 @@ export class Smithery {
       fetch: this.fetch,
       fetchOptions: this.fetchOptions,
       apiKey: this.apiKey,
+      connectBaseURL: this.connectBaseURL,
       ...options,
     });
     return client;
@@ -324,7 +337,12 @@ export class Smithery {
     query: Record<string, unknown> | null | undefined,
     defaultBaseURL?: string | undefined,
   ): string {
-    const baseURL = (!this.#baseURLOverridden() && defaultBaseURL) || this.baseURL;
+    const resolvedDefaultBaseURL =
+      defaultBaseURL === 'https://smithery.run' ? this.connectBaseURL || defaultBaseURL : defaultBaseURL;
+    const baseURL =
+      (defaultBaseURL === 'https://smithery.run' && resolvedDefaultBaseURL) ||
+      (!this.#baseURLOverridden() && resolvedDefaultBaseURL) ||
+      this.baseURL;
     const url =
       isAbsoluteURL(path) ?
         new URL(path)
@@ -879,10 +897,12 @@ export declare namespace Smithery {
     type ServerListResponse as ServerListResponse,
     type ServerDeleteResponse as ServerDeleteResponse,
     type ServerGetResponse as ServerGetResponse,
+    type ServerTransferResponse as ServerTransferResponse,
     type ServerListResponsesSmitheryPage as ServerListResponsesSmitheryPage,
     type ServerCreateParams as ServerCreateParams,
     type ServerUpdateParams as ServerUpdateParams,
     type ServerListParams as ServerListParams,
+    type ServerTransferParams as ServerTransferParams,
   };
 
   export {

package/src/resources/connections/connections.ts

@@ -126,10 +126,11 @@ export class Connections extends APIResource {
   }
 
   /**
-   * Create or update an MCP connection with the given ID. mcpUrl is required when
-   * creating a new connection, but optional when updating. Returns 409 if a
-   * different mcpUrl is provided, except while the connection is input_required and
-   * the new URL keeps the same host and path.
+   * Create or update an MCP connection with the given ID. `server` is the Smithery
+   * registry qualified name; `mcpUrl` is for custom MCP URLs. One of them is
+   * required when creating a new HTTP connection, but optional when updating.
+   * Returns 409 if a different target URL is provided, except while the connection
+   * is input_required and the new URL keeps the same host and path.
    *
    * @example
    * ```ts
@@ -342,8 +343,7 @@ export interface CreateConnectionRequest {
   headers?: { [key: string]: string };
 
   /**
-   * URL of the MCP server. Required for HTTP connections. Omit for uplink
-   * connections.
+   * URL of a custom MCP server. For Smithery registry servers, prefer `server`.
    */
   mcpUrl?: string;
 
@@ -365,6 +365,12 @@ export interface CreateConnectionRequest {
    */
   name?: string;
 
+  /**
+   * Smithery registry server qualified name. Use this instead of mcpUrl for registry
+   * servers.
+   */
+  server?: string;
+
   /**
    * Connection transport. Use `uplink` for a local server paired over Smithery CLI.
    */
@@ -404,8 +410,7 @@ export interface ConnectionCreateParams {
   headers?: { [key: string]: string };
 
   /**
-   * URL of the MCP server. Required for HTTP connections. Omit for uplink
-   * connections.
+   * URL of a custom MCP server. For Smithery registry servers, prefer `server`.
    */
   mcpUrl?: string;
 
@@ -427,6 +432,12 @@ export interface ConnectionCreateParams {
    */
   name?: string;
 
+  /**
+   * Smithery registry server qualified name. Use this instead of mcpUrl for registry
+   * servers.
+   */
+  server?: string;
+
   /**
    * Connection transport. Use `uplink` for a local server paired over Smithery CLI.
    */
@@ -497,8 +508,9 @@ export interface ConnectionSetParams {
   headers?: { [key: string]: string };
 
   /**
-   * Body param: URL of the MCP server. Required when creating a new connection.
-   * Optional when updating — omit to keep the existing URL.
+   * Body param: URL of a custom MCP server. For Smithery registry servers, prefer
+   * `server`. Required with `server` omitted when creating a new HTTP connection;
+   * optional when updating.
    */
   mcpUrl?: string;
 
@@ -518,6 +530,12 @@ export interface ConnectionSetParams {
    */
   name?: string;
 
+  /**
+   * Body param: Smithery registry server qualified name. Use this instead of mcpUrl
+   * for registry servers.
+   */
+  server?: string;
+
   /**
    * Body param: Connection transport. Defaults to the existing connection transport
    * when updating.

package/src/resources/index.ts

@@ -33,9 +33,11 @@ export {
   type ServerListResponse,
   type ServerDeleteResponse,
   type ServerGetResponse,
+  type ServerTransferResponse,
   type ServerCreateParams,
   type ServerUpdateParams,
   type ServerListParams,
+  type ServerTransferParams,
   type ServerListResponsesSmitheryPage,
 } from './servers/servers';
 export {

package/src/resources/servers/index.ts

@@ -44,8 +44,10 @@ export {
   type ServerListResponse,
   type ServerDeleteResponse,
   type ServerGetResponse,
+  type ServerTransferResponse,
   type ServerCreateParams,
   type ServerUpdateParams,
   type ServerListParams,
+  type ServerTransferParams,
   type ServerListResponsesSmitheryPage,
 } from './servers';

package/src/resources/servers/servers.ts

@@ -149,6 +149,29 @@ export class Servers extends APIResource {
   get(qualifiedName: string, options?: RequestOptions): APIPromise<ServerGetResponse> {
     return this._client.get(path`/servers/${qualifiedName}`, options);
   }
+
+  /**
+   * Move a server to another namespace. The caller must have server write access to
+   * both the source namespace and the destination namespace.
+   *
+   * @example
+   * ```ts
+   * const response = await client.servers.transfer(
+   *   'qualifiedName',
+   *   {
+   *     targetNamespace: 'my-team',
+   *     targetOrganizationId: 'org_01H1234567890',
+   *   },
+   * );
+   * ```
+   */
+  transfer(
+    qualifiedName: string,
+    body: ServerTransferParams,
+    options?: RequestOptions,
+  ): APIPromise<ServerTransferResponse> {
+    return this._client.post(path`/servers/${qualifiedName}/transfer`, { body, ...options });
+  }
 }
 
 export type ServerListResponsesSmitheryPage = SmitheryPage<ServerListResponse>;
@@ -413,6 +436,16 @@ export namespace ServerGetResponse {
   }
 }
 
+export interface ServerTransferResponse {
+  namespace: string;
+
+  qualifiedName: string;
+
+  server: string;
+
+  success: boolean;
+}
+
 export interface ServerCreateParams {
   description?: string;
 
@@ -516,6 +549,14 @@ export interface ServerListParams extends SmitheryPageParams {
   verified?: '0' | '1' | 'true' | 'false';
 }
 
+export interface ServerTransferParams {
+  targetNamespace: string;
+
+  targetOrganizationId: string;
+
+  targetSlug?: string;
+}
+
 Servers.Releases = Releases;
 Servers.Logs = Logs;
 Servers.Secrets = Secrets;
@@ -532,10 +573,12 @@ export declare namespace Servers {
     type ServerListResponse as ServerListResponse,
     type ServerDeleteResponse as ServerDeleteResponse,
     type ServerGetResponse as ServerGetResponse,
+    type ServerTransferResponse as ServerTransferResponse,
     type ServerListResponsesSmitheryPage as ServerListResponsesSmitheryPage,
     type ServerCreateParams as ServerCreateParams,
     type ServerUpdateParams as ServerUpdateParams,
     type ServerListParams as ServerListParams,
+    type ServerTransferParams as ServerTransferParams,
   };
 
   export {

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.65.1'; // x-release-please-version
+export const VERSION = '0.66.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.65.1";
+export declare const VERSION = "0.66.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.65.1";
+export declare const VERSION = "0.66.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.65.1'; // x-release-please-version
+exports.VERSION = '0.66.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.65.1'; // x-release-please-version
+export const VERSION = '0.66.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map