Servers

Update MCP Server

Update an existing MCP server. If a new iconUrl is provided, the server will fetch the icon from the external URL, upload it to R2 storage, and delete the old icon. The response will contain the new R2 URL.

put/api/v1/servers/{id}

Path parameters

idstring required

The unique identifier

Example:12345

Request body

displayNamestring

descriptionstring

iconUrlstring uri

External icon URL. If provided, the server will fetch the icon from this URL, upload it to R2 storage, and delete the old icon. The response will contain the new R2 URL.

detailedDescriptionstring

versionstring

authorstring

categorystring

tagsstring[]

Response

Server updated successfully

Changes

Changed in 5 of the 11 revisions of this API.91024

Jan 21, 2026ba253fbf08a7123See the full diff
- ▲
  the response property server/version became optional for the status 200
  response-property-became-optional
- ●
  removed the request property documentationUrl
  request-property-removed
- ●
  removed the optional property server/documentationUrl from the response with the 200 status
  response-optional-property-removed
- ○
  added the new optional request property detailedDescription
  new-optional-request-property
- ○
  added the optional property server/detailedDescription to the response with the 200 status
  response-optional-property-added
- ○
  the version response's property default value 1.0.0 was added for the status 200
  response-property-default-value-added
Jan 18, 20268179b9ac16602See the full diff
- ●
  removed the request property packageName
  request-property-removed
- ●
  removed the request property scope
  request-property-removed
Jan 18, 2026b0e6563d3fce535See the full diff
- ▲
  the response property server/repository became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property server/repository became optional for the status 200
  response-property-became-optional
- ▲
  the code response property const value INTERNAL_SERVER_ERROR was removed for the status 500
  response-property-const-removed
- ▲
  the code response property const value NOT_FOUND was removed for the status 404
  response-property-const-removed
- ▲
  the code response property const value UNAUTHORIZED was removed for the status 401
  response-property-const-removed
- ●
  added the new INTERNAL_SERVER_ERROR enum value to the code response property for the response status 500
  response-property-enum-value-added
- ●
  added the new NOT_FOUND enum value to the code response property for the response status 404
  response-property-enum-value-added
- ●
  added the new UNAUTHORIZED enum value to the code response property for the response status 401
  response-property-enum-value-added
- ○
  api operation id putApiV1ServersById removed and replaced with
  api-operation-id-removed
- ○
  the request property repository became nullable
  request-property-became-nullable
- ○
  added the non-success response with the status 403
  response-non-success-status-added
- ○
  added the optional property server/developerId to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property server/source to the response with the 200 status
  response-optional-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jan 17, 20264f3d96fe26567See the full diff
- ○
  added the new optional request property author
  new-optional-request-property
- ○
  added the new optional request property category
  new-optional-request-property
- ○
  added the new optional request property tags
  new-optional-request-property
- ○
  added the optional property server/author to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property server/category to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property server/createdAt to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property server/tags to the response with the 200 status
  response-optional-property-added
Nov 10, 2025dd3fac5bdb5c339See the full diff
- ▲
  removed the required property server/name from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property server/repository/id from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property server/versionDetail from the response with the 200 status
  response-required-property-removed
- ●
  removed the request property name
  request-property-removed
- ●
  removed the request property repository/id
  request-property-removed
- ●
  removed the request property versionDetail
  request-property-removed
- ○
  added the new optional request property displayName
  new-optional-request-property
- ○
  added the new optional request property packageName
  new-optional-request-property
- ○
  added the new optional request property scope
  new-optional-request-property
- ○
  added the new optional request property version
  new-optional-request-property
- ○
  added the required property server/displayName to the response with the 200 status
  response-required-property-added
- ○
  added the required property server/packageName to the response with the 200 status
  response-required-property-added
- ○
  added the required property server/scope to the response with the 200 status
  response-required-property-added
- ○
  added the required property server/updatedAt to the response with the 200 status
  response-required-property-added
- ○
  added the required property server/version to the response with the 200 status
  response-required-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history