Bonus: Example Swagger/OpenAPI v3.0 for MCP Server

Bonus: Example Swagger/OpenAPI v3.0 for MCP Server

openapi: 3.0.3 info: title: SOCRadar MCP Server API description: API for triggering prompt-based tasks via the MCP Server. version: 1.0.0 paths: /mcp/execute: post: summary: Execute a prompt-based task description: Triggers an MCP Server workflow with specified model and context. operationId: executeTask requestBody: required: true content: application/json: schema: $ref: ‘#/components/schemas/ExecuteRequest’ responses: ‘200’: description: Successful task execution content: application/json: schema: $ref: ‘#/components/schemas/ExecuteResponse’ ‘400’: description: Invalid input ‘401’: description: Unauthorized ‘500’: description: Server error components: schemas: ExecuteRequest: type: object required: – task – input properties: task: type: string example: threat_summary description: The name of the MCP task or flow to run input: type: string example: CVE-2025-20345 description: Raw input prompt or data model: type: string example: claude-3-sonnet description: Optional model override context_file: type: string example: indicators.json description: Optional context file to preload dry_run: type: boolean example: false description: If true, validates the flow without executing ExecuteResponse: type: object properties: job_id: type: string example: job_abc123xyz status: type: string example: queued output: type: string example: “The CVE is associated with ransomware activity in Europe…”