> ## 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.

# Set the MCP servers enabled on your agent

> Replaces the whole set of MCP servers your personal agent reaches, as one batch. The agent uses your own connection to each. An agent that is starting, running, idle or waking reloads its MCP servers once it next takes commands; an agent being suspended refuses the set until it is idle; any other picks the set up the next time it starts.



## OpenAPI

````yaml api-reference/openapi.account.json PUT /agent/mcp-servers
openapi: 3.1.0
info:
  title: Aether Account & Integrations API
  version: 0.1.0
  description: >-
    Account, billing, and integration-management endpoints used by the Aether
    web app and CLI. Root-mounted; NOT part of the versioned /v1 contract.
servers:
  - url: https://api.runaether.dev
security:
  - bearerAuth: []
paths:
  /agent/mcp-servers:
    put:
      tags:
        - agent
      summary: Set the MCP servers enabled on your agent
      description: >-
        Replaces the whole set of MCP servers your personal agent reaches, as
        one batch. The agent uses your own connection to each. An agent that is
        starting, running, idle or waking reloads its MCP servers once it next
        takes commands; an agent being suspended refuses the set until it is
        idle; any other picks the set up the next time it starts.
      operationId: setAgentMcpServers
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SetAgentMcpServersRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentMcpServers'
          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/ErrorResponse'
          description: Conflict
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unprocessable Entity
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Internal Server Error
components:
  schemas:
    SetAgentMcpServersRequest:
      additionalProperties: false
      properties:
        mcp_server_ids:
          description: >-
            Every MCP server the agent reaches, by id, each once: from your
            personal org's catalog or a team's you belong to. A server not
            listed is disabled on the agent. A local server that takes a secret
            cannot be enabled.
          items:
            type: string
          maxItems: 100
          type:
            - array
            - 'null'
      required:
        - mcp_server_ids
      type: object
    AgentMcpServers:
      additionalProperties: false
      properties:
        mcp_servers:
          items:
            $ref: '#/components/schemas/AgentMcpServer'
          type:
            - array
            - 'null'
        reload_command_id:
          format: uuid
          type: string
      required:
        - mcp_servers
      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
    AgentMcpServer:
      additionalProperties: false
      properties:
        id:
          format: uuid
          type: string
        key:
          type: string
        org_id:
          format: uuid
          type: string
      required:
        - id
        - org_id
        - key
      type: object
    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
  securitySchemes:
    bearerAuth:
      bearerFormat: JWT
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.