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

# Add

> Manage your remote MCP connections, which all your Itoflow chats share. Send the latest connection version. If a connect response is lost, check status before retrying.

Operation ID: remoteMcp_add.



## OpenAPI

````yaml /openapi/itoflow-public.openapi.json post /integrations/remote-mcp/add
openapi: 3.1.0
info:
  description: >-
    All Itoflow APIs are experimental and may change without notice. Read-only
    operations marked interactive can be tried from the documentation; the
    others are reference-only.
  title: Itoflow Developer API
  version: 1.0.0
servers:
  - description: Itoflow API
    url: https://api.itoflow.ai
security: []
tags:
  - name: Account
  - name: Billing
  - name: Brokers
  - name: Chat
  - name: Connected MCP servers
  - name: GitHub
  - name: Market data
  - name: Monitors
  - name: Notifications
  - name: Portfolios
  - name: Risk runs
  - name: Sharing and data
  - name: Strategies
paths:
  /integrations/remote-mcp/add:
    post:
      tags:
        - Connected MCP servers
      summary: Add an owned remote MCP connection without connecting to it.
      description: >-
        Manage your remote MCP connections, which all your Itoflow chats share.
        Send the latest connection version. If a connect response is lost, check
        status before retrying.


        Operation ID: remoteMcp_add.
      operationId: remoteMcp_add
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Gateway_RemoteMcp_addRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  connection:
                    $ref: '#/components/schemas/Gateway_RemoteMcpConnection'
                required:
                  - connection
                type: object
          description: Success
          headers:
            Cache-Control:
              schema:
                enum:
                  - no-store
                type: string
        '400':
          $ref: '#/components/responses/Gateway_RemoteMcpError'
        '401':
          $ref: '#/components/responses/Gateway_RemoteMcpError'
        '403':
          $ref: '#/components/responses/Gateway_RemoteMcpError'
        '404':
          $ref: '#/components/responses/Gateway_RemoteMcpError'
        '409':
          $ref: '#/components/responses/Gateway_RemoteMcpError'
        '429':
          $ref: '#/components/responses/Gateway_RemoteMcpError'
        '502':
          $ref: '#/components/responses/Gateway_RemoteMcpError'
        '503':
          $ref: '#/components/responses/Gateway_RemoteMcpError'
      security:
        - bearerAuth: []
components:
  schemas:
    Gateway_RemoteMcp_addRequest:
      additionalProperties: false
      properties:
        bearerToken:
          description: >-
            Raw provider token, without the Bearer prefix. Omit to reuse a saved
            token. Treat it as a secret: do not paste it into chat, print it or
            commit it.
          maxLength: 8192
          minLength: 1
          pattern: ^[\x21-\x7e\x80-\xff]+$
          type: string
        endpoint:
          description: >-
            Public HTTPS Streamable HTTP endpoint. Private, local and stdio
            servers are unsupported.
          maxLength: 2048
          minLength: 1
          type: string
        name:
          description: Display name shared across the owner’s Itoflow chats.
          maxLength: 80
          minLength: 1
          type: string
      required:
        - endpoint
      type: object
    Gateway_RemoteMcpConnection:
      additionalProperties: false
      properties:
        auth:
          enum:
            - none
            - bearer
            - oauth
            - unknown
          type: string
        authStatus:
          enum:
            - disconnected
            - authorizing
            - connected
            - reauthorization_required
          type: string
        endpoint:
          maxLength: 2048
          type: string
        errorCode:
          anyOf:
            - enum:
                - invalid_url
                - destination_blocked
                - discovery_failed
                - unsupported_protocol
                - setup_needed
                - authorization_canceled
                - reauthorization_required
                - insufficient_scope
                - connection_unavailable
                - connection_changed
                - tool_changed
                - feature_disabled
                - rate_limited
                - limit_exceeded
                - outcome_unknown
                - cleanup_pending
                - unauthorized
                - not_found
                - invalid_request
              type: string
            - type: 'null'
        id:
          description: Connection ID returned by add or list.
          format: uuid
          pattern: >-
            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
          type: string
        name:
          description: Display name shared across the owner’s Itoflow chats.
          maxLength: 80
          minLength: 1
          type: string
        readiness:
          enum:
            - unchecked
            - checking
            - ready
            - unavailable
            - setup_needed
          type: string
        toolCount:
          maximum: 9007199254740991
          minimum: 0
          type: integer
        updatedAt:
          type: string
        version:
          description: Latest connection version; refresh after connection_changed.
          exclusiveMinimum: 0
          maximum: 9007199254740991
          type: integer
      required:
        - id
        - name
        - endpoint
        - version
        - auth
        - authStatus
        - readiness
        - errorCode
        - toolCount
        - updatedAt
      type: object
    Gateway_RemoteMcpFailure:
      additionalProperties: false
      properties:
        error:
          additionalProperties: false
          properties:
            code:
              enum:
                - invalid_url
                - destination_blocked
                - discovery_failed
                - unsupported_protocol
                - setup_needed
                - authorization_canceled
                - reauthorization_required
                - insufficient_scope
                - connection_unavailable
                - connection_changed
                - tool_changed
                - feature_disabled
                - rate_limited
                - limit_exceeded
                - outcome_unknown
                - cleanup_pending
                - unauthorized
                - not_found
                - invalid_request
              type: string
            expectedVersion:
              exclusiveMinimum: 0
              maximum: 9007199254740991
              type: integer
            message:
              type: string
          required:
            - code
            - message
          type: object
      required:
        - error
      type: object
  responses:
    Gateway_RemoteMcpError:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Gateway_RemoteMcpFailure'
      description: Request rejected. Refresh the connection on connection_changed.
      headers:
        Cache-Control:
          schema:
            enum:
              - no-store
            type: string
  securitySchemes:
    bearerAuth:
      bearerFormat: JWT
      description: Itoflow access token issued for the Itoflow API.
      scheme: bearer
      type: http

````

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