{"openapi":"3.1.0","info":{"title":"FullStack AI Hub MCP & Knowledge Engine","version":"1.3.0","description":"Authoritative production AI engineering knowledge API exposing 27 MCP tools, 9 resources, and 3 prompts. Connect via Streamable HTTP or legacy SSE transport."},"servers":[{"url":"https://fullstackaihub.com","description":"Production Instant Zero-DNS Gateway"},{"url":"https://mcp.fullstackaihub.com","description":"Production Remote MCP Subdomain"}],"paths":{"/health":{"get":{"summary":"Service Health & Status","description":"Returns server health, version, transport mode, and auth status.","responses":{"200":{"description":"Service is operational"}}}},"/gateway/routes":{"get":{"summary":"Gateway Route Catalog","description":"Lists active endpoints, personas, and registered tools.","responses":{"200":{"description":"Route catalog"}}}},"/api/consumer/incidents":{"get":{"operationId":"listIncidentFlightScenarios","summary":"List Failure-Mode Flight Simulator Scenarios","description":"List all declarative production postmortem and failure-mode flight simulator scenarios for an open-source system.","parameters":[{"name":"systemId","in":"query","schema":{"type":"string"},"description":"Optional system ID filter (e.g. inside-vllm, inside-deepseek-v3-r1)"}],"responses":{"200":{"description":"Array of verified incident flight scenarios"}}}},"/api/consumer/blog":{"get":{"operationId":"listUniversalBlogPosts","summary":"List Engineering Blog Posts & Essays","description":"Retrieve published engineering blog posts, essays, guides, and briefings with canonical URLs and tags.","parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string"}},{"name":"tag","in":"query","required":false,"schema":{"type":"string"}},{"name":"query","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":30}}],"responses":{"200":{"description":"List of published engineering blog posts"}}}},"/api/consumer/incidents/{scenarioId}":{"get":{"operationId":"getIncidentFlightScenarioById","summary":"Get Incident Flight Scenario Pack by ID","description":"Retrieve complete telemetry parameters, diagnostic CLI definitions, decision DAG, and pinned commit postmortem.","parameters":[{"name":"scenarioId","in":"path","required":true,"schema":{"type":"string"},"description":"Scenario ID (e.g. inc-vllm-prefill-starvation)"}],"responses":{"200":{"description":"Full IncidentFlightScenario pack"},"404":{"description":"Scenario not found"}}}},"/api/consumer/pathways/solve":{"post":{"operationId":"solveAdaptivePathway","summary":"Solve Adaptive Study Pathway","description":"Solve a prerequisite-safe topological study sequence with dynamic BKT retrievability decay.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["targetConceptIds"],"properties":{"targetConceptIds":{"type":"array","items":{"type":"string"},"description":"Target concept IDs or slugs"},"targetRoleId":{"type":"string"},"targetRoleTitle":{"type":"string"},"horizonDays":{"type":"integer","default":14},"dailyMinutesBudget":{"type":"integer","default":45},"bktStates":{"type":"object"}}}}}},"responses":{"200":{"description":"Generated ScheduledPath and PacingAdvice"},"400":{"description":"Invalid request or unknown target concepts"}}}},"/api/consumer/copilot/socratic-diagnose":{"post":{"operationId":"socraticDiagnoseChallenge","summary":"Generate Socratic Non-Spoiler Diagnostic Hint","description":"Generate a structured 3-part Socratic diagnostic hint (Invariant Identification, Line-Level Localization, Guided Verification Question) for a failing WASM kernel challenge.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["challengeId","failingTestOutput"],"properties":{"challengeId":{"type":"string"},"failingTestOutput":{"type":"string"},"userCodeSnippet":{"type":"string"}}}}}},"responses":{"200":{"description":"3-part Socratic non-spoiler diagnostic"},"400":{"description":"Invalid request parameters"}}}},"/mcp":{"post":{"summary":"Streamable HTTP MCP Endpoint (JSON-RPC)","description":"Primary MCP endpoint. Send JSON-RPC messages to invoke tools, read resources, or execute prompts.","security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"JSON-RPC response or SSE stream"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden by RBAC policy"},"429":{"description":"Rate limit exceeded"}}}},"/gateway":{"post":{"summary":"Zero-Trust Enterprise MCP Gateway Endpoint (JSON-RPC)","description":"Unified gateway endpoint with tool-level RBAC and cryptographic audit logging.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"JSON-RPC response"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key provided as a Bearer token in the Authorization header."}}}}