{
  "openapi": "3.1.0",
  "info": {
    "title": "PlatPhorm News API",
    "version": "0.3.0",
    "description": "Public Hacker News reading APIs and the News API MCP discovery server."
  },
  "servers": [
    {
      "url": "https://newsapi.platphormnews.com"
    }
  ],
  "paths": {
    "/api/health": {
      "get": {
        "summary": "Read live service and Hacker News upstream health",
        "responses": {
          "200": {
            "description": "Health payload"
          }
        }
      }
    },
    "/api/v1/health": {
      "get": {
        "summary": "Read versioned service health",
        "responses": {
          "200": {
            "description": "Health payload"
          }
        }
      }
    },
    "/api/mcp": {
      "get": {
        "summary": "Read MCP server metadata",
        "responses": {
          "200": {
            "description": "MCP metadata"
          }
        }
      },
      "post": {
        "summary": "Call the public read-only JSON-RPC MCP server",
        "responses": {
          "200": {
            "description": "JSON-RPC response"
          }
        }
      }
    },
    "/api/v1/mcp": {
      "get": {
        "summary": "Read versioned MCP server metadata",
        "responses": {
          "200": {
            "description": "MCP metadata"
          }
        }
      },
      "post": {
        "summary": "Call the versioned JSON-RPC MCP server",
        "responses": {
          "200": {
            "description": "JSON-RPC response"
          }
        }
      }
    },
    "/api/hackernews/getTopStories": {
      "get": {
        "summary": "Read current Hacker News top stories",
        "responses": {
          "200": {
            "description": "Story list"
          }
        }
      }
    },
    "/api/hackernews/getBestStories": {
      "get": {
        "summary": "Read current Hacker News best stories",
        "responses": {
          "200": {
            "description": "Story list"
          }
        }
      }
    },
    "/api/hackernews/getAskStories": {
      "get": {
        "summary": "Read current Ask HN stories",
        "responses": {
          "200": {
            "description": "Story list"
          }
        }
      }
    },
    "/api/hackernews/getShowStories": {
      "get": {
        "summary": "Read current Show HN stories",
        "responses": {
          "200": {
            "description": "Story list"
          }
        }
      }
    },
    "/api/hackernews/getJobStories": {
      "get": {
        "summary": "Read current Hacker News jobs",
        "responses": {
          "200": {
            "description": "Story list"
          }
        }
      }
    }
  }
}