Workato MCP Servers API

openapi: 3.1.0
info:
  title: Workato Agent Studio Data Tables MCP Servers API
  description: The Workato Agent Studio API provides programmatic access to manage AI agents (genies), skills, and knowledge bases within the Workato Agentic Automation platform. Use this API to create and configure AI agents, assign skills and knowledge bases, and control agent lifecycle. Rate limits are 1,000 requests per minute for list/get operations and 60 requests per minute for all other operations.
  version: '1.0'
  contact:
    name: Workato Support
    url: https://support.workato.com/
  termsOfService: https://www.workato.com/legal
servers:
- url: https://www.workato.com
  description: US Production
- url: https://app.eu.workato.com
  description: EU Production
- url: https://app.jp.workato.com
  description: JP Production
- url: https://app.sg.workato.com
  description: SG Production
- url: https://app.au.workato.com
  description: AU Production
security:
- bearerAuth: []
tags:
- name: MCP Servers
  description: MCP servers expose Workato API endpoints as tools accessible to AI agents via the Model Context Protocol.
paths:
  /api/mcp/mcp_servers:
    get:
      operationId: listMcpServers
      summary: Workato List MCP Servers
      description: Returns a paginated list of MCP servers in the workspace, with optional filtering by project, folder, authentication method, and other criteria.
      tags:
      - MCP Servers
      parameters:
      - $ref: '#/components/parameters/ProjectId'
      - $ref: '#/components/parameters/FolderId'
      - name: authentication_method
        in: query
        description: Filter by authentication method.
        schema:
          type: string
      - name: search
        in: query
        description: Search term to filter servers by name.
        schema:
          type: string
      - name: vua_required
        in: query
        description: Filter by whether virtual user account is required.
        schema:
          type: boolean
      - $ref: '#/components/parameters/Page'
      - $ref: '#/components/parameters/PerPage'
      responses:
        '200':
          description: A list of MCP servers.
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/McpServer'
                  next_page:
                    type: boolean
                    description: Whether there are more pages available.
        '401':
          $ref: '#/components/responses/Unauthorized'
    post:
      operationId: createMcpServer
      summary: Workato Create an MCP Server
      description: Creates a new MCP server in the workspace. The server will generate a unique authenticated URL that AI agents can use to discover and invoke tools.
      tags:
      - MCP Servers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/McpServerInput'
      responses:
        '200':
          description: The created MCP server.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/McpServer'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /api/mcp/mcp_servers/{handle}:
    get:
      operationId: getMcpServer
      summary: Workato Get an MCP Server
      description: Returns the details of a specific MCP server by its handle.
      tags:
      - MCP Servers
      parameters:
      - $ref: '#/components/parameters/McpServerHandle'
      responses:
        '200':
          description: The MCP server details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/McpServer'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
    put:
      operationId: updateMcpServer
      summary: Workato Update an MCP Server
      description: Updates the configuration of an existing MCP server.
      tags:
      - MCP Servers
      parameters:
      - $ref: '#/components/parameters/McpServerHandle'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/McpServerInput'
      responses:
        '200':
          description: The updated MCP server.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/McpServer'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
    delete:
      operationId: deleteMcpServer
      summary: Workato Delete an MCP Server
      description: Permanently deletes an MCP server from the workspace.
      tags:
      - MCP Servers
      parameters:
      - $ref: '#/components/parameters/McpServerHandle'
      responses:
        '200':
          description: Deletion confirmation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
  /api/mcp/mcp_servers/{handle}/token_renew:
    post:
      operationId: renewMcpServerToken
      summary: Workato Renew MCP Server Token
      description: Generates a new authentication token for an MCP server. The previous token is invalidated immediately.
      tags:
      - MCP Servers
      parameters:
      - $ref: '#/components/parameters/McpServerHandle'
      responses:
        '200':
          description: The new authentication token.
          content:
            application/json:
              schema:
                type: object
                properties:
                  token:
                    type: string
                    description: The new authentication token for the MCP server.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
  /api/mcp/mcp_servers/{handle}/assign_tools:
    post:
      operationId: assignToolsToMcpServer
      summary: Workato Assign Tools to an MCP Server
      description: Assigns one or more tools to an MCP server. Tools are API endpoints from connected recipe collections that AI agents can invoke.
      tags:
      - MCP Servers
      parameters:
      - $ref: '#/components/parameters/McpServerHandle'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - tools
              properties:
                tools:
                  type: array
                  items:
                    type: object
                    required:
                    - trigger_application
                    - id
                    properties:
                      trigger_application:
                        type: string
                        description: The application or collection that owns the tool.
                      id:
                        type: string
                        description: Unique identifier of the tool within its application.
      responses:
        '200':
          description: The updated tools list.
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/Tool'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
  /api/mcp/mcp_servers/{handle}/update_folder:
    put:
      operationId: moveMcpServerToFolder
      summary: Workato Move MCP Server to Folder
      description: Moves an MCP server to a different folder in the workspace.
      tags:
      - MCP Servers
      parameters:
      - $ref: '#/components/parameters/McpServerHandle'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - folder_id
              properties:
                folder_id:
                  type: integer
                  description: ID of the destination folder.
      responses:
        '200':
          description: The updated MCP server.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/McpServer'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  parameters:
    McpServerHandle:
      name: handle
      in: path
      required: true
      description: Unique handle (slug) of the MCP server.
      schema:
        type: string
    Page:
      name: page
      in: query
      description: Page number for pagination (1-based).
      schema:
        type: integer
        minimum: 1
        default: 1
    PerPage:
      name: per_page
      in: query
      description: Number of results per page.
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 100
    FolderId:
      name: folder_id
      in: query
      description: Filter results by folder ID.
      schema:
        type: integer
    ProjectId:
      name: project_id
      in: query
      description: Filter results by project ID.
      schema:
        type: integer
  schemas:
    SuccessResponse:
      type: object
      description: Standard success response.
      properties:
        success:
          type: boolean
          description: Whether the operation was successful.
          example: true
    McpServerInput:
      type: object
      description: Input schema for creating or updating an MCP server.
      required:
      - name
      - folder_id
      properties:
        name:
          type: string
          description: Display name for the MCP server.
        folder_id:
          type: integer
          description: ID of the folder to place the MCP server in.
        authentication_method:
          type: string
          description: Authentication method to use for the MCP server.
    Tool:
      type: object
      description: An API endpoint or action exposed through an MCP server as a callable tool.
      properties:
        id:
          type: string
          description: Unique identifier of the tool within its application.
        name:
          type: string
          description: Display name of the tool.
        description:
          type: string
          description: Description of what the tool does and when AI agents should use it.
        trigger_application:
          type: string
          description: The application or API collection that owns this tool.
    ErrorResponse:
      type: object
      description: Standard error response.
      properties:
        message:
          type: string
          description: Human-readable error message.
        code:
          type: string
          description: Machine-readable error code.
    McpServer:
      type: object
      description: An MCP server that exposes Workato API endpoints as tools for AI agents.
      properties:
        handle:
          type: string
          description: Unique slug identifier of the MCP server.
        name:
          type: string
          description: Display name of the MCP server.
        folder_id:
          type: integer
          description: ID of the folder containing this MCP server.
        mcp_url:
          type: string
          format: uri
          description: The authenticated MCP URL that AI agents connect to.
        authentication_method:
          type: string
          description: Authentication method used by this MCP server.
        created_at:
          type: string
          format: date-time
          description: Timestamp when the MCP server was created.
        updated_at:
          type: string
          format: date-time
          description: Timestamp when the MCP server was last updated.
  responses:
    NotFound:
      description: The requested resource was not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: Authentication token is missing or invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    BadRequest:
      description: The request body is invalid or missing required fields.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'API client token obtained from the Workato platform. Include as Authorization: Bearer {token}.'
externalDocs:
  description: Workato Agent Studio API Documentation
  url: https://docs.workato.com/workato-api/agent-studio.html