mcp-registry-spec-sdk

• Server schema version updated: SDK now uses server.json schema version 2025-12-11
• getServerByName() deprecated: The getServerByName() method is now deprecated and will emit a console warning. Users should migrate to explicit version methods (getServerVersion(), listServerVersions())
• Transport types updated: New transport schemas (StdioTransport, StreamableHttpTransport, SseTransport) have been added and TransportSchema is now a discriminated union

• API version support: Client now supports both /v0/ (development) and /v0.1/ (stable) API versions. Constructor accepts optional apiVersion parameter ('v0' | 'v0.1'), defaults to 'v0'
• New server version methods:
  • getServerVersion(serverName, version) - Get a specific version
  • listServerVersions(serverName) - List all available versions
  • getServerByName() now calls /versions/latest endpoint internally
• Package schema enhancements: The version field in PackageSchema is now optional (aligns with official registry)
• New transport types:
  • StdioTransportSchema - Standard IO transport (type: 'stdio')
  • StreamableHttpTransportSchema - HTTP transport with streaming support
  • SseTransportSchema - Server-Sent Events transport
• URL template variables: Remote transport now supports optional variables property for URL templating with {curly_braces} syntax
• Icon schema: New IconSchema for server icons with src (required), mimeType, sizes, and theme (all optional)
• Additional schemas from official registry:
  • ResponseMetaSchema - API response metadata (status, publishedAt, updatedAt, isLatest)
  • ServerMetaSchema - Server metadata in list responses
  • ServerJSONSchema - Alias for ServerDetail (input format)
  • ServerListResponseSchema - List operations response
  • VersionBodySchema - Version endpoint responses
  • SignatureTokenExchangeInputSchema - DNS/HTTP signature exchange
  • OIDCTokenExchangeInputBodySchema - Google OIDC (admin-only)
  • GitHubTokenExchangeInputBodySchema - GitHub auth
  • GitHubOIDCTokenExchangeInputBodySchema - GitHub OIDC auth
  • MetadataSchema - Pagination metadata
• New admin endpoint: PUT /servers/{serverName}/versions/{version} for updating server versions

Migrate from getServerByName():

Create val
// Old (deprecated - emits warning)
const server = await client.server.getServerByName("my-server");

// New - use explicit version
const latest = await client.server.getServerVersion("my-server", "latest");
const specific = await client.server.getServerVersion("my-server", "1.0.0");

Use stable v0.1 API in production:

Create val
// Default (v0 - development)
const clientDev = new MCPRegistryClient();

// Production (v0.1 - stable)
const clientProd = new MCPRegistryClient("https://registry.modelcontextprotocol.io", "v0.1");

Update server.json $schema:

{
  "$schema": "https://raw.githubusercontent.com/modelcontextprotocol/registry/main/docs/reference/server-json/server.schema.json"
}

• All endpoint URLs now use URL encoding for server names and versions (encodeURIComponent())
• All namespace classes (Auth, Server, Publish, Admin, Health, Ping) respect the configured API version
• TypeScript types are derived from Zod schemas for runtime validation
• Backward compatibility maintained where practical

• Added tests for server listing functionality
• Updated RegistryExtensionsSchema and RemoteSchema to make some fields optional
• Updated package version to 0.2.0s
• ServerResponse and ServerResponseSchema are now properly typed.

• Added re-exports for every schema constant in index.ts, so consumers can import schemas statically from the root entry.
• Rebuilt the package; the generated d.ts now includes these named schema exports and the build completed at version 0.1.2.