@smithery/api 0.53.0 → 0.55.0

package/src/resources/servers/releases.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../../core/resource';
 import { APIPromise } from '../../core/api-promise';
+import { PagePromise, ReleasesPage, type ReleasesPageParams } from '../../core/pagination';
 import { Stream } from '../../core/streaming';
 import { type Uploadable } from '../../core/uploads';
 import { buildHeaders } from '../../internal/headers';
@@ -9,6 +10,9 @@ import { RequestOptions } from '../../internal/request-options';
 import { multipartFormRequestOptions } from '../../internal/uploads';
 import { path } from '../../internal/utils/path';
 
+/**
+ * Browse the MCP server registry, manage server configuration, and handle deployments
+ */
 export class Releases extends APIResource {
   /**
    * List releases ordered by most recent first. Logs are omitted — fetch a specific
@@ -16,13 +20,24 @@ export class Releases extends APIResource {
    *
    * @example
    * ```ts
-   * const releases = await client.servers.releases.list(
+   * // Automatically fetches more pages as needed.
+   * for await (const releaseListResponse of client.servers.releases.list(
    *   'qualifiedName',
-   * );
+   * )) {
+   *   // ...
+   * }
    * ```
    */
-  list(qualifiedName: string, options?: RequestOptions): APIPromise<ReleaseListResponse> {
-    return this._client.get(path`/servers/${qualifiedName}/releases`, options);
+  list(
+    qualifiedName: string,
+    query: ReleaseListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ReleaseListResponsesReleasesPage, ReleaseListResponse> {
+    return this._client.getAPIList(
+      path`/servers/${qualifiedName}/releases`,
+      ReleasesPage<ReleaseListResponse>,
+      { query, ...options },
+    );
   }
 
   /**
@@ -110,6 +125,8 @@ export class Releases extends APIResource {
   }
 }
 
+export type ReleaseListResponsesReleasesPage = ReleasesPage<ReleaseListResponse>;
+
 export type DeployPayload =
   | HostedDeployPayload
   | ExternalDeployPayload
@@ -165,8 +182,6 @@ export namespace HostedDeployPayload {
 export interface ServerCard {
   serverInfo: ServerCard.ServerInfo;
 
-  authentication?: ServerCard.Authentication;
-
   eventTopics?: Array<ServerCard.EventTopic>;
 
   prompts?: Array<ServerCard.Prompt>;
@@ -205,12 +220,6 @@ export namespace ServerCard {
     }
   }
 
-  export interface Authentication {
-    required: boolean;
-
-    schemes: Array<string>;
-  }
-
   export interface EventTopic {
     name: string;
 
@@ -386,59 +395,55 @@ export namespace StdioDeployPayload {
   }
 }
 
-export type ReleaseListResponse = Array<ReleaseListResponse.ReleaseListResponseItem>;
-
-export namespace ReleaseListResponse {
-  export interface ReleaseListResponseItem {
-    id: string;
+export interface ReleaseListResponse {
+  id: string;
 
-    /**
-     * ISO 8601 timestamp of when the release was created.
-     */
-    createdAt: string;
+  /**
+   * ISO 8601 timestamp of when the release was created.
+   */
+  createdAt: string;
 
-    /**
-     * Current status: QUEUED, WORKING, SUCCESS, FAILURE, FAILURE_SCAN, AUTH_REQUIRED,
-     * CANCELLED, or INTERNAL_ERROR.
-     */
-    status: string;
+  /**
+   * Current status: QUEUED, WORKING, SUCCESS, FAILURE, FAILURE_SCAN, AUTH_REQUIRED,
+   * CANCELLED, or INTERNAL_ERROR.
+   */
+  status: string;
 
-    /**
-     * Release type: hosted_shttp (Smithery-hosted), external_shttp (external URL), or
-     * stdio (local binary).
-     */
-    type: string;
+  /**
+   * Release 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;
+  /**
+   * ISO 8601 timestamp of the last status change.
+   */
+  updatedAt: string;
 
-    /**
-     * Git branch this release was built from.
-     */
-    branch?: string | null;
+  /**
+   * Git branch this release was built from.
+   */
+  branch?: string | null;
 
-    /**
-     * Git commit SHA that triggered this release.
-     */
-    commit?: string | null;
+  /**
+   * Git commit SHA that triggered this release.
+   */
+  commit?: string | null;
 
-    /**
-     * Git commit message associated with this release.
-     */
-    commitMessage?: string | null;
+  /**
+   * Git commit message associated with this release.
+   */
+  commitMessage?: string | null;
 
-    /**
-     * The MCP endpoint URL for connecting to this server.
-     */
-    mcpUrl?: string;
+  /**
+   * The MCP endpoint URL for connecting to this server.
+   */
+  mcpUrl?: string;
 
-    /**
-     * Upstream MCP server URL. Present only for external releases.
-     */
-    upstreamUrl?: string | null;
-  }
+  /**
+   * Upstream MCP server URL. Present only for external releases.
+   */
+  upstreamUrl?: string | null;
 }
 
 export interface ReleaseDeployResponse {
@@ -569,6 +574,8 @@ export interface ReleaseResumeResponse {
  */
 export type ReleaseStreamResponse = string;
 
+export interface ReleaseListParams extends ReleasesPageParams {}
+
 export interface ReleaseDeployParams {
   /**
    * JSON-encoded release payload. See DeployPayload schema for structure.
@@ -627,6 +634,8 @@ export declare namespace Releases {
     type ReleaseGetResponse as ReleaseGetResponse,
     type ReleaseResumeResponse as ReleaseResumeResponse,
     type ReleaseStreamResponse as ReleaseStreamResponse,
+    type ReleaseListResponsesReleasesPage as ReleaseListResponsesReleasesPage,
+    type ReleaseListParams as ReleaseListParams,
     type ReleaseDeployParams as ReleaseDeployParams,
     type ReleaseGetParams as ReleaseGetParams,
     type ReleaseResumeParams as ReleaseResumeParams,

package/src/resources/servers/repo.ts

@@ -5,6 +5,9 @@ import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
+/**
+ * Browse the MCP server registry, manage server configuration, and handle deployments
+ */
 export class Repo extends APIResource {
   /**
    * Partially update the GitHub repository connection settings. Only provided fields

package/src/resources/servers/secrets.ts

@@ -5,6 +5,9 @@ import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
+/**
+ * Browse the MCP server registry, manage server configuration, and handle deployments
+ */
 export class Secrets extends APIResource {
   /**
    * List secret names. Values are not returned.

package/src/resources/servers/servers.ts

@@ -25,7 +25,9 @@ import {
   ReleaseDeployResponse,
   ReleaseGetParams,
   ReleaseGetResponse,
+  ReleaseListParams,
   ReleaseListResponse,
+  ReleaseListResponsesReleasesPage,
   ReleaseResumeParams,
   ReleaseResumeResponse,
   ReleaseStreamParams,
@@ -59,6 +61,9 @@ import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
+/**
+ * Browse the MCP server registry, manage server configuration, and handle deployments
+ */
 export class Servers extends APIResource {
   releases: ReleasesAPI.Releases = new ReleasesAPI.Releases(this._client);
   logs: LogsAPI.Logs = new LogsAPI.Logs(this._client);
@@ -502,6 +507,12 @@ export interface ServerListParams extends SmitheryPageParams {
    */
   repoOwner?: string;
 
+  /**
+   * Random seed for deterministic pagination. When provided, results use a stable
+   * sort order that is consistent across pages for the same seed value.
+   */
+  seed?: number;
+
   /**
    * Maximum number of candidate results to consider from the search index before
    * pagination.
@@ -549,6 +560,8 @@ export declare namespace Servers {
     type ReleaseGetResponse as ReleaseGetResponse,
     type ReleaseResumeResponse as ReleaseResumeResponse,
     type ReleaseStreamResponse as ReleaseStreamResponse,
+    type ReleaseListResponsesReleasesPage as ReleaseListResponsesReleasesPage,
+    type ReleaseListParams as ReleaseListParams,
     type ReleaseDeployParams as ReleaseDeployParams,
     type ReleaseGetParams as ReleaseGetParams,
     type ReleaseResumeParams as ReleaseResumeParams,

package/src/resources/skills/index.ts

@@ -27,6 +27,7 @@ export {
   type SkillCreateParams,
   type SkillListParams,
   type SkillDeleteParams,
+  type SkillDownloadParams,
   type SkillGetParams,
   type SkillSetParams,
   type SkillSyncParams,

package/src/resources/skills/reviews.ts

@@ -7,6 +7,9 @@ import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
+/**
+ * Discover and search reusable prompt-based skills for MCP servers
+ */
 export class Reviews extends APIResource {
   /**
    * Submit a review for a skill. Updates existing review if one already exists.

package/src/resources/skills/skills.ts

@@ -31,9 +31,13 @@ import {
 } from './votes';
 import { APIPromise } from '../../core/api-promise';
 import { PagePromise, SkillsPage, type SkillsPageParams } from '../../core/pagination';
+import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
+/**
+ * Discover and search reusable prompt-based skills for MCP servers
+ */
 export class Skills extends APIResource {
   votes: VotesAPI.Votes = new VotesAPI.Votes(this._client);
   reviews: ReviewsAPI.Reviews = new ReviewsAPI.Reviews(this._client);
@@ -67,6 +71,19 @@ export class Skills extends APIResource {
     return this._client.delete(path`/skills/${namespace}/${slug}`, options);
   }
 
+  /**
+   * Download a ZIP bundle containing all skill files, fetched via well-known
+   * endpoints.
+   */
+  download(slug: string, params: SkillDownloadParams, options?: RequestOptions): APIPromise<Response> {
+    const { namespace } = params;
+    return this._client.get(path`/skills/${namespace}/${slug}/download`, {
+      ...options,
+      headers: buildHeaders([{ Accept: 'application/zip' }, options?.headers]),
+      __binaryResponse: true,
+    });
+  }
+
   /**
    * Get a single skill by its namespace and slug.
    */
@@ -372,6 +389,10 @@ export interface SkillDeleteParams {
   namespace: string;
 }
 
+export interface SkillDownloadParams {
+  namespace: string;
+}
+
 export interface SkillGetParams {
   namespace: string;
 }
@@ -407,6 +428,7 @@ export declare namespace Skills {
     type SkillCreateParams as SkillCreateParams,
     type SkillListParams as SkillListParams,
     type SkillDeleteParams as SkillDeleteParams,
+    type SkillDownloadParams as SkillDownloadParams,
     type SkillGetParams as SkillGetParams,
     type SkillSetParams as SkillSetParams,
     type SkillSyncParams as SkillSyncParams,

package/src/resources/skills/votes.ts

@@ -6,6 +6,9 @@ import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
+/**
+ * Discover and search reusable prompt-based skills for MCP servers
+ */
 export class Votes extends APIResource {
   /**
    * Upvote or downvote a skill. Updates existing vote if one exists.

package/src/resources/tokens.ts

@@ -68,16 +68,10 @@ export interface Constraint {
 
 export interface CreateTokenRequest {
   /**
-   * Constraint objects to restrict the token. Cannot be combined with profileSlug.
-   * Each constraint may include a `ttl` field (max 24 hours). Default TTL is 1 hour.
-   * Maximum is 24 hours.
+   * Constraint objects to restrict the token. Each constraint may include a `ttl`
+   * field (max 24 hours). Default TTL is 1 hour. Maximum is 24 hours.
    */
   policy?: Array<Constraint>;
-
-  /**
-   * Profile slug for legacy token minting. Cannot be combined with policy.
-   */
-  profileSlug?: string;
 }
 
 export interface CreateTokenResponse {
@@ -94,16 +88,10 @@ export interface CreateTokenResponse {
 
 export interface TokenCreateParams {
   /**
-   * Constraint objects to restrict the token. Cannot be combined with profileSlug.
-   * Each constraint may include a `ttl` field (max 24 hours). Default TTL is 1 hour.
-   * Maximum is 24 hours.
+   * Constraint objects to restrict the token. Each constraint may include a `ttl`
+   * field (max 24 hours). Default TTL is 1 hour. Maximum is 24 hours.
    */
   policy?: Array<Constraint>;
-
-  /**
-   * Profile slug for legacy token minting. Cannot be combined with policy.
-   */
-  profileSlug?: string;
 }
 
 export declare namespace Tokens {

package/src/resources/uplink.ts

@@ -4,6 +4,9 @@ import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 
+/**
+ * Manage uplink tokens for connecting locally-running MCP servers to Smithery
+ */
 export class Uplink extends APIResource {
   /**
    * Create or retrieve an authtoken for uplink connections

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.53.0'; // x-release-please-version
+export const VERSION = '0.55.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.53.0";
+export declare const VERSION = "0.55.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.53.0'; // x-release-please-version
+exports.VERSION = '0.55.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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