> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tai42.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Add or replace MCP config entries and hot-reload



## OpenAPI

````yaml /openapi.json post /api/mcp-config/entries
openapi: 3.1.0
info:
  description: The operator HTTP surface served under /api/*.
  title: tai42-skeleton API
  version: 14.0.2
servers: []
security: []
paths:
  /api/mcp-config/entries:
    post:
      tags:
        - manifest
      summary: Add or replace MCP config entries and hot-reload
      operationId: post_api_mcp_config_entries
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/McpEntriesAdd'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    $ref: '#/components/schemas/ApplyResponse'
                required:
                  - data
                type: object
          description: Success.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Malformed request.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Missing or invalid api key.
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReloadingError'
          description: The server is applying a config reload; retry shortly.
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
      security:
        - ApiKeyAuth: []
components:
  schemas:
    McpEntriesAdd:
      description: >-
        MCP entries to append to the manifest's ``mcp`` section. ``replace``

        lets an entry whose title already exists swap in at its current
        position;

        without it a title collision is refused.
      properties:
        entries:
          items:
            $ref: '#/components/schemas/TaiMCPConfig'
          title: Entries
          type: array
        replace:
          default: false
          title: Replace
          type: boolean
      required:
        - entries
      title: McpEntriesAdd
      type: object
    ApplyResponse:
      description: >-
        The standard mutation-op response: this worker's local reload result
        merged

        with the fleet fan-out summary. ``env_keys`` is the count of env keys
        the

        reload loaded.
      properties:
        env_keys:
          title: Env Keys
          type: integer
        fanout:
          $ref: '#/components/schemas/FanoutSummary'
        status:
          title: Status
          type: string
      required:
        - status
        - env_keys
        - fanout
      title: ApplyResponse
      type: object
    Error:
      properties:
        code:
          description: >-
            Stable machine-readable reason a client keys a dedicated error state
            on, present on refusals that opt in (e.g. a 501 not-configured
            refusal). Optional: absent when the error carries only a
            human-readable message.
          type: string
        error:
          type: string
      required:
        - error
      type: object
    ReloadingError:
      properties:
        error:
          const: reloading — the server is applying a config reload; retry shortly
          type: string
        reloading:
          const: true
          type: boolean
      required:
        - error
        - reloading
      type: object
    TaiMCPConfig:
      properties:
        config:
          $ref: '#/components/schemas/MCPConfig'
        exclude:
          items:
            type: string
          title: Exclude
          type: array
        extensions:
          additionalProperties:
            items:
              items:
                anyOf:
                  - type: string
                  - additionalProperties: true
                    type: object
              type: array
            type: array
          title: Extensions
          type: object
        include:
          items:
            type: string
          title: Include
          type: array
        managed:
          anyOf:
            - $ref: '#/components/schemas/ConnectorRef'
            - type: 'null'
          default: null
        title:
          title: Title
          type: string
      required:
        - title
        - config
      title: TaiMCPConfig
      type: object
    FanoutSummary:
      description: >-
        The mode-tagged fan-out summary embedded under a mutation response's

        ``fanout`` field.


        ``mode`` selects the shape: ``local-only`` carries only ``note`` (a lone

        worker reached no sibling); ``fleet`` and ``unreachable`` carry the
        per-worker

        broadcast report
        (``op``/``reachable``/``local_only``/``results``/``error``),

        the ``unreachable`` variant having no worker list, only ``error``. The

        mode-variant fields are optional so one model describes every mode
        without

        reshaping any wire payload.
      properties:
        error:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Error
        local_only:
          anyOf:
            - type: boolean
            - type: 'null'
          default: null
          title: Local Only
        mode:
          title: Mode
          type: string
        note:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Note
        op:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Op
        reachable:
          anyOf:
            - type: boolean
            - type: 'null'
          default: null
          title: Reachable
        results:
          anyOf:
            - items:
                $ref: '#/components/schemas/FanoutWorkerResult'
              type: array
            - type: 'null'
          default: null
          title: Results
      required:
        - mode
      title: FanoutSummary
      type: object
    MCPConfig:
      properties:
        args:
          items:
            type: string
          title: Args
          type: array
        command:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Command
        env:
          additionalProperties:
            type: string
          title: Env
          type: object
        headers:
          additionalProperties:
            type: string
          title: Headers
          type: object
        type:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Type
        uds:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Uds
        url:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Url
      title: MCPConfig
      type: object
    ConnectorRef:
      description: |-
        Marker on a manifest entry pointing back at a Connection. Hand-authored
        entries leave ``managed`` as ``None`` and are unaffected.
      properties:
        connection_id:
          title: Connection Id
          type: string
        provider_id:
          maxLength: 64
          minLength: 1
          title: Provider Id
          type: string
        sub_service:
          maxLength: 64
          minLength: 1
          title: Sub Service
          type: string
      required:
        - connection_id
        - provider_id
        - sub_service
      title: ConnectorRef
      type: object
    FanoutWorkerResult:
      description: >-
        One worker's verdict within a multi-worker fan-out report.


        ``payload`` carries a query op's per-worker data; ``error`` a failed
        apply's

        message; ``detail`` the publisher's note for a computed
        missing/departed/

        timed-out verdict. ``outcome`` is the worker's terminal outcome as its
        wire

        string.
      properties:
        detail:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Detail
        error:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Error
        name:
          title: Name
          type: string
        outcome:
          title: Outcome
          type: string
        payload:
          anyOf:
            - $ref: '#/components/schemas/JsonValue'
            - type: 'null'
          default: null
      required:
        - name
        - outcome
      title: FanoutWorkerResult
      type: object
    JsonValue: {}
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: x-api-key
      type: apiKey

````