Servers

Create MCP Server

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

post/api/v1/servers

Request body

scopestring required

packageNamestring required

displayNamestring required

descriptionstring required

iconUrlstring uri

External icon URL. The server will fetch the icon from this URL and upload it to R2 storage. The response will contain the R2 URL.

detailedDescriptionstring

versionstring

authorstring

categorystring

tagsstring[]

Response

Server created successfully

Changes

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

Jan 21, 2026c98a8ef6cda71See the full diff
- ○
  added the new optional request property detailedDescription
  new-optional-request-property
Jan 21, 2026ba253fbf08a7114See the full diff
- ▲
  the response property server/version became optional for the status 201
  response-property-became-optional
- ●
  removed the optional property server/documentationUrl from the response with the 201 status
  response-optional-property-removed
- ○
  the request property version became optional
  request-property-became-optional
- ○
  the version request property default value 1.0.0 was added
  request-property-default-value-added
- ○
  added the optional property server/detailedDescription to the response with the 201 status
  response-optional-property-added
- ○
  the version response's property default value 1.0.0 was added for the status 201
  response-property-default-value-added
Jan 18, 2026b0e6563d3fce425See the full diff
- ▲
  the response property server/repository became nullable for the status 201
  response-property-became-nullable
- ▲
  the response property server/repository became optional for the status 201
  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 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 UNAUTHORIZED enum value to the code response property for the response status 401
  response-property-enum-value-added
- ○
  api operation id postApiV1Servers removed and replaced with
  api-operation-id-removed
- ○
  the request property repository became nullable
  request-property-became-nullable
- ○
  the request property repository became optional
  request-property-became-optional
- ○
  added the optional property server/developerId to the response with the 201 status
  response-optional-property-added
- ○
  added the optional property server/source to the response with the 201 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, 20264f3d96fe265617See the full diff
- ●
  removed the request property documentationUrl
  request-property-removed
- ○
  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 201 status
  response-optional-property-added
- ○
  added the optional property server/category to the response with the 201 status
  response-optional-property-added
- ○
  added the optional property server/createdAt to the response with the 201 status
  response-optional-property-added
- ○
  added the optional property server/tags to the response with the 201 status
  response-optional-property-added
Nov 10, 2025dd3fac5bdb5c736See the full diff
- ▲
  added the new required request property displayName
  new-required-request-property
- ▲
  added the new required request property packageName
  new-required-request-property
- ▲
  added the new required request property scope
  new-required-request-property
- ▲
  added the new required request property version
  new-required-request-property
- ▲
  removed the required property server/name from the response with the 201 status
  response-required-property-removed
- ▲
  removed the required property server/repository/id from the response with the 201 status
  response-required-property-removed
- ▲
  removed the required property server/versionDetail from the response with the 201 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 documentationUrl
  new-optional-request-property
- ○
  added the required property server/displayName to the response with the 201 status
  response-required-property-added
- ○
  added the required property server/packageName to the response with the 201 status
  response-required-property-added
- ○
  added the required property server/scope to the response with the 201 status
  response-required-property-added
- ○
  added the required property server/updatedAt to the response with the 201 status
  response-required-property-added
- ○
  added the required property server/version to the response with the 201 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