SMsmithery-ai
servers

Publish a server

Changed on

Submit a release via multipart form. Supports hosted (JS module upload), external (URL), and stdio (MCPB bundle) release types.

put/servers/{qualifiedName}/releases

Request

  • Base URL
    https://api.smithery.ai
  • Auth
    HTTP bearer

Path parameters

qualifiedNamestring required

The server's qualified name (e.g. 'namespace/server' or 'namespace' for namespace-only servers). Use %2F to encode the slash.

Request body multipart/form-data

payloadstring required

JSON-encoded release payload. See DeployPayload schema for structure.

modulestring binary

JavaScript module file (for hosted releases)

sourcemapstring binary

Source map file (for hosted releases)

bundlestring binary

MCPB bundle file (for stdio releases)

Response

Release accepted

deploymentIdstring uuid required

Unique identifier for this release.

statusstring required

Initial status. Will be WORKING while the release is in progress.

mcpUrlstring uri required

The MCP endpoint URL for connecting to this server once published.

warningsstring[]

Non-fatal warnings encountered during submission.

Example response

{
  "deploymentId": "123e4567-e89b-12d3-a456-426614174000",
  "status": "WORKING",
  "mcpUrl": "https://slug.run.tools"
}

Changes