Cisco Crosswork MCP API

openapi: 3.2.0
info:
  description: Cisco Crosswork Workflow Manager (CWM) 2.1 offers RESTful APIs that enable automation engineers and developers to create, deploy, and manage workflows, adapters, jobs, resources, events, and workers within the Cisco CWM platform.
  title: Cisco Crosswork Workflow Manager MCP API
  termsOfService: www.cisco.com
  contact:
    name: API Support
    url: https://www.cisco.com/support
  version: 2.1.0
  x-provenance:
    method: harvested
    authored_by: Cisco Crosswork
    harvested_by: API Evangelist
    harvested_on: '2026-08-19'
    first_party: true
    provider_published: true
    note: 'Reconstructed verbatim from the per-operation Swagger 2.0 JSON fragments Cisco serves for the Crosswork Workflow Manager API reference at developer.cisco.com/docs/crosswork/workflow-manager/. info, basePath and securityDefinitions are Cisco''s own meta block; each path/method object is Cisco''s own spec object, unmodified except that inline schemas carrying the swagger-ui $$ref marker were hoisted back into #/definitions and replaced with a real $ref.'
servers:
- url: /crosswork/cwm/v2
tags:
- name: MCP
paths:
  /mcp:
    get:
      description: 'Handles MCP (Model Context Protocol) requests via JSON-RPC 2.0. Supports methods: initialize, tools/list, tools/call, ping, notifications/initialized, logging/setLevel'
      tags:
      - MCP
      summary: Handle Model Context Protocol requests
      responses:
        '200':
          description: JSON-RPC 2.0 Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/mcp.MCPResponse'
        '400':
          description: Parse error or invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/mcp.MCPErrorResponse'
      method: get
      path: /mcp
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/mcp.MCPRequest'
        description: JSON-RPC 2.0 Request
        required: true
      operationId: getMcp
      x-operation-id-source: derived
    post:
      description: 'Handles MCP (Model Context Protocol) requests via JSON-RPC 2.0. Supports methods: initialize, tools/list, tools/call, ping, notifications/initialized, logging/setLevel'
      tags:
      - MCP
      summary: Handle Model Context Protocol requests
      responses:
        '200':
          description: JSON-RPC 2.0 Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/mcp.MCPResponse'
        '400':
          description: Parse error or invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/mcp.MCPErrorResponse'
      method: post
      path: /mcp
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/mcp.MCPRequest'
        description: JSON-RPC 2.0 Request
        required: true
      operationId: postMcp
      x-operation-id-source: derived
components:
  schemas:
    mcp.MCPRequest:
      description: JSON-RPC 2.0 request structure for MCP
      type: object
      properties:
        id:
          description: Request identifier (string or number)
          type: string
          example: '1'
        jsonrpc:
          description: JSON-RPC version, must be "2.0"
          type: string
          example: '2.0'
        method:
          description: 'Method name to invoke: initialize, tools/list, tools/call, ping, notifications/initialized, logging/setLevel'
          type: string
          example: tools/list
        params:
          description: Optional parameters for the method
    mcp.MCPResponse:
      description: JSON-RPC 2.0 response structure for MCP
      type: object
      properties:
        error:
          $ref: '#/components/schemas/mcp.MCPError'
        id:
          description: Request identifier matching the request
          type: string
          example: '1'
        jsonrpc:
          description: JSON-RPC version, always "2.0"
          type: string
          example: '2.0'
        result:
          description: Result of the method call (present on success)
    mcp.MCPError:
      description: Error object with code and message
      type: object
      properties:
        code:
          description: 'Error code (-32700: Parse error, -32600: Invalid Request, -32601: Method not found, -32602: Invalid params, -32603: Internal error)'
          type: integer
          example: -32600
        data:
          description: Additional error data (optional)
        message:
          description: Human-readable error message
          type: string
          example: Invalid Request
    mcp.MCPErrorResponse:
      description: JSON-RPC 2.0 error response structure
      type: object
      properties:
        error:
          $ref: '#/components/schemas/mcp.MCPError'
        id:
          description: Request identifier (may be null on parse errors)
          type: string
          example: ''
        jsonrpc:
          description: JSON-RPC version, always "2.0"
          type: string
          example: '2.0'
  securitySchemes:
    Bearer:
      type: apiKey
      name: Authorization
      in: header
      description: 'JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"'
x-evidence:
- type: reference
  url: https://developer.cisco.com/docs/crosswork/workflow-manager/
- type: fragment-index
  url: https://pubhub.devnetcloud.com/media/crosswork-workflow-manager-api-document/docs/262737b2-b3c2-32cd-b07b-fdbdcd23918f/apis/
  count: 90