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

# Get a connector

> The MCP server under key in the catalog of your agent's default project's organization, or of your personal organization when you have no agent or it has no default project: whether that project enables it, and how you connect it. Refused (404 agent_connector_not_found) for a key the catalog does not hold, (409 agent_default_project_archived) when your agent's default project is archived, and (409 mcp_server_plugin_bundled) for a plugin's server whose plugin the default project does not enable.



## OpenAPI

````yaml api-reference/openapi.account.json GET /agent/connectors/{key}
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/connectors/{key}:
    get:
      tags:
        - agent
      summary: Get a connector
      description: >-
        The MCP server under key in the catalog of your agent's default
        project's organization, or of your personal organization when you have
        no agent or it has no default project: whether that project enables it,
        and how you connect it. Refused (404 agent_connector_not_found) for a
        key the catalog does not hold, (409 agent_default_project_archived) when
        your agent's default project is archived, and (409
        mcp_server_plugin_bundled) for a plugin's server whose plugin the
        default project does not enable.
      operationId: getAgentConnector
      parameters:
        - description: The server's key in its catalog.
          in: path
          name: key
          required: true
          schema:
            description: The server's key in its catalog.
            pattern: ^[a-z][a-z0-9_-]{0,31}$
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentConnector'
          description: OK
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ErrorResponse'
                  - $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
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Service Unavailable
components:
  schemas:
    AgentConnector:
      additionalProperties: false
      properties:
        connection:
          discriminator:
            mapping:
              github_user_credential: '#/components/schemas/AgentConnectorGitHubConnection'
              none: '#/components/schemas/AgentConnectorNoConnection'
              oauth: '#/components/schemas/AgentConnectorOAuthConnection'
              org: '#/components/schemas/AgentConnectorOrgConnection'
              static_secret: '#/components/schemas/AgentConnectorStaticSecretConnection'
            propertyName: kind
          oneOf:
            - $ref: '#/components/schemas/AgentConnectorOAuthConnection'
            - $ref: '#/components/schemas/AgentConnectorGitHubConnection'
            - $ref: '#/components/schemas/AgentConnectorOrgConnection'
            - $ref: '#/components/schemas/AgentConnectorStaticSecretConnection'
            - $ref: '#/components/schemas/AgentConnectorNoConnection'
        display_name:
          type: string
        key:
          type: string
        mcp_server_id:
          format: uuid
          type: string
        org_id:
          description: >-
            The organization whose catalog holds the server: your agent's
            default project's, or your personal organization when your agent has
            no default project.
          format: uuid
          type: string
        project:
          $ref: '#/components/schemas/AgentConnectorProject'
      required:
        - mcp_server_id
        - key
        - display_name
        - org_id
        - connection
      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
    AgentConnectorGitHubConnection:
      additionalProperties: false
      properties:
        connected:
          description: >-
            Your connection to the server exists and needs no reconnecting; it
            works while your GitHub connection does.
          type: boolean
        kind:
          enum:
            - github_user_credential
          type: string
        url:
          description: The server's URL, which its connection is made for.
          format: uri
          type: string
      required:
        - kind
        - url
        - connected
      type: object
    AgentConnectorNoConnection:
      additionalProperties: false
      properties:
        kind:
          enum:
            - none
          type: string
      required:
        - kind
      type: object
    AgentConnectorOAuthConnection:
      additionalProperties: false
      properties:
        connected:
          description: Your connection to the server exists and needs no reconnecting.
          type: boolean
        kind:
          enum:
            - oauth
          type: string
        url:
          description: The server's URL, which its connection is started for.
          format: uri
          type: string
      required:
        - kind
        - url
        - connected
      type: object
    AgentConnectorOrgConnection:
      additionalProperties: false
      properties:
        kind:
          enum:
            - org
          type: string
      required:
        - kind
      type: object
    AgentConnectorStaticSecretConnection:
      additionalProperties: false
      properties:
        kind:
          enum:
            - static_secret
          type: string
      required:
        - kind
      type: object
    AgentConnectorProject:
      additionalProperties: false
      properties:
        enabled:
          description: >-
            The project enables the server. The connect page enables it, with
            PUT /projects/{id}/mcp-servers/{mcpServerID}, before it connects it.
          type: boolean
        id:
          format: uuid
          type: string
      required:
        - id
        - enabled
      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.