Workato Automation Management

naftiko: "1.0.0-alpha1"

info:
  label: "Workato Automation Management"
  description: "Unified capability for integration engineers and automation teams managing Workato recipes, data tables, event streams, and AI-powered agent workflows. Combines the Developer API, Agent Studio, Event Streams, and MCP Server APIs into a single automation operations workflow."
  tags:
    - AI Agents
    - Automation
    - Integration
    - iPaaS
    - Orchestration
    - Workato
  created: "2026-05-03"
  modified: "2026-05-03"

binds:
  - namespace: env
    keys:
      WORKATO_API_TOKEN: WORKATO_API_TOKEN

capability:
  consumes:
    - import: workato-developer
      location: ./shared/developer-api.yaml
    - import: workato-agent-studio
      location: ./shared/agent-studio.yaml
    - import: workato-mcp
      location: ./shared/mcp-server.yaml
    - import: workato-events
      location: ./shared/event-streams.yaml

  exposes:
    - type: rest
      port: 8080
      namespace: workato-automation-api
      description: "Unified REST API for Workato automation management workflows."
      resources:
        - path: /v1/recipes
          name: recipes
          description: "Automation recipes"
          operations:
            - method: GET
              name: list-recipes
              description: "List automation recipes"
              call: "workato-developer.list-recipes"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: POST
              name: create-recipe
              description: "Create a new recipe"
              call: "workato-developer.create-recipe"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/recipes/{id}
          name: recipe-by-id
          description: "Single recipe management"
          operations:
            - method: GET
              name: get-recipe
              description: "Get a recipe"
              call: "workato-developer.get-recipe"
              with:
                id: "rest.id"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: DELETE
              name: delete-recipe
              description: "Delete a recipe"
              call: "workato-developer.delete-recipe"
              with:
                id: "rest.id"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/recipes/{id}/start
          name: recipe-start
          operations:
            - method: PUT
              name: start-recipe
              description: "Start a recipe"
              call: "workato-developer.start-recipe"
              with:
                id: "rest.id"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/recipes/{id}/stop
          name: recipe-stop
          operations:
            - method: PUT
              name: stop-recipe
              description: "Stop a recipe"
              call: "workato-developer.stop-recipe"
              with:
                id: "rest.id"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/data-tables
          name: data-tables
          description: "Data tables"
          operations:
            - method: GET
              name: list-data-tables
              description: "List data tables"
              call: "workato-developer.list-data-tables"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/genies
          name: genies
          description: "AI genies"
          operations:
            - method: GET
              name: list-genies
              description: "List AI genies"
              call: "workato-agent-studio.list-genies"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/skills
          name: skills
          description: "AI skills"
          operations:
            - method: GET
              name: list-skills
              description: "List AI skills"
              call: "workato-agent-studio.list-skills"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/knowledge-bases
          name: knowledge-bases
          description: "Knowledge bases"
          operations:
            - method: GET
              name: list-knowledge-bases
              description: "List knowledge bases"
              call: "workato-agent-studio.list-knowledge-bases"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/mcp-servers
          name: mcp-servers
          description: "MCP servers"
          operations:
            - method: GET
              name: list-mcp-servers
              description: "List MCP servers"
              call: "workato-mcp.list-mcp-servers"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/topics/{topic_id}/publish
          name: topic-publish
          description: "Publish events"
          operations:
            - method: POST
              name: publish-message
              description: "Publish message to topic"
              call: "workato-events.publish-message"
              with:
                topic_id: "rest.topic_id"
              outputParameters:
                - type: object
                  mapping: "$."

    - type: mcp
      port: 9080
      namespace: workato-automation-mcp
      transport: http
      description: "MCP server for AI-assisted Workato automation management, recipe operations, and agentic workflow orchestration."
      tools:
        - name: list-recipes
          description: "List Workato automation recipes with optional filtering"
          hints:
            readOnly: true
            openWorld: true
          call: "workato-developer.list-recipes"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-recipe
          description: "Get a specific Workato recipe by ID"
          hints:
            readOnly: true
          call: "workato-developer.get-recipe"
          with:
            id: "tools.id"
          outputParameters:
            - type: object
              mapping: "$."
        - name: create-recipe
          description: "Create a new Workato automation recipe"
          hints:
            readOnly: false
          call: "workato-developer.create-recipe"
          outputParameters:
            - type: object
              mapping: "$."
        - name: start-recipe
          description: "Start a Workato recipe to begin processing triggers"
          hints:
            readOnly: false
          call: "workato-developer.start-recipe"
          with:
            id: "tools.id"
          outputParameters:
            - type: object
              mapping: "$."
        - name: stop-recipe
          description: "Stop a running Workato recipe"
          hints:
            readOnly: false
          call: "workato-developer.stop-recipe"
          with:
            id: "tools.id"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-recipe-health
          description: "Get health status report for a Workato recipe"
          hints:
            readOnly: true
          call: "workato-developer.get-recipe-health"
          with:
            recipe_id: "tools.recipe_id"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-data-tables
          description: "List Workato data tables for structured data storage"
          hints:
            readOnly: true
          call: "workato-developer.list-data-tables"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-genies
          description: "List Workato AI genies for agentic automation"
          hints:
            readOnly: true
          call: "workato-agent-studio.list-genies"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-genie
          description: "Get a specific Workato AI genie by ID"
          hints:
            readOnly: true
          call: "workato-agent-studio.get-genie"
          with:
            id: "tools.id"
          outputParameters:
            - type: object
              mapping: "$."
        - name: create-genie
          description: "Create a new Workato AI genie"
          hints:
            readOnly: false
          call: "workato-agent-studio.create-genie"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-skills
          description: "List AI skills available for Workato genies"
          hints:
            readOnly: true
          call: "workato-agent-studio.list-skills"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-knowledge-bases
          description: "List Workato knowledge bases for AI-powered lookups"
          hints:
            readOnly: true
          call: "workato-agent-studio.list-knowledge-bases"
          outputParameters:
            - type: object
              mapping: "$."
        - name: create-knowledge-base
          description: "Create a new Workato knowledge base"
          hints:
            readOnly: false
          call: "workato-agent-studio.create-knowledge-base"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-mcp-servers
          description: "List Workato MCP servers exposing API tools for AI agents"
          hints:
            readOnly: true
          call: "workato-mcp.list-mcp-servers"
          outputParameters:
            - type: object
              mapping: "$."
        - name: create-mcp-server
          description: "Create a new Workato MCP server for exposing API tools"
          hints:
            readOnly: false
          call: "workato-mcp.create-mcp-server"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-server-tools
          description: "List tools configured on a Workato MCP server"
          hints:
            readOnly: true
          call: "workato-mcp.list-server-tools"
          with:
            mcp_server_handle: "tools.handle"
          outputParameters:
            - type: object
              mapping: "$."
        - name: publish-event
          description: "Publish a message to a Workato event stream topic"
          hints:
            readOnly: false
          call: "workato-events.publish-message"
          with:
            topic_id: "tools.topic_id"
          outputParameters:
            - type: object
              mapping: "$."
        - name: consume-events
          description: "Consume messages from a Workato event stream topic"
          hints:
            readOnly: true
            openWorld: true
          call: "workato-events.consume-messages"
          with:
            topic_id: "tools.topic_id"
          outputParameters:
            - type: object
              mapping: "$."