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

# List the MCP servers you can enable on your agent

> Every MCP server of every catalog you can see (your personal organization's and those of the teams you belong to), whether your personal agent enables it, and whether it can use it: the agent always uses your own connection.



## OpenAPI

````yaml api-reference/openapi.account.json GET /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:
    get:
      tags:
        - agent
      summary: List the MCP servers you can enable on your agent
      description: >-
        Every MCP server of every catalog you can see (your personal
        organization's and those of the teams you belong to), whether your
        personal agent enables it, and whether it can use it: the agent always
        uses your own connection.
      operationId: listAgentMcpServers
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentMcpServerChoices'
          description: OK
        '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
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Internal Server Error
components:
  schemas:
    AgentMcpServerChoices:
      additionalProperties: false
      properties:
        mcp_servers:
          description: By catalog, your personal organization's first, then by key.
          items:
            $ref: '#/components/schemas/AgentMcpServerChoice'
          type: array
      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
    AgentMcpServerChoice:
      additionalProperties: false
      properties:
        availability:
          description: >-
            Whether your agent can use the server: available; needs_connection,
            until you connect it as yourself (Sentry: until the organization
            installs Sentry); needs_reconnection, until you connect it again
            (your connection needs authorizing again, or its access token
            expired with nothing to renew it); org_suspended, while its
            organization is suspended; takes_secret, a local server that takes a
            secret, which an agent never enables; name_taken, enabled beside
            another server whose tools the agent would name alike, which it uses
            instead; hermes_substitution, a local server whose settings hold
            text the agent would substitute.
          enum:
            - available
            - needs_connection
            - needs_reconnection
            - org_suspended
            - takes_secret
            - name_taken
            - hermes_substitution
          type: string
        display_name:
          type: string
        enabled:
          description: Whether your agent enables the server.
          type: boolean
        id:
          format: uuid
          type: string
        key:
          type: string
        local:
          description: >-
            Whether the server runs on your agent's machine rather than at a
            URL.
          type: boolean
        org_id:
          format: uuid
          type: string
        org_name:
          type: string
        personal:
          description: Whether the server is in your personal organization's catalog.
          type: boolean
      required:
        - id
        - org_id
        - org_name
        - personal
        - key
        - display_name
        - local
        - enabled
        - availability
      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.