{"openapi":"3.1.0","info":{"title":"Platphorm News 404 API","description":"API for the most epic 404 error page ever created. Part of the Platphorm News Network spanning 84+ federated sites.","version":"1.0.0","contact":{"name":"Platphorm News","url":"https://platphormnews.com","email":"api@platphormnews.com"},"license":{"name":"MIT","url":"https://opensource.org/licenses/MIT"},"x-logo":{"url":"https://404.platphormnews.com/logo.svg"}},"servers":[{"url":"https://404.platphormnews.com","description":"Production - Epic 404 Page"},{"url":"https://platphormnews.com","description":"Main Hub"},{"url":"https://mcp.platphormnews.com","description":"MCP Server Registry"}],"tags":[{"name":"Health","description":"Service health and status endpoints"},{"name":"Discovery","description":"API and content discovery endpoints"},{"name":"Network","description":"Network sites and federation endpoints"},{"name":"MCP","description":"Model Context Protocol integration"}],"paths":{"/api/health":{"get":{"tags":["Health"],"operationId":"getHealth","summary":"Health Check","description":"Returns service health status, version, and capabilities","responses":{"200":{"description":"Service is healthy","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/api/docs":{"get":{"tags":["Discovery"],"operationId":"getApiDocs","summary":"API Documentation","description":"Returns OpenAPI 3.1 specification for this service","responses":{"200":{"description":"OpenAPI specification","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/network":{"get":{"tags":["Network"],"operationId":"getNetworkSites","summary":"List Network Sites","description":"Returns all sites in the Platphorm News Network","parameters":[{"name":"vertical","in":"query","description":"Filter by vertical (analytics, tools, gaming, etc.)","schema":{"type":"string"}}],"responses":{"200":{"description":"List of network sites","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkResponse"}}}}}}},"/api/mcp":{"get":{"tags":["MCP"],"operationId":"getMcpInfo","summary":"MCP Server Info","description":"Returns MCP server capabilities and available tools","responses":{"200":{"description":"MCP server information","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpInfoResponse"}}}}}},"post":{"tags":["MCP"],"operationId":"mcpToolCall","summary":"Execute MCP Tool","description":"Execute a tool via MCP protocol","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpToolRequest"}}}},"responses":{"200":{"description":"Tool execution result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpToolResponse"}}}}}}},"/api/discovery":{"get":{"tags":["Discovery"],"operationId":"getDiscovery","summary":"Service Discovery","description":"Returns all discovery endpoints and metadata for SEO/AEO/GEO","responses":{"200":{"description":"Discovery metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DiscoveryResponse"}}}}}}}},"components":{"schemas":{"HealthResponse":{"type":"object","properties":{"status":{"type":"string","enum":["healthy","degraded","unhealthy"]},"service":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"version":{"type":"string"},"uptime":{"type":["number","string"]},"network":{"type":"object","additionalProperties":{"type":"string","format":"uri"}},"capabilities":{"type":"object","additionalProperties":{"type":"boolean"}},"stats":{"type":"object","properties":{"totalNetworkSites":{"type":"integer"},"mcpTools":{"type":"integer"},"dimensions":{"type":"string"}}}}},"NetworkResponse":{"type":"object","properties":{"network":{"type":"string"},"totalSites":{"type":"integer"},"sites":{"type":"array","items":{"$ref":"#/components/schemas/NetworkSite"}},"verticals":{"type":"object","additionalProperties":{"type":"integer"}}}},"NetworkSite":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"description":{"type":"string"},"vertical":{"type":"string"},"mcpEnabled":{"type":"boolean"},"status":{"type":"string","enum":["active","inactive","maintenance"]}}},"McpInfoResponse":{"type":"object","properties":{"protocolVersion":{"type":"string"},"serverName":{"type":"string"},"serverVersion":{"type":"string"},"capabilities":{"type":"object","properties":{"tools":{"type":"boolean"},"resources":{"type":"boolean"},"prompts":{"type":"boolean"}}},"tools":{"type":"array","items":{"$ref":"#/components/schemas/McpTool"}}}},"McpTool":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"inputSchema":{"type":"object"}}},"McpToolRequest":{"type":"object","required":["method","params"],"properties":{"jsonrpc":{"type":"string","default":"2.0"},"id":{"type":["string","integer"]},"method":{"type":"string"},"params":{"type":"object"}}},"McpToolResponse":{"type":"object","properties":{"jsonrpc":{"type":"string"},"id":{"type":["string","integer"]},"result":{"type":"object"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"DiscoveryResponse":{"type":"object","properties":{"site":{"type":"object"},"discovery":{"type":"object"},"seo":{"type":"object"},"aeo":{"type":"object"},"geo":{"type":"object"},"mcp":{"type":"object"}}}}},"externalDocs":{"description":"Platphorm News Network Documentation & Universal Schema Pack Starter Bundle","url":"https://platphormnews.com/docs","schemas":{"core":"https://404.platphormnews.com/schemas/core.schema.json","realm":"https://404.platphormnews.com/schemas/realm.schema.json","item":"https://404.platphormnews.com/schemas/item.schema.json","observability":"https://404.platphormnews.com/schemas/observability.schema.json","agent":"https://404.platphormnews.com/schemas/agent.schema.json","podcast":"https://404.platphormnews.com/schemas/podcast.schema.json","docs":"https://404.platphormnews.com/schemas/docs.schema.json","trace":"https://404.platphormnews.com/schemas/trace.schema.json","evals":"https://404.platphormnews.com/schemas/evals.schema.json"}}}