> ## Documentation Index > Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt > Use this file to discover all available pages before exploring further. # Update an MCP server > Replaces the server's fields. A server stays remote or local. A changed URL is probed again; a changed URL, local command or environment, or auth deletes the server's connections. Of one of Aether's own servers (source aether), only required and the headers beyond its own change; any other change is refused with mcp_server_aether_managed. A server a plugin bundles is refused with mcp_server_plugin_bundled: it changes when its plugin is updated. ## OpenAPI ````yaml api-reference/openapi.v1.json PUT /mcp-servers/{mcpServerID} openapi: 3.1.0 info: title: Aether Public API version: 0.1.0 description: >- The versioned, public Aether REST API. Authenticate with an `aether_` platform API key or a session token. servers: - url: https://api.runaether.dev/v1 security: - bearerAuth: [] paths: /mcp-servers/{mcpServerID}: put: tags: - mcp-servers summary: Update an MCP server description: >- Replaces the server's fields. A server stays remote or local. A changed URL is probed again; a changed URL, local command or environment, or auth deletes the server's connections. Of one of Aether's own servers (source aether), only required and the headers beyond its own change; any other change is refused with mcp_server_aether_managed. A server a plugin bundles is refused with mcp_server_plugin_bundled: it changes when its plugin is updated. operationId: updateMcpServer parameters: - in: path name: mcpServerID required: true schema: format: uuid type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/McpServerRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/McpServerResponse' description: OK '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Bad Request '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/OrgAuthorizationErrorResponse' description: Forbidden '404': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Not Found '409': content: application/json: schema: $ref: '#/components/schemas/McpServerErrorResponse' description: Conflict '422': content: application/json: schema: anyOf: - $ref: '#/components/schemas/ErrorResponse' - $ref: '#/components/schemas/McpServerErrorResponse' description: Unprocessable Entity '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Internal Server Error '503': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Service Unavailable components: schemas: McpServerRequest: discriminator: mapping: http: '#/components/schemas/McpHTTPServerRequest' stdio: '#/components/schemas/McpStdioServerRequest' propertyName: kind oneOf: - $ref: '#/components/schemas/McpHTTPServerRequest' - $ref: '#/components/schemas/McpStdioServerRequest' McpServerResponse: additionalProperties: false properties: mcp_server: $ref: '#/components/schemas/McpServer' required: - mcp_server type: object ErrorResponse: additionalProperties: false properties: code: type: string error: minLength: 1 type: string errors: items: $ref: '#/components/schemas/ErrorDetail' type: array required: - error type: object OrgAuthorizationErrorResponse: additionalProperties: false properties: code: enum: - org_membership_required - org_role_insufficient - org_suspended - account_deleting type: string error: minLength: 1 type: string required: - error - code type: object McpServerErrorResponse: additionalProperties: false properties: code: enum: - mcp_server_key_invalid - mcp_server_key_reserved - mcp_server_key_taken - mcp_server_key_taken_on_agent - mcp_server_display_name_invalid - mcp_server_url_invalid - mcp_server_runtime_invalid - mcp_server_package_invalid - mcp_server_version_unpinned - mcp_server_args_invalid - mcp_server_env_invalid - mcp_server_kind_change_refused - mcp_server_address_refused - mcp_server_unreachable - mcp_server_not_mcp - mcp_server_auth_unsupported - mcp_server_auth_discovery_failed - mcp_server_response_too_large - mcp_credential_policy_required - mcp_credential_policy_not_applicable - mcp_credential_policy_org_unavailable - mcp_server_api_key_not_applicable - mcp_connection_static_secret_not_accepted - mcp_connection_secret_invalid - mcp_connection_server_changed - mcp_server_aether_managed - mcp_connection_github_not_connected - mcp_connection_org_not_offered - mcp_server_headers_invalid - mcp_connection_oauth_not_accepted - mcp_oauth_not_advertised - mcp_oauth_pkce_unsupported - mcp_oauth_app_required - mcp_oauth_registration_failed - mcp_server_plugin_bundled - mcp_repo_config_invalid - mcp_oauth_app_issuer_invalid - mcp_oauth_app_invalid - mcp_oauth_app_auth_method_unsupported - mcp_server_directory_managed - mcp_server_not_from_directory - mcp_server_directory_moved - integration_not_in_directory - integration_shape_changed - mcp_server_switched_off type: string error: minLength: 1 type: string required: - error - code type: object McpHTTPServerRequest: additionalProperties: false properties: api_key: description: >- True: authenticate with an API key sent as a bearer token (auth static_secret) instead of the OAuth the server advertises; refused for a server that asks for no credential. False or omitted: the auth the probe finds. The URL is probed again when it changed or when an API-key server stops being one; a server's connections go when its URL or auth changes. type: boolean display_name: maxLength: 100 minLength: 1 type: string headers: additionalProperties: type: string description: >- Non-secret headers sent upstream on every request, as a local .mcp.json entry's headers: GitHub's X-MCP-Toolsets, for one. Never Authorization, Accept, Content-Type, Last-Event-ID or an Mcp-* header. Omitted: none. One of Aether's own servers keeps the headers Aether defines for it (X-MCP-Readonly on github_readonly). type: object key: pattern: ^[a-z][a-z0-9_-]{0,31}$ type: string kind: enum: - http type: string required: description: >- True: a task is not created until the connection its project's credential policy names can be used, and a turn that cannot reach the server fails, naming it. False, the Integrations tab's default: a task whose connection cannot be used starts without the server, and its agent is not given it. type: boolean url: maxLength: 2048 minLength: 1 pattern: ^https:// type: string required: - kind - url - key - display_name - required type: object McpStdioServerRequest: additionalProperties: false properties: args: description: Arguments after the package, at most 64 of at most 1024 bytes each. items: type: string type: array display_name: maxLength: 100 minLength: 1 type: string env: additionalProperties: $ref: '#/components/schemas/McpStdioEnvValue' description: >- Declared variables: a plain value, or a secret whose value each connection holds. Names are shell identifiers, never PATH, HOME, npm_config_cache or UV_CACHE_DIR. A changed runtime, package, version, args or env deletes the server's connections. type: object key: pattern: ^[a-z][a-z0-9_-]{0,31}$ type: string kind: enum: - stdio type: string package: description: >- The package name in the runtime's ecosystem syntax; refused with mcp_server_package_invalid otherwise. type: string required: description: >- True: a task is not created until the connection its project's credential policy names can be used, and a turn that cannot reach the server fails, naming it. False, the Integrations tab's default: a task whose connection cannot be used starts without the server, and its agent is not given it. type: boolean runtime: description: >- npx (an npm package), uvx (a PyPI package's entry point) or python (python with a PyPI package, for python -m). Anything else is refused with mcp_server_runtime_invalid. type: string version: description: >- One exact release: full semver for npx, a PEP 440 version for uvx and python. Missing, latest, a range, a wildcard or a tag is refused with mcp_server_version_unpinned. type: string required: - kind - key - display_name - required - runtime - package - args - env type: object McpServer: discriminator: mapping: http: '#/components/schemas/McpHTTPServer' stdio: '#/components/schemas/McpStdioServer' propertyName: kind oneOf: - $ref: '#/components/schemas/McpHTTPServer' - $ref: '#/components/schemas/McpStdioServer' ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object McpStdioEnvValue: discriminator: mapping: plain: '#/components/schemas/McpStdioPlainEnv' secret: '#/components/schemas/McpStdioSecretEnv' propertyName: kind oneOf: - $ref: '#/components/schemas/McpStdioPlainEnv' - $ref: '#/components/schemas/McpStdioSecretEnv' McpHTTPServer: additionalProperties: false properties: auth: enum: - none - static_secret - oauth type: string connection_kind: enum: - static_secret - oauth - github_user_credential - sentry_installation type: - string - 'null' created_at: format: date-time type: string default_credential_policy: enum: - creator - org type: - string - 'null' display_name: type: string enabled_by_default: type: boolean headers: additionalProperties: type: string type: object homepage: description: >- The integration's homepage, as Aether's integration directory names it; null unless source is directory. type: - string - 'null' id: format: uuid type: string key: type: string kind: enum: - http type: string plugin_id: format: uuid type: - string - 'null' required: type: boolean secret_names: items: type: string type: array source: enum: - manual - aether - plugin - directory type: string updated_at: format: date-time type: string url: type: string required: - kind - id - key - display_name - url - headers - auth - source - connection_kind - required - enabled_by_default - default_credential_policy - secret_names - plugin_id - homepage - created_at - updated_at type: object McpStdioServer: additionalProperties: false properties: args: items: type: string type: array auth: enum: - none - static_secret type: string connection_kind: enum: - static_secret type: - string - 'null' created_at: format: date-time type: string default_credential_policy: enum: - creator - org type: - string - 'null' display_name: type: string enabled_by_default: type: boolean env: additionalProperties: $ref: '#/components/schemas/McpStdioEnvValue' type: object id: format: uuid type: string key: type: string kind: enum: - stdio type: string package: type: string required: type: boolean runtime: enum: - npx - uvx - python type: string secret_names: items: type: string type: array source: enum: - manual type: string updated_at: format: date-time type: string version: type: string required: - kind - id - key - display_name - runtime - package - version - args - env - auth - source - connection_kind - required - enabled_by_default - default_credential_policy - secret_names - created_at - updated_at type: object McpStdioPlainEnv: additionalProperties: false properties: kind: enum: - plain type: string value: type: string required: - kind - value type: object McpStdioSecretEnv: additionalProperties: false properties: kind: enum: - secret type: string required: - kind type: object securitySchemes: bearerAuth: bearerFormat: JWT scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.