@smithery/api 0.34.1 → 0.36.0

package/src/resources/servers/deployments.ts

@@ -11,7 +11,8 @@ import { path } from '../../internal/utils/path';
 
 export class Deployments extends APIResource {
   /**
-   * List deployments for a server
+   * List all deployments for a server, ordered by most recent first. Does not
+   * include deployment logs — fetch a specific deployment to see logs.
    *
    * @example
    * ```ts
@@ -31,7 +32,9 @@ export class Deployments extends APIResource {
   }
 
   /**
-   * Upload and deploy an MCP server (hosted or external)
+   * Deploy an MCP server via multipart form. Supports hosted deployments (upload a
+   * JS module), external deployments (register a URL), stdio deployments (upload an
+   * MCPB bundle), and repo deployments (build from a connected GitHub repository).
    *
    * @example
    * ```ts
@@ -54,7 +57,9 @@ export class Deployments extends APIResource {
   }
 
   /**
-   * Upload and deploy an MCP server (hosted or external)
+   * Deploy an MCP server via multipart form. Supports hosted deployments (upload a
+   * JS module), external deployments (register a URL), stdio deployments (upload an
+   * MCPB bundle), and repo deployments (build from a connected GitHub repository).
    *
    * @example
    * ```ts
@@ -77,7 +82,8 @@ export class Deployments extends APIResource {
   }
 
   /**
-   * Get deployment status
+   * Get full details for a specific deployment, including status, type, git
+   * metadata, pipeline logs, and MCP endpoint URL.
    *
    * @example
    * ```ts
@@ -93,7 +99,8 @@ export class Deployments extends APIResource {
   }
 
   /**
-   * Get deployment status
+   * Get full details for a specific deployment, including status, type, git
+   * metadata, pipeline logs, and MCP endpoint URL.
    *
    * @example
    * ```ts
@@ -113,7 +120,8 @@ export class Deployments extends APIResource {
   }
 
   /**
-   * List deployments for a server
+   * List all deployments for a server, ordered by most recent first. Does not
+   * include deployment logs — fetch a specific deployment to see logs.
    *
    * @example
    * ```ts
@@ -485,84 +493,191 @@ export namespace DeploymentListResponse {
   export interface DeploymentListResponseItem {
     id: string;
 
+    /**
+     * ISO 8601 timestamp of when the deployment was created.
+     */
     createdAt: string;
 
+    /**
+     * Current deployment status: QUEUED, WORKING, SUCCESS, FAILURE, FAILURE_SCAN,
+     * AUTH_REQUIRED, CANCELLED, or INTERNAL_ERROR.
+     */
     status: string;
 
+    /**
+     * Deployment type: hosted_shttp (Smithery-hosted), external_shttp (external URL),
+     * or stdio (local binary).
+     */
     type: string;
 
+    /**
+     * ISO 8601 timestamp of the last status change.
+     */
     updatedAt: string;
 
+    /**
+     * Git branch this deployment was built from.
+     */
     branch?: string | null;
 
+    /**
+     * Git commit SHA that triggered this deployment. Present for repo and
+     * source-tracked deployments.
+     */
     commit?: string | null;
 
+    /**
+     * Git commit message associated with this deployment.
+     */
     commitMessage?: string | null;
 
+    /**
+     * The MCP endpoint URL for connecting to this server.
+     */
     mcpUrl?: string;
 
+    /**
+     * Upstream MCP server URL. Present only for external deployments.
+     */
     upstreamUrl?: string | null;
   }
 }
 
 export interface DeploymentDeployResponse {
+  /**
+   * Unique identifier for this deployment.
+   */
   deploymentId: string;
 
+  /**
+   * The MCP endpoint URL for connecting to this server once deployed.
+   */
   mcpUrl: string;
 
+  /**
+   * Initial deployment status. Will be WORKING while the deployment is in progress.
+   */
   status: string;
 
+  /**
+   * Non-fatal warnings encountered during deployment submission.
+   */
   warnings?: Array<string>;
 }
 
 export interface DeploymentDeployByNamespaceResponse {
+  /**
+   * Unique identifier for this deployment.
+   */
   deploymentId: string;
 
+  /**
+   * The MCP endpoint URL for connecting to this server once deployed.
+   */
   mcpUrl: string;
 
+  /**
+   * Initial deployment status. Will be WORKING while the deployment is in progress.
+   */
   status: string;
 
+  /**
+   * Non-fatal warnings encountered during deployment submission.
+   */
   warnings?: Array<string>;
 }
 
 export interface DeploymentGetResponse {
   id: string;
 
+  /**
+   * ISO 8601 timestamp of when the deployment was created.
+   */
   createdAt: string;
 
+  /**
+   * Current deployment status: QUEUED, WORKING, SUCCESS, FAILURE, FAILURE_SCAN,
+   * AUTH_REQUIRED, CANCELLED, or INTERNAL_ERROR.
+   */
   status: string;
 
+  /**
+   * Deployment type: hosted_shttp (Smithery-hosted), external_shttp (external URL),
+   * or stdio (local binary).
+   */
   type: string;
 
+  /**
+   * ISO 8601 timestamp of the last status change.
+   */
   updatedAt: string;
 
+  /**
+   * Git branch this deployment was built from.
+   */
   branch?: string | null;
 
+  /**
+   * Git commit SHA that triggered this deployment. Present for repo and
+   * source-tracked deployments.
+   */
   commit?: string | null;
 
+  /**
+   * Git commit message associated with this deployment.
+   */
   commitMessage?: string | null;
 
+  /**
+   * Deployment pipeline log entries. Only included when fetching a single
+   * deployment.
+   */
   logs?: Array<DeploymentGetResponse.Log>;
 
+  /**
+   * The MCP endpoint URL for connecting to this server.
+   */
   mcpUrl?: string;
 
+  /**
+   * Upstream MCP server URL. Present only for external deployments.
+   */
   upstreamUrl?: string | null;
 }
 
 export namespace DeploymentGetResponse {
   export interface Log {
+    /**
+     * Log level: 'start', 'end', 'info', 'success', or 'failure'.
+     */
     level: string;
 
+    /**
+     * Human-readable log message.
+     */
     message: string;
 
+    /**
+     * Deployment pipeline stage: deploy (bundle upload), scan (security/OAuth check),
+     * metadata (tool discovery), publish (making the server live).
+     */
     stage: 'deploy' | 'scan' | 'metadata' | 'publish';
 
+    /**
+     * ISO 8601 timestamp of the log entry.
+     */
     timestamp: string;
 
+    /**
+     * Error details, present only when the stage failed.
+     */
     error?: Log.Error;
   }
 
   export namespace Log {
+    /**
+     * Error details, present only when the stage failed.
+     */
     export interface Error {
       message?: string;
     }
@@ -572,41 +687,94 @@ export namespace DeploymentGetResponse {
 export interface DeploymentGetByNamespaceResponse {
   id: string;
 
+  /**
+   * ISO 8601 timestamp of when the deployment was created.
+   */
   createdAt: string;
 
+  /**
+   * Current deployment status: QUEUED, WORKING, SUCCESS, FAILURE, FAILURE_SCAN,
+   * AUTH_REQUIRED, CANCELLED, or INTERNAL_ERROR.
+   */
   status: string;
 
+  /**
+   * Deployment type: hosted_shttp (Smithery-hosted), external_shttp (external URL),
+   * or stdio (local binary).
+   */
   type: string;
 
+  /**
+   * ISO 8601 timestamp of the last status change.
+   */
   updatedAt: string;
 
+  /**
+   * Git branch this deployment was built from.
+   */
   branch?: string | null;
 
+  /**
+   * Git commit SHA that triggered this deployment. Present for repo and
+   * source-tracked deployments.
+   */
   commit?: string | null;
 
+  /**
+   * Git commit message associated with this deployment.
+   */
   commitMessage?: string | null;
 
+  /**
+   * Deployment pipeline log entries. Only included when fetching a single
+   * deployment.
+   */
   logs?: Array<DeploymentGetByNamespaceResponse.Log>;
 
+  /**
+   * The MCP endpoint URL for connecting to this server.
+   */
   mcpUrl?: string;
 
+  /**
+   * Upstream MCP server URL. Present only for external deployments.
+   */
   upstreamUrl?: string | null;
 }
 
 export namespace DeploymentGetByNamespaceResponse {
   export interface Log {
+    /**
+     * Log level: 'start', 'end', 'info', 'success', or 'failure'.
+     */
     level: string;
 
+    /**
+     * Human-readable log message.
+     */
     message: string;
 
+    /**
+     * Deployment pipeline stage: deploy (bundle upload), scan (security/OAuth check),
+     * metadata (tool discovery), publish (making the server live).
+     */
     stage: 'deploy' | 'scan' | 'metadata' | 'publish';
 
+    /**
+     * ISO 8601 timestamp of the log entry.
+     */
     timestamp: string;
 
+    /**
+     * Error details, present only when the stage failed.
+     */
     error?: Log.Error;
   }
 
   export namespace Log {
+    /**
+     * Error details, present only when the stage failed.
+     */
     export interface Error {
       message?: string;
     }
@@ -620,22 +788,52 @@ export namespace DeploymentListByNamespaceResponse {
   export interface DeploymentListByNamespaceResponseItem {
     id: string;
 
+    /**
+     * ISO 8601 timestamp of when the deployment was created.
+     */
     createdAt: string;
 
+    /**
+     * Current deployment status: QUEUED, WORKING, SUCCESS, FAILURE, FAILURE_SCAN,
+     * AUTH_REQUIRED, CANCELLED, or INTERNAL_ERROR.
+     */
     status: string;
 
+    /**
+     * Deployment type: hosted_shttp (Smithery-hosted), external_shttp (external URL),
+     * or stdio (local binary).
+     */
     type: string;
 
+    /**
+     * ISO 8601 timestamp of the last status change.
+     */
     updatedAt: string;
 
+    /**
+     * Git branch this deployment was built from.
+     */
     branch?: string | null;
 
+    /**
+     * Git commit SHA that triggered this deployment. Present for repo and
+     * source-tracked deployments.
+     */
     commit?: string | null;
 
+    /**
+     * Git commit message associated with this deployment.
+     */
     commitMessage?: string | null;
 
+    /**
+     * The MCP endpoint URL for connecting to this server.
+     */
     mcpUrl?: string;
 
+    /**
+     * Upstream MCP server URL. Present only for external deployments.
+     */
     upstreamUrl?: string | null;
   }
 }

package/src/resources/servers/index.ts

@@ -66,12 +66,16 @@ export {
   type BuildConfig,
   type DeploymentTarget,
   type ProjectConfig,
+  type ServerCreateResponse,
   type ServerListResponse,
   type ServerDeleteResponse,
+  type ServerCreateByNamespaceResponse,
   type ServerGetResponse,
   type ServerGetByNamespaceResponse,
+  type ServerCreateParams,
   type ServerListParams,
   type ServerDeleteParams,
+  type ServerCreateByNamespaceParams,
   type ServerDownloadParams,
   type ServerGetParams,
   type ServerListResponsesSmitheryPage,

package/src/resources/servers/servers.ts

@@ -79,7 +79,29 @@ export class Servers extends APIResource {
   repo: RepoAPI.Repo = new RepoAPI.Repo(this._client);
 
   /**
-   * Get a paginated list of all servers. Use the `q` parameter to search.
+   * Create a new server under the specified namespace. This endpoint is idempotent -
+   * if the server already exists and is owned by the user, returns success.
+   *
+   * @example
+   * ```ts
+   * const server = await client.servers.create('server', {
+   *   namespace: 'namespace',
+   * });
+   * ```
+   */
+  create(
+    server: string,
+    params: ServerCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<ServerCreateResponse> {
+    const { namespace, ...body } = params;
+    return this._client.put(path`/servers/${namespace}/${server}`, { body, ...options });
+  }
+
+  /**
+   * Search and browse public MCP servers in the Smithery registry. Supports
+   * full-text and semantic search via the `q` parameter, and filtering by deployment
+   * status, verification, ownership, and more.
    *
    * @example
    * ```ts
@@ -115,6 +137,26 @@ export class Servers extends APIResource {
     return this._client.delete(path`/servers/${namespace}/${server}`, options);
   }
 
+  /**
+   * Create a namespace-only server where the namespace is also the server
+   * identifier. This endpoint is idempotent - if the server already exists and is
+   * owned by the user, returns success.
+   *
+   * @example
+   * ```ts
+   * const response = await client.servers.createByNamespace(
+   *   'namespace',
+   * );
+   * ```
+   */
+  createByNamespace(
+    namespace: string,
+    body: ServerCreateByNamespaceParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ServerCreateByNamespaceResponse> {
+    return this._client.put(path`/servers/${namespace}`, { body, ...options });
+  }
+
   /**
    * Download the MCPB bundle for the latest successful stdio deployment
    *
@@ -228,33 +270,76 @@ export namespace ProjectConfig {
   }
 }
 
+export interface ServerCreateResponse {
+  createdAt: string;
+
+  description: string;
+
+  displayName: string;
+
+  namespace: string;
+
+  server: string;
+}
+
 export interface ServerListResponse {
   id: string;
 
+  /**
+   * ISO 8601 timestamp of when the server was registered.
+   */
   createdAt: string;
 
   description: string;
 
   displayName: string;
 
+  /**
+   * URL to the server's page on smithery.ai.
+   */
   homepage: string;
 
   iconUrl: string | null;
 
+  /**
+   * Whether the server is currently hosted on Smithery infrastructure.
+   */
   isDeployed: boolean;
 
+  /**
+   * The namespace this server belongs to, or null if unassigned.
+   */
   namespace: string | null;
 
+  /**
+   * User ID of the server owner, or null for community servers.
+   */
   owner: string | null;
 
+  /**
+   * Unique identifier in namespace/slug format.
+   */
   qualifiedName: string;
 
+  /**
+   * Whether the server is accessed via URL (true) or runs locally via stdio (false).
+   * Null if unknown.
+   */
   remote: boolean | null;
 
+  /**
+   * URL-friendly short name within the namespace.
+   */
   slug: string | null;
 
+  /**
+   * Total number of times this server has been connected to.
+   */
   useCount: number;
 
+  /**
+   * Whether this server has been verified by Smithery.
+   */
   verified: boolean;
 }
 
@@ -264,6 +349,18 @@ export interface ServerDeleteResponse {
   success: boolean;
 }
 
+export interface ServerCreateByNamespaceResponse {
+  createdAt: string;
+
+  description: string;
+
+  displayName: string;
+
+  namespace: string;
+
+  server: string;
+}
+
 export interface ServerGetResponse {
   connections: Array<ServerGetResponse.StdioConnection | ServerGetResponse.HTTPConnection>;
 
@@ -390,25 +487,87 @@ export namespace ServerGetByNamespaceResponse {
   }
 }
 
+export interface ServerCreateParams {
+  /**
+   * Path param
+   */
+  namespace: string;
+
+  /**
+   * Body param
+   */
+  description?: string;
+
+  /**
+   * Body param
+   */
+  displayName?: string;
+}
+
 export interface ServerListParams extends SmitheryPageParams {
+  /**
+   * Comma-separated list of fields to include in response
+   */
+  fields?: string;
+
+  /**
+   * Filter by specific server IDs.
+   */
   ids?: Array<string>;
 
+  /**
+   * Filter by deployment status. Deployed servers are hosted on Smithery
+   * infrastructure.
+   */
   isDeployed?: '0' | '1' | 'true' | 'false';
 
+  /**
+   * Filter by the namespace that owns the server.
+   */
+  namespace?: string;
+
+  /**
+   * Filter by the server owner's user ID.
+   */
   ownerId?: string;
 
+  /**
+   * Search query for full-text and semantic search across server names and
+   * descriptions.
+   */
   q?: string;
 
+  /**
+   * Exact match on the server's qualified name (e.g. "smithery/hello-world").
+   * Deprecated: use GET /servers/:namespace/:server instead.
+   */
   qualifiedName?: string;
 
+  /**
+   * Filter by remote status. Remote servers are accessed via URL; non-remote servers
+   * run locally via stdio.
+   */
   remote?: '0' | '1' | 'true' | 'false';
 
+  /**
+   * Filter by connected GitHub repository name.
+   */
   repoName?: string;
 
+  /**
+   * Filter by connected GitHub repository owner.
+   */
   repoOwner?: string;
 
+  /**
+   * Maximum number of candidate results to consider from the search index before
+   * pagination.
+   */
   topK?: number;
 
+  /**
+   * Filter to only verified servers.
+   */
   verified?: '0' | '1' | 'true' | 'false';
 }
 
@@ -416,6 +575,12 @@ export interface ServerDeleteParams {
   namespace: string;
 }
 
+export interface ServerCreateByNamespaceParams {
+  description?: string;
+
+  displayName?: string;
+}
+
 export interface ServerDownloadParams {
   namespace: string;
 }
@@ -434,13 +599,17 @@ export declare namespace Servers {
     type BuildConfig as BuildConfig,
     type DeploymentTarget as DeploymentTarget,
     type ProjectConfig as ProjectConfig,
+    type ServerCreateResponse as ServerCreateResponse,
     type ServerListResponse as ServerListResponse,
     type ServerDeleteResponse as ServerDeleteResponse,
+    type ServerCreateByNamespaceResponse as ServerCreateByNamespaceResponse,
     type ServerGetResponse as ServerGetResponse,
     type ServerGetByNamespaceResponse as ServerGetByNamespaceResponse,
     type ServerListResponsesSmitheryPage as ServerListResponsesSmitheryPage,
+    type ServerCreateParams as ServerCreateParams,
     type ServerListParams as ServerListParams,
     type ServerDeleteParams as ServerDeleteParams,
+    type ServerCreateByNamespaceParams as ServerCreateByNamespaceParams,
     type ServerDownloadParams as ServerDownloadParams,
     type ServerGetParams as ServerGetParams,
   };

package/src/resources/skills/index.ts

@@ -0,0 +1,21 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Reviews,
+  type CreateReviewRequest,
+  type CreateReviewResponse,
+  type ReviewItem,
+  type ReviewsListResponse,
+  type ReviewCreateParams,
+  type ReviewListParams,
+  type ReviewDeleteParams,
+  type ReviewItemsReviewsPage,
+} from './reviews';
+export {
+  Skills,
+  type SkillListResponse,
+  type SkillGetResponse,
+  type SkillListParams,
+  type SkillGetParams,
+  type SkillListResponsesSkillsPage,
+} from './skills';