Bonus: Example Swagger/OpenAPI v3.0 for MCP Server
Published on
• Updated on
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..."