compose-mcp-tools.yml

# yaml-language-server: $schema=../../../capabilities/naftiko-schema.json
---
naftiko: "0.5"

info:
  label: "Compose MCP Tools"
  description: "Groups API operations into domain-aligned MCP tools — business-task-oriented tool definitions rather than 1:1 endpoint-to-tool mapping that overwhelms agent context windows."
  tags:
    - context-engineering
    - compose
    - mcp
    - tools
    - domain-driven
  created: "2026-03-19"
  modified: "2026-03-19"

capability:
  exposes:
    - type: "mcp"
      namespace: "context-engineering"
      tools:
        - name: "compose-mcp-tools"
          description: "Group enriched API operations into domain-aligned MCP tools — compose multi-operation tasks, define tool boundaries by business intent, avoid 1:1 endpoint-to-tool mapping."
          inputParameters:
            - name: spec_url
              in: body
              type: string
              description: "URL or file path to the enriched OpenAPI specification"
            - name: task_map
              in: body
              type: object
              description: "Task mapping from enrich-openapi-task-mapping capability (optional)"
            - name: domain
              in: body
              type: string
              description: "Business domain for tool grouping (e.g. 'events', 'payments', 'hr')"
          steps:
            - name: fetch-spec
              type: call
              call: "github.get-file-contents"
              with:
                owner: "{{owner}}"
                repo: "{{repo}}"
                file_path: "{{spec_url}}"

            - name: cluster-operations
              type: transform
              description: "Cluster operations by business task affinity — group CRUD operations, compose multi-step workflows, identify atomic vs composite tool boundaries."
              outputParameters:
                - name: "clusters"
                  type: "array"

            - name: define-tools
              type: transform
              description: "Define MCP tools from clusters — tool name, description, input parameters (simplified from raw API params), output schema (right-sized for agent context)."
              outputParameters:
                - name: "tools"
                  type: "array"

            - name: validate-coverage
              type: transform
              description: "Validate that all operations are covered by at least one tool and no critical paths are missing."
              outputParameters:
                - name: "tool_definitions"
                  type: "array"
                - name: "coverage_pct"
                  type: "number"
                - name: "uncovered_operations"
                  type: "array"

    - type: "http"
      path: "/compose/mcp-tools"
      method: "POST"
      description: "REST endpoint to trigger MCP tool composition"

    - type: "agent-skill"
      namespace: "context-engineering"
      skill:
        name: "compose-mcp-tools"
        description: "Group API operations into domain-aligned MCP tools"

  consumes:
    - import: "shared/consumes-github.yml"
      as: "github"